GroupDocs.Conversion for Python 26.9 – Sorotan Rilis September 2026

Kami dengan senang hati mengumumkan rilis GroupDocs.Conversion for Python v26.9, tersedia sejak September 2026. Rilis ini meningkatkan mesin GroupDocs.Conversion yang mendasarinya dari 26.3 ke 26.8, memperkenalkan API ConversionEvents untuk pemantauan konversi secara real‑time, menambahkan dukungan untuk arsip XAR, diagram draw.io, dan diagram Mermaid, serta menyertakan beberapa opsi muat dan konversi baru. Rilis ini juga menyelesaikan masalah kompatibilitas kritis pada Python 3.5–3.10 dan memperbaiki cacat lama yang memengaruhi properti bertipe delegate dan argumen enum.

Apa yang baru di rilis ini

• [Feature] Menambahkan dukungan untuk ConversionEvents guna mengamati mulai, kemajuan, penyelesaian per‑halaman dan per‑dokumen, kegagalan, serta substitusi font (CONVERSIONPYTHON-93)
• [Feature] Menambahkan dukungan untuk format baru — arsip XAR, diagram draw.io, dan diagram Mermaid (.mmd) (CONVERSIONPYTHON-94)
• [Feature] Menambahkan CadLoadOptions.layout_scope untuk membatasi konversi CAD ke ruang model, tata letak paper‑space, atau keduanya (CONVERSIONPYTHON-95)
• [Feature] Menambahkan MarkdownOptions.image_saving_callback untuk mengontrol tempat gambar yang diekstrak ke Markdown disimpan (CONVERSIONPYTHON-96)
• [Feature] Menambahkan EmailLoadOptions.page_layout_options dan WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
• [Feature] Menambahkan ImageConvertOptions.min_resolution dan cap_resolution_to_page_content (CONVERSIONPYTHON-98)
• [Feature] Menambahkan WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
• [Feature] Menambahkan MissingDependencyException untuk kegagalan yang lebih jelas ketika dependensi mesin opsional tidak ada (CONVERSIONPYTHON-100)
• [Enhancement] Memperbarui mesin GroupDocs.Conversion dari 26.3 ke 26.8 (CONVERSIONPYTHON-101)
• [Enhancement] Menghapus modul duplikat groupdocs.conversion.file_types — gunakan groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
• [Enhancement] Mengubah nama PdfOptions.remove_pdf_acompliance menjadi remove_pdf_a_compliance (CONVERSIONPYTHON-103)
• [Enhancement] Menambahkan bagian Panduan Pengembang dan halaman groupdocs.conversion.integration.* ke referensi API (CONVERSIONPYTHON-104)
• [Fix] Tidak dapat mengimpor modul saat menggunakan Python 3.5 – 3.7 (CONVERSIONPYTHON-91)
• [Fix] Kesalahan runtime ketika mengirim argumen Enum pada Python 3.8 – 3.10 (CONVERSIONPYTHON-92)
• [Fix] Indexer item pada *DocumentInfo dan PossibleConversions adalah properti dan tidak dapat dipanggil (CONVERSIONPYTHON-105)
• [Fix] Properti bertipe delegate tidak dapat ditetapkan dari Python (Object must implement IConvertible) (CONVERSIONPYTHON-106)
• [Fix] Properti bertipe delegate dianotasi dengan tipe yang salah pada stub dan docstring (CONVERSIONPYTHON-107)

Perubahan API Publik

Kelas baru

Anggota baru pada kelas yang ada

• FluentConverter.with_events(...), dan yang sama pada IConversionFrom serta IConversionSettings
• Converter(...) — empat overload konstruktor baru yang menerima sebuah ConversionEvents
• CadLoadOptions.layout_scope
• EmailLoadOptions.page_layout_options
• WebLoadOptions.margin_settings, .orientation_settings, .size_settings
• MarkdownOptions.image_saving_callback
• ImageConvertOptions.min_resolution, .cap_resolution_to_page_content
• WordProcessingLoadOptions.auto_detect_rtl_direction
• CompressionFileType.XAR, DiagramFileType.DRAWIO, DiagramFileType.MMD

Dihapus — groupdocs.conversion.file_types

Modul groupdocs.conversion.file_types dan 23 kelasnya telah dihapus. Kelas‑kelas tersebut tidak dihapus — masing‑masing masih ada, tidak berubah, di groupdocs.conversion.filetypes.

Jika Anda mengimpor dari modul tersebut, ubah pernyataan impor — tidak ada yang lain:

# sebelum
from groupdocs.conversion.file_types import WordProcessingFileType
# sesudah
from groupdocs.conversion.filetypes import WordProcessingFileType

Diubah nama — PdfOptions.remove_pdf_acompliance

# sebelum
options.remove_pdf_acompliance = True
# sesudah
options.remove_pdf_a_compliance = True

Fitur baru

Peristiwa konversi

ConversionEvents memungkinkan Anda mengamati proses konversi saat berjalan — kemajuan, penyelesaian per‑halaman dan per‑dokumen, kegagalan, serta substitusi font. Lampirkan fungsi Python biasa:

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

Catatan: konstruktor menerima (path, settings, events) — tidak ada overload (path, events), jadi berikan ConverterSettings() meskipun Anda tidak perlu mengonfigurasi apa‑apa.

Hook yang tersedia meliputi on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed, dan on_font_substituted.

Format baru

Lingkup tata letak CAD

from groupdocs.conversion.options.load import CadLayoutScope, CadLoadOptions

load_options = CadLoadOptions()
load_options.layout_scope = CadLayoutScope.MODEL     # MODEL | LAYOUTS | BOTH

BOTH adalah nilai default dan tidak membatasi konversi.

Contoh kode

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

Cara mendapatkan pembaruan

PyPI

pip install groupdocs-conversion-net==26.9.0

Unduhan langsung

Unduh dari halaman GroupDocs.Conversion for Python via .NET 26.9 .

Sumber daya

• Catatan Rilis Lengkap
• Halaman Produk
• Dokumentasi
• Referensi API
• Contoh Kode
• Free Support Forum