GroupDocs.Conversion pour Python v26.3 est maintenant disponible. Cette version ajoute la conversion page par page, la sortie en flux mémoire, la prise en charge de Python 3.14, les fichiers d’intégration d’agent IA, des métadonnées de format améliorées et plusieurs raffinements.

Nouveautés de cette version

Clé Catégorie Résumé
CONVERSIONPYTHON-65 Fonctionnalité Conversion page par page via convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Fonctionnalité Conversion en mémoire via convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Fonctionnalité Prise en charge de Python 3.14
CONVERSIONPYTHON-64 Fonctionnalité Livraison du fichier AGENTS.md dans le package pour l’intégration d’Agent IA
CONVERSIONPYTHON-67 Amélioration Les objets de format exposent les propriétés .extension, .file_format, .description
CONVERSIONPYTHON-68 Amélioration Classificateur macOS explicite dans les métadonnées PyPI

Modifications de l’API publique

Nouvelles méthodes fonctionnelles – ces méthodes étaient déclarées dans la version 25.12 mais levaient NotImplementedError. Elles sont maintenant opérationnelles :

Méthode Retour Description
Converter.convert_by_page(output_dir, convert_options) None Divise un document en un fichier par page dans le répertoire indiqué
Converter.convert_to_stream(convert_options) bytes Convertit le document et renvoie le résultat sous forme de bytes en mémoire

Méthodes pas encore disponibles – les méthodes suivantes existent en tant que proxys d’attributs sur la classe Converter mais ne sont pas encore fonctionnelles dans le binding Python. Les appeler lèvera une exception :

Méthode Statut Solution de contournement
convert_by_page(file_path, page_number, convert_options) TypeError — surcharge à 3 arguments non exposée Utilisez convert_options.page_number + convert_options.pages_count = 1 avec convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — surcharge à 3 arguments non exposée Convertissez en fichier, puis lisez-le dans io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Utilisez convert(file_path, options) pour une sortie consolidée en un seul fichier à partir d’archives

Nouvelles fonctionnalités

Conversion page par page – convert_by_page
La méthode Converter.convert_by_page(output_dir, convert_options) est désormais entièrement fonctionnelle. Elle divise un document multi‑pages en fichiers de sortie individuels — un par page — enregistrés dans le répertoire spécifié. Les fichiers de pages sont nommés page_1.ext, page_2.ext, etc. Cette méthode fonctionne pour toutes les classes ConvertOptions qui prennent en charge la sortie basée sur les pages, telles que ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions, et d’autres.

Conversion en mémoire – convert_to_stream
La méthode Converter.convert_to_stream(convert_options) renvoie maintenant le document converti sous forme d’objet Python bytes, permettant des pipelines de conversion en mémoire sans écriture sur disque. Cela est utile pour les fonctions cloud, les applications web et les architectures de streaming où l’accès au système de fichiers est limité ou indésirable.

Prise en charge de Python 3.14
La plage de versions Python prises en charge passe de 3.5–3.13 (25.12) à 3.5–3.14. Les métadonnées Requires-Python affichent désormais >=3.5,<3.15, et la page PyPI indique explicitement les classificateurs pour Python 3.8 à 3.14.

AGENTS.md – Intégration d’Agent IA et LLM
Le paquet pip groupdocs-conversion inclut désormais un fichier AGENTS.md situé à groupdocs/conversion/AGENTS.md à l’intérieur de la roue. Les assistants de codage IA qui analysent les paquets installés — tels que Claude Code, Cursor et GitHub Copilot — peuvent automatiquement découvrir la surface d’API, les modèles d’utilisation, les chemins d’importation et les conseils de dépannage sans intervention manuelle.

Propriétés des objets de format
Les objets de format renvoyés par get_possible_conversions() et get_all_possible_conversions() exposent maintenant des propriétés lisibles :

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

Auparavant ces objets s’affichaient sous forme d’<NetObject handle=NNN> opaque ; ils apparaissent désormais comme <NetObject pdf> dans repr() et offrent des valeurs de chaîne propres via les propriétés ci‑dessus.

Exemple de code

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

Comment obtenir la mise à jour

PyPI

pip install --upgrade groupdocs-conversion

Ressources