GroupDocs.Conversion pro Python v26.3 je nyní k dispozici. Toto vydání přidává konverzi po stránkách, výstup do paměťového proudu, podporu Python 3.14, soubory pro integraci AI‑agenta, rozšířené metadata formátů a několik vylepšení.

Co je nového v tomto vydání

Klíč Kategorie Shrnutí
CONVERSIONPYTHON-65 Feature Konverze po stránkách pomocí convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Feature Konverze do paměťového proudu pomocí convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Feature Podpora Python 3.14
CONVERSIONPYTHON-64 Feature Do balíčku je zahrnut soubor AGENTS.md pro integraci AI agenta
CONVERSIONPYTHON-67 Enhancement Objektům formátu jsou přidány vlastnosti .extension, .file_format, .description
CONVERSIONPYTHON-68 Enhancement Explicitní macOS klasifikátor v metadatech PyPI

Změny v veřejném API

Nové funkční metody – tyto metody byly deklarovány ve verzi 25.12, ale vyvolávaly NotImplementedError. Nyní jsou plně funkční:

Metoda Návratová hodnota Popis
Converter.convert_by_page(output_dir, convert_options) None Rozdělí dokument na jeden soubor na stránku ve zvoleném adresáři
Converter.convert_to_stream(convert_options) bytes Převede dokument a vrátí výsledek jako paměťové bajty

Metody zatím nedostupné – následující metody existují jako proxy atributy ve třídě Converter, ale zatím nejsou funkční v Python bindingu. Volání vyvolá výjimku:

Metoda Stav Řešení
convert_by_page(file_path, page_number, convert_options) TypeError — přetížení s 3 argumenty není vystaveno Použijte convert_options.page_number + convert_options.pages_count = 1 s convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — přetížení s 3 argumenty není vystaveno Převést do souboru, poté načíst do io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Použijte convert(file_path, options) pro konsolidovaný výstup do jednoho souboru z archivů

Nové funkce

Konverze po stránkách – convert_by_page
Metoda Converter.convert_by_page(output_dir, convert_options) je nyní plně funkční. Rozdělí více‑stránkový dokument na jednotlivé výstupní soubory — jeden na stránku — uložené do zadaného adresáře. Souborům jsou přiřazena jména page_1.ext, page_2.ext atd. Tato metoda funguje pro všechny třídy ConvertOptions, které podporují výstup po stránkách, jako jsou ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions a další.

Konverze do paměti – convert_to_stream
Metoda Converter.convert_to_stream(convert_options) nyní vrací převedený dokument jako objekt Python bytes, což umožňuje provádět konverzi v paměti bez zápisu na disk. To je užitečné pro cloudové funkce, webové aplikace a streamingové architektury, kde je přístup k souborovému systému omezený nebo nežádoucí.

Podpora Python 3.14
Rozsah podporovaných verzí Pythonu byl rozšířen z 3.5–3.13 (25.12) na 3.5–3.14. Metadata Requires-Python nyní uvádí >=3.5,<3.15 a stránka PyPI explicitně uvádí klasifikátory pro Python 3.8 až 3.14.

AGENTS.md – integrace AI agenta a LLM
Pip balíček groupdocs-conversion nyní obsahuje soubor AGENTS.md v groupdocs/conversion/AGENTS.md uvnitř wheelu. AI asistenti pro kódování, kteří skenují nainstalované balíčky — jako Claude Code, Cursor a GitHub Copilot — mohou automaticky objevit API, vzory použití, importní cesty a tipy pro řešení problémů bez nutnosti ručního vedení.

Vlastnosti objektu formátu
Objekty formátu vrácené metodami get_possible_conversions() a get_all_possible_conversions() nyní poskytují čitelné vlastnosti:

  • .extension – např. 'pdf'
  • .file_format – např. 'Portable Document Format'
  • .description – např. 'Portable Document Format File (pdf)'

Dříve se tyto objekty zobrazovaly jako neprůhledné <NetObject handle=NNN>; nyní se v repr() zobrazují jako <NetObject pdf> a poskytují čisté řetězcové hodnoty prostřednictvím výše uvedených vlastností.

Příklad kódu

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

Jak získat aktualizaci

PyPI

pip install --upgrade groupdocs-conversion

Zdroje