GroupDocs.Conversion for 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.

What’s new in this release

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

Public API changes

New Functional Methods – 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 file per halaman di direktori yang diberikan
Converter.convert_to_stream(convert_options) bytes Mengonversi dokumen dan mengembalikan hasil sebagai byte dalam memori

Methods Not Yet Available – metode‑metode berikut ada sebagai proxy 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 file, lalu baca ke dalam io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Gunakan convert(file_path, options) untuk output tunggal terintegrasi dari arsip

New features

Per‑Page Conversion – convert_by_page
Metode Converter.convert_by_page(output_dir, convert_options) kini berfungsi penuh. Ia membagi dokumen multi‑halaman menjadi file output terpisah — satu per halaman — yang disimpan ke direktori yang ditentukan. File 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.

In‑Memory Conversion – 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.

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

AGENTS.md – AI Agent and LLM Integration
Paket pip groupdocs-conversion kini menyertakan file 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 tips pemecahan masalah tanpa panduan manual.

Format Object Properties
Objek format yang dikembalikan oleh get_possible_conversions() dan get_all_possible_conversions() kini mengekspos properti yang mudah dibaca:

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

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

Code example

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)
    # produces: page_1.png, page_2.png, ...

How to get the update

PyPI

pip install --upgrade groupdocs-conversion

Resources