Nous sommes heureux d’annoncer la sortie de GroupDocs.Conversion for Python v26.9, disponible depuis septembre 2026. Cette version met à jour le moteur sous‑jacent GroupDocs.Conversion de la version 26.3 à 26.8, introduit l’API ConversionEvents pour le suivi en temps réel des conversions, ajoute la prise en charge des archives XAR, des diagrammes draw.io et Mermaid, et comprend plusieurs nouvelles options de chargement et de conversion. Elle résout également des problèmes de compatibilité critiques sur Python 3.5–3.10 et corrige des défauts anciens affectant les propriétés de type délégué et les arguments d’énumération.

Nouveautés de cette version

  • [Feature] Ajout de la prise en charge de ConversionEvents pour observer le démarrage, la progression, la fin par page et par document, les échecs et le remplacement de polices (CONVERSIONPYTHON-93)
  • [Feature] Ajout de la prise en charge de nouveaux formats — archives XAR, diagrammes draw.io et diagrammes Mermaid (.mmd) (CONVERSIONPYTHON-94)
  • [Feature] Ajout de CadLoadOptions.layout_scope pour restreindre la conversion CAD à l’espace modèle, aux mises en page papier ou aux deux (CONVERSIONPYTHON-95)
  • [Feature] Ajout de MarkdownOptions.image_saving_callback pour contrôler l’endroit où les images extraites vers Markdown sont enregistrées (CONVERSIONPYTHON-96)
  • [Feature] Ajout de EmailLoadOptions.page_layout_options et WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
  • [Feature] Ajout de ImageConvertOptions.min_resolution et cap_resolution_to_page_content (CONVERSIONPYTHON-98)
  • [Feature] Ajout de WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
  • [Feature] Ajout de MissingDependencyException pour un échec plus clair lorsqu’une dépendance optionnelle du moteur est absente (CONVERSIONPYTHON-100)
  • [Enhancement] Mise à jour du moteur GroupDocs.Conversion de la version 26.3 à 26.8 (CONVERSIONPYTHON-101)
  • [Enhancement] Suppression du module dupliqué groupdocs.conversion.file_types — utilisez groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
  • [Enhancement] Renommage de PdfOptions.remove_pdf_acompliance en remove_pdf_a_compliance (CONVERSIONPYTHON-103)
  • [Enhancement] Ajout d’une section Guide du développeur et des pages groupdocs.conversion.integration.* à la référence API (CONVERSIONPYTHON-104)
  • [Fix] Impossible d’importer le module avec Python 3.5 – 3.7 (CONVERSIONPYTHON-91)
  • [Fix] Erreur d’exécution lors du passage d’un argument Enum dans les versions Python 3.8 – 3.10 (CONVERSIONPYTHON-92)
  • [Fix] L’indexeur item sur *DocumentInfo et PossibleConversions est une propriété et ne peut pas être appelé (CONVERSIONPYTHON-105)
  • [Fix] Les propriétés de type délégué ne peuvent pas être assignées depuis Python (Object must implement IConvertible) (CONVERSIONPYTHON-106)
  • [Fix] Les propriétés de type délégué sont annotées avec le mauvais type dans les stubs et les docstrings (CONVERSIONPYTHON-107)

Modifications de l’API publique

Nouvelles classes

Classe Module
ConversionEvents groupdocs.conversion
FontSubstitutionContext groupdocs.conversion.contracts
XarDocumentInfo groupdocs.conversion.contracts
MissingDependencyException groupdocs.conversion.exceptions
CadLayoutScope groupdocs.conversion.options.load
IPageLayoutOptions groupdocs.conversion.options.load
MarkdownImageSavingArgs, IMarkdownImageSavingCallback groupdocs.conversion.options.convert
IConversionHandlersStage, IConversionByPageHandlersStage groupdocs.conversion.fluent

Nouveaux membres des classes existantes

  • FluentConverter.with_events(...), ainsi que les mêmes sur IConversionFrom et IConversionSettings
  • Converter(...) — quatre nouvelles surcharges de constructeur acceptant 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

Supprimé — groupdocs.conversion.file_types

Le module groupdocs.conversion.file_types et ses 23 classes ont disparu. Les classes elles‑mêmes ne le sont pas — chacune d’elles existe toujours, inchangée, dans groupdocs.conversion.filetypes.

Si vous l’importiez, modifiez simplement l’importation — rien d’autre :

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

Renommé — PdfOptions.remove_pdf_acompliance

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

Nouvelles fonctionnalités

Événements de conversion

ConversionEvents vous permet d’observer une conversion pendant son exécution — progression, fin par page et par document, échecs et substitution de polices. Attachez des fonctions Python ordinaires :

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

Notez que le constructeur prend (path, settings, events) — il n’existe pas de surcharge (path, events), donc passez un ConverterSettings() même si vous n’avez rien à configurer.

Les hooks disponibles sont on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed et on_font_substituted.

Nouveaux formats

Format Constante de type de fichier Remarques
archive XAR CompressionFileType.XAR Aussi XarDocumentInfo pour l’inspection
diagramme draw.io DiagramFileType.DRAWIO
diagramme Mermaid DiagramFileType.MMD

Portée de mise en page CAD

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

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

BOTH est la valeur par défaut et ne restreint pas la conversion.

Exemple de code

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

Comment obtenir la mise à jour

PyPI

pip install groupdocs-conversion-net==26.9.0

Téléchargement direct

Téléchargez depuis la page GroupDocs.Conversion for Python via .NET 26.9 .

Ressources