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
ConversionEventspour 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_scopepour restreindre la conversion CAD à l’espace modèle, aux mises en page papier ou aux deux (CONVERSIONPYTHON-95) - [Feature] Ajout de
MarkdownOptions.image_saving_callbackpour contrôler l’endroit où les images extraites vers Markdown sont enregistrées (CONVERSIONPYTHON-96) - [Feature] Ajout de
EmailLoadOptions.page_layout_optionsetWebLoadOptions.margin_settings/orientation_settings/size_settings(CONVERSIONPYTHON-97) - [Feature] Ajout de
ImageConvertOptions.min_resolutionetcap_resolution_to_page_content(CONVERSIONPYTHON-98) - [Feature] Ajout de
WordProcessingLoadOptions.auto_detect_rtl_direction(CONVERSIONPYTHON-99) - [Feature] Ajout de
MissingDependencyExceptionpour 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— utilisezgroupdocs.conversion.filetypes(CONVERSIONPYTHON-102) - [Enhancement] Renommage de
PdfOptions.remove_pdf_acomplianceenremove_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
itemsur*DocumentInfoetPossibleConversionsest 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 surIConversionFrometIConversionSettingsConverter(...)— quatre nouvelles surcharges de constructeur acceptant unConversionEventsCadLoadOptions.layout_scopeEmailLoadOptions.page_layout_optionsWebLoadOptions.margin_settings,.orientation_settings,.size_settingsMarkdownOptions.image_saving_callbackImageConvertOptions.min_resolution,.cap_resolution_to_page_contentWordProcessingLoadOptions.auto_detect_rtl_directionCompressionFileType.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 .