GroupDocs.Conversion for Python v26.3 jest już dostępny. To wydanie dodaje konwersję stron po stronie, wyjście do strumienia w pamięci, wsparcie dla Pythona 3.14, pliki integracji z AI‑agentem, rozszerzone metadane formatów oraz kilka udoskonaleń.

Co nowego w tym wydaniu

Klucz Kategoria Podsumowanie
CONVERSIONPYTHON-65 Feature Konwersja po stronie za pomocą convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Feature Konwersja w pamięci za pomocą convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Feature Wsparcie dla Pythona 3.14
CONVERSIONPYTHON-64 Feature Do pakietu dołączono plik AGENTS.md dla integracji z AI Agent
CONVERSIONPYTHON-67 Enhancement Obiekty formatu udostępniają właściwości .extension, .file_format, .description
CONVERSIONPYTHON-68 Enhancement Jawny klasyfikator macOS w metadanych PyPI

Zmiany w publicznym API

Nowe metody funkcyjne – te metody zostały zadeklarowane w wersji 25.12, ale podnosiły NotImplementedError. Są teraz w pełni operacyjne:

Metoda Zwraca Opis
Converter.convert_by_page(output_dir, convert_options) None Dzieli dokument na jeden plik na stronę w podanym katalogu
Converter.convert_to_stream(convert_options) bytes Konwertuje dokument i zwraca wynik jako bajty w pamięci

Metody jeszcze niedostępne – poniższe metody istnieją jako proxy atrybutów w klasie Converter, ale nie są jeszcze funkcjonalne w powiązaniu Pythona. Ich wywołanie spowoduje wyjątek:

Metoda Status Obejście
convert_by_page(file_path, page_number, convert_options) TypeError — przeciążenie 3‑argumentowe nieudostępnione Użyj convert_options.page_number + convert_options.pages_count = 1 z convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — przeciążenie 3‑argumentowe nieudostępnione Konwertuj do pliku, a następnie wczytaj do io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Użyj convert(file_path, options) dla scentralizowanego wyjścia jednego pliku z archiwów

Nowe funkcje

Konwersja po stronie – convert_by_page
Metoda Converter.convert_by_page(output_dir, convert_options) jest teraz w pełni funkcjonalna. Dzieli dokument wielostronicowy na osobne pliki wyjściowe — po jednym na stronę — zapisane w określonym katalogu. Pliki stron są nazwane page_1.ext, page_2.ext itd. Metoda działa dla wszystkich klas ConvertOptions, które obsługują wyjście oparte na stronach, takich jak ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions i inne.

Konwersja w pamięci – convert_to_stream
Metoda Converter.convert_to_stream(convert_options) zwraca teraz skonwertowany dokument jako obiekt bytes w Pythonie, umożliwiając przepływy konwersji w pamięci bez zapisywania na dysku. Jest to przydatne w funkcjach chmurowych, aplikacjach webowych i architekturach strumieniowych, gdzie dostęp do systemu plików jest ograniczony lub niepożądany.

Wsparcie dla Pythona 3.14
Zakres obsługiwanych wersji Pythona został rozszerzony z 3.5–3.13 (25.12) do 3.5–3.14. Metadane Requires-Python teraz brzmią >=3.5,<3.15, a strona PyPI wyraźnie wymienia klasyfikatory dla Pythona 3.8‑3.14.

AGENTS.md – integracja AI Agent i LLM
Pakiet groupdocs-conversion w pipie teraz zawiera plik AGENTS.md w lokalizacji groupdocs/conversion/AGENTS.md wewnątrz koła. Asystenci kodowania AI, którzy skanują zainstalowane pakiety — tacy jak Claude Code, Cursor i GitHub Copilot — mogą automatycznie odkrywać powierzchnię API, wzorce użycia, ścieżki importu i wskazówki rozwiązywania problemów bez ręcznej pomocy.

Właściwości obiektów formatu
Obiekty formatu zwracane przez get_possible_conversions() i get_all_possible_conversions() teraz udostępniają czytelne właściwości:

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

Wcześniej te obiekty wyświetlały się jako nieprzejrzyste <NetObject handle=NNN>; teraz w repr() pojawia się <NetObject pdf> i zapewniają czyste wartości tekstowe poprzez wymienione powyżej właściwości.

Przykład kodu

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, ...

Jak uzyskać aktualizację

PyPI

pip install --upgrade groupdocs-conversion

Zasoby