GroupDocs.Conversion for Python 26.9 – Evidenze del rilascio di settembre 2026

Siamo felici di annunciare il rilascio di GroupDocs.Conversion for Python v26.9, disponibile a partire da Settembre 2026. Questa versione aggiorna il motore sottostante GroupDocs.Conversion da 26.3 a 26.8, introduce l’API ConversionEvents per il monitoraggio in tempo reale della conversione, aggiunge il supporto per archivi XAR, diagrammi draw.io e Mermaid, e include diverse nuove opzioni di caricamento e conversione. Risolve inoltre problemi critici di compatibilità su Python 3.5–3.10 e corregge difetti di lunga data che interessavano le proprietà di tipo delegate e gli argomenti enum.

Novità di questa versione

• [Feature] Aggiungere il supporto per ConversionEvents per osservare l’avvio, l’avanzamento, il completamento per pagina e per documento, i fallimenti e la sostituzione dei font (CONVERSIONPYTHON-93)
• [Feature] Aggiungere il supporto per nuovi formati — archivi XAR, diagrammi draw.io e diagrammi Mermaid (.mmd) (CONVERSIONPYTHON-94)
• [Feature] Aggiungere CadLoadOptions.layout_scope per limitare la conversione CAD allo spazio modello, ai layout paper-space o a entrambi (CONVERSIONPYTHON-95)
• [Feature] Aggiungere MarkdownOptions.image_saving_callback per controllare dove vengono salvate le immagini estratte in Markdown (CONVERSIONPYTHON-96)
• [Feature] Aggiungere EmailLoadOptions.page_layout_options e WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
• [Feature] Aggiungere ImageConvertOptions.min_resolution e cap_resolution_to_page_content (CONVERSIONPYTHON-98)
• [Feature] Aggiungere WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
• [Feature] Aggiungere MissingDependencyException per un errore più chiaro quando una dipendenza opzionale del motore è assente (CONVERSIONPYTHON-100)
• [Enhancement] Aggiornare il motore GroupDocs.Conversion da 26.3 a 26.8 (CONVERSIONPYTHON-101)
• [Enhancement] Rimuovere il modulo duplicato groupdocs.conversion.file_types — utilizzare groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
• [Enhancement] Rinominare PdfOptions.remove_pdf_acompliance in remove_pdf_a_compliance (CONVERSIONPYTHON-103)
• [Enhancement] Aggiungere una sezione Guida per sviluppatori e le pagine groupdocs.conversion.integration.* al riferimento API (CONVERSIONPYTHON-104)
• [Fix] Impossibile importare il modulo quando si utilizza Python 3.5 – 3.7 (CONVERSIONPYTHON-91)
• [Fix] Errore di runtime quando si passa un argomento Enum nelle versioni Python 3.8 – 3.10 (CONVERSIONPYTHON-92)
• [Fix] L’indicizzatore item su *DocumentInfo e PossibleConversions è una proprietà e non può essere chiamato (CONVERSIONPYTHON-105)
• [Fix] Le proprietà di tipo delegate non possono essere assegnate da Python (Object must implement IConvertible) (CONVERSIONPYTHON-106)
• [Fix] Le proprietà di tipo delegate sono annotate con il tipo errato negli stub e nelle docstring (CONVERSIONPYTHON-107)

Modifiche all’API pubblica

Nuove classi

Nuovi membri nelle classi esistenti

• FluentConverter.with_events(...), e lo stesso su IConversionFrom e IConversionSettings
• Converter(...) — quattro nuovi overload del costruttore che accettano un 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

Rimosso — groupdocs.conversion.file_types

Il modulo groupdocs.conversion.file_types e le sue 23 classi sono stati rimossi. Le classi stesse non lo sono — ognuna di esse esiste ancora, invariata, in groupdocs.conversion.filetypes.

Se l’hai importato, modifica l’import — nient’altro:

# before
from groupdocs.conversion.file_types import WordProcessingFileType
# after
from groupdocs.conversion.filetypes import WordProcessingFileType

Rinominato — PdfOptions.remove_pdf_acompliance

# before
options.remove_pdf_acompliance = True
# after
options.remove_pdf_a_compliance = True

Nuove funzionalità

Eventi di conversione

ConversionEvents ti consente di osservare una conversione mentre è in esecuzione — avanzamento, completamento per pagina e per documento, errori e sostituzione dei font. Collega funzioni Python ordinarie:

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())

Nota che il costruttore accetta (path, settings, events) — non esiste un overload (path, events), quindi passa un ConverterSettings() anche quando non è necessario configurare nulla.

Gli hook disponibili sono on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed e on_font_substituted.

Nuovi formati

Ambito layout CAD

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

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

BOTH è il valore predefinito e non limita la conversione.

Esempio di codice

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())

Come ottenere l’aggiornamento

PyPI

pip install groupdocs-conversion-net==26.9.0

Download diretto

Scarica dalla pagina GroupDocs.Conversion for Python via .NET 26.9 .

Risorse

• Full Release Notes
• Product Page
• Documentation
• API Reference
• Code Examples
• Free Support Forum