GroupDocs.Conversion voor Python v26.3 is nu beschikbaar. Deze release voegt per‑pagina conversie toe, uitvoer naar een in‑memory stream, ondersteuning voor Python 3.14, AI‑agent integratiebestanden, verbeterde formaat‑metadata en diverse verfijningen.
What’s new in this release
| Sleutel | Categorie | Samenvatting |
|---|---|---|
| CONVERSIONPYTHON-65 | Functie | Per-pagina conversie via convert_by_page(output_dir, convert_options) |
| CONVERSIONPYTHON-66 | Functie | Conversie in geheugen via convert_to_stream(convert_options) |
| CONVERSIONPYTHON-62 | Functie | Ondersteuning voor Python 3.14 |
| CONVERSIONPYTHON-64 | Functie | Levert AGENTS.md mee in het pakket voor AI‑Agent integratie |
| CONVERSIONPYTHON-67 | Verbetering | Formaatobjecten bieden de eigenschappen .extension, .file_format, .description |
| CONVERSIONPYTHON-68 | Verbetering | Expliciete macOS‑classifier in PyPI‑metadata |
Public API changes
Nieuwe functionele methoden – deze methoden werden gedeclareerd in 25.12 maar gooiden NotImplementedError. Ze zijn nu operationeel:
| Methode | Retourneert | Beschrijving |
|---|---|---|
Converter.convert_by_page(output_dir, convert_options) |
None |
Splitst een document in één bestand per pagina in de opgegeven map |
Converter.convert_to_stream(convert_options) |
bytes |
Converteert het document en retourneert het resultaat als in‑memory bytes |
Methoden nog niet beschikbaar – de volgende methoden bestaan als attribuut‑proxy’s op de Converter‑klasse maar zijn nog niet functioneel in de Python‑binding. Het aanroepen ervan zal een uitzondering veroorzaken:
| Methode | Status | Omweg |
|---|---|---|
convert_by_page(file_path, page_number, convert_options) |
TypeError — 3‑argument overload niet beschikbaar |
Gebruik convert_options.page_number + convert_options.pages_count = 1 met convert(file_path, options) |
convert_by_page(stream, page_number, convert_options) |
TypeError — 3‑argument overload niet beschikbaar |
Converteer naar bestand, lees vervolgens in io.BytesIO |
convert_multiple(folder_path, convert_options) |
MissingMethodException |
Gebruik convert(file_path, options) voor een geconsolideerde enkel‑bestand uitvoer uit archieven |
Nieuwe functies
Per‑pagina conversie – convert_by_page
De Converter.convert_by_page(output_dir, convert_options)‑methode is nu volledig functioneel. Ze splitst een document met meerdere pagina’s in afzonderlijke uitvoerbestanden — één per pagina — die worden opgeslagen in de opgegeven map. Pagina‑bestanden krijgen de namen page_1.ext, page_2.ext, enzovoort. Deze methode werkt voor alle ConvertOptions‑klassen die paginagebaseerde uitvoer ondersteunen, zoals ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions en andere.
Conversie in geheugen – convert_to_stream
De Converter.convert_to_stream(convert_options)‑methode retourneert nu het geconverteerde document als een Python bytes‑object, waardoor conversiepijplijnen in geheugen mogelijk zijn zonder naar schijf te schrijven. Dit is nuttig voor cloud‑functies, webapplicaties en streaming‑architecturen waar bestandsysteemtoegang beperkt of ongewenst is.
Ondersteuning voor Python 3.14
Het ondersteunde Python‑versiebereik is uitgebreid van 3.5–3.13 (25.12) naar 3.5–3.14. De Requires-Python‑metadata leest nu >=3.5,<3.15, en de PyPI‑pagina vermeldt expliciet classifiers voor Python 3.8 tot en met 3.14.
AGENTS.md – AI‑Agent en LLM‑integratie
Het groupdocs-conversion‑pip‑pakket levert nu een AGENTS.md‑bestand bij groupdocs/conversion/AGENTS.md binnen het wheel. AI‑code‑assistenten die geïnstalleerde pakketten scannen — zoals Claude Code, Cursor en GitHub Copilot — kunnen automatisch de API‑structuur, gebruikspatronen, import‑paden en probleemoplossingstips ontdekken zonder handmatige begeleiding.
Eigenschappen van formaatobjecten
Formaatobjecten die worden geretourneerd door get_possible_conversions() en get_all_possible_conversions() bieden nu mens‑leesbare eigenschappen:
.extension– bv.'pdf'.file_format– bv.'Portable Document Format'.description– bv.'Portable Document Format File (pdf)'
Voorheen werden deze objecten weergegeven als ondoorzichtige <NetObject handle=NNN>; ze worden nu weergegeven als <NetObject pdf> in repr() en bieden schone tekenreekswaarden via de hierboven genoemde eigenschappen.
Codevoorbeeld
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)
# produces: page_1.png, page_2.png, ...
Hoe de update te verkrijgen
PyPI
pip install --upgrade groupdocs-conversion