GroupDocs.Conversion untuk Python v26.3 kini tersedia. Rilis ini menambahkan konversi per‑halaman, output aliran memori, dukungan Python 3.14, file integrasi AI‑agent, metadata format yang ditingkatkan, dan beberapa penyempurnaan.

Yang Baru dalam Rilis Ini

Kunci Kategori Ringkasan
CONVERSIONPYTHON-65 Fitur Konversi per‑halaman melalui convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Fitur Konversi dalam memori melalui convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Fitur Dukungan Python 3.14
CONVERSIONPYTHON-64 Fitur Menyertakan AGENTS.md dalam paket untuk integrasi AI Agent
CONVERSIONPYTHON-67 Peningkatan Objek format mengekspos properti .extension, .file_format, .description
CONVERSIONPYTHON-68 Peningkatan Klasifier macOS eksplisit dalam metadata PyPI

Perubahan API Publik

Metode Fungsional Baru – metode‑metode ini dideklarasikan pada 25.12 tetapi menghasilkan NotImplementedError. Sekarang sudah berfungsi:

Metode Mengembalikan Deskripsi
Converter.convert_by_page(output_dir, convert_options) None Membagi dokumen menjadi satu berkas per halaman di direktori yang diberikan
Converter.convert_to_stream(convert_options) bytes Mengonversi dokumen dan mengembalikan hasilnya sebagai byte‑array dalam memori

Metode yang Belum Tersedia – metode‑metode berikut ada sebagai proksi atribut pada kelas Converter tetapi belum berfungsi dalam binding Python. Memanggilnya akan menghasilkan pengecualian:

Metode Status Solusi Sementara
convert_by_page(file_path, page_number, convert_options) TypeError — overload 3‑argumen tidak diekspos Gunakan convert_options.page_number + convert_options.pages_count = 1 dengan convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — overload 3‑argumen tidak diekspos Konversi ke berkas, lalu baca ke dalam io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Gunakan convert(file_path, options) untuk menghasilkan satu berkas gabungan dari arsip

Fitur Baru

Konversi Per‑Halaman – convert_by_page
Metode Converter.convert_by_page(output_dir, convert_options) kini berfungsi penuh. Ia membagi dokumen multi‑halaman menjadi berkas output terpisah — satu per halaman — yang disimpan ke direktori yang ditentukan. Berkas halaman dinamai page_1.ext, page_2.ext, dan seterusnya. Metode ini bekerja untuk semua kelas ConvertOptions yang mendukung output berbasis halaman, seperti ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions, dan lainnya.

Konversi Dalam Memori – convert_to_stream
Metode Converter.convert_to_stream(convert_options) kini mengembalikan dokumen yang telah dikonversi sebagai objek bytes Python, memungkinkan alur kerja konversi dalam memori tanpa menulis ke disk. Ini berguna untuk fungsi cloud, aplikasi web, dan arsitektur streaming di mana akses sistem berkas terbatas atau tidak diinginkan.

Dukungan Python 3.14
Rentang versi Python yang didukung diperluas dari 3.5–3.13 (25.12) menjadi 3.5–3.14. Metadata Requires-Python kini berisi >=3.5,<3.15, dan halaman PyPI secara eksplisit mencantumkan classifier untuk Python 3.8 hingga 3.14.

AGENTS.md – Integrasi AI Agent dan LLM
Paket pip groupdocs-conversion kini menyertakan berkas AGENTS.md di groupdocs/conversion/AGENTS.md di dalam wheel. Asisten kode AI yang memindai paket terpasang — seperti Claude Code, Cursor, dan GitHub Copilot — dapat secara otomatis menemukan permukaan API, pola penggunaan, jalur impor, dan tip pemecahan masalah tanpa panduan manual.

Properti Objek Format
Objek format yang dikembalikan oleh get_possible_conversions() dan get_all_possible_conversions() kini mengekspos properti yang dapat dibaca manusia:

  • .extension – misalnya 'pdf'
  • .file_format – misalnya 'Portable Document Format'
  • .description – misalnya 'Portable Document Format File (pdf)'

Sebelumnya objek‑objek ini ditampilkan sebagai <NetObject handle=NNN> yang tidak jelas; kini mereka muncul sebagai <NetObject pdf> dalam repr() dan menyediakan nilai string bersih melalui properti di atas.

Contoh Kode

import os
from groupdocs.conversion import Converter
from groupdocs.conversion.filetypes import ImageFileType
from groupdocs.conversion.options.convert import ImageConvertOptions

output_dir = "./converted-pages"
os.makedirs(output_dir, exist_ok=True)

with Converter("./presentation.pptx") as converter:
    options = ImageConvertOptions()
    options.format = ImageFileType.PNG
    converter.convert_by_page(output_dir, options)
    # menghasilkan: page_1.png, page_2.png, ...

Cara Mendapatkan Pembaruan

PyPI

pip install --upgrade groupdocs-conversion

Sumber Daya