GroupDocs.Conversion per Python v26.3 è ora disponibile. Questa versione aggiunge la conversione per pagina, l’output in stream in memoria, il supporto a Python 3.14, file di integrazione per agenti AI, metadati di formato migliorati e diverse rifiniture.

Novità di questa versione

Chiave Categoria Riepilogo
CONVERSIONPYTHON-65 Funzionalità Conversione per pagina tramite convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Funzionalità Conversione in memoria tramite convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Funzionalità Supporto per Python 3.14
CONVERSIONPYTHON-64 Funzionalità Distribuzione di AGENTS.md all’interno del pacchetto per l’integrazione dell’AI Agent
CONVERSIONPYTHON-67 Miglioramento Gli oggetti formato espongono le proprietà .extension, .file_format, .description
CONVERSIONPYTHON-68 Miglioramento Classificatore macOS esplicito nei metadati PyPI

Modifiche all’API pubblica

Nuovi metodi funzionali – questi metodi erano stati dichiarati nella 25.12 ma sollevavano NotImplementedError. Ora sono operativi:

Metodo Restituisce Descrizione
Converter.convert_by_page(output_dir, convert_options) None Divide un documento in un file per pagina nella directory specificata
Converter.convert_to_stream(convert_options) bytes Converte il documento e restituisce il risultato come byte in memoria

Metodi non ancora disponibili – i seguenti metodi esistono come proxy di attributi sulla classe Converter ma non sono ancora funzionali nel binding Python. La loro chiamata solleverà un’eccezione:

Metodo Stato Soluzione alternativa
convert_by_page(file_path, page_number, convert_options) TypeError — overload a 3 argomenti non esposto Usa convert_options.page_number + convert_options.pages_count = 1 con convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — overload a 3 argomenti non esposto Converti in file, poi leggi in io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Usa convert(file_path, options) per un output consolidato in un singolo file da archivi

Nuove funzionalità

Conversione per pagina – convert_by_page
Il metodo Converter.convert_by_page(output_dir, convert_options) è ora pienamente operativo. Divide un documento multiformato in file di output individuali — uno per pagina — salvati nella directory specificata. I file delle pagine sono denominati page_1.ext, page_2.ext e così via. Questo metodo funziona per tutte le classi ConvertOptions che supportano l’output basato su pagine, come ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions e altre.

Conversione in memoria – convert_to_stream
Il metodo Converter.convert_to_stream(convert_options) ora restituisce il documento convertito come oggetto bytes di Python, consentendo pipeline di conversione interamente in memoria senza scrivere su disco. È utile per funzioni cloud, applicazioni web e architetture di streaming dove l’accesso al filesystem è limitato o indesiderato.

Supporto a Python 3.14
L’intervallo di versioni Python supportate è stato esteso da 3.5–3.13 (25.12) a 3.5–3.14. I metadati Requires-Python ora indicano >=3.5,<3.15, e la pagina PyPI elenca esplicitamente i classificatori per Python 3.8 fino a 3.14.

AGENTS.md – Integrazione AI Agent e LLM
Il pacchetto groupdocs-conversion su pip ora include un file AGENTS.md in groupdocs/conversion/AGENTS.md all’interno della wheel. Gli assistenti di codifica AI che analizzano i pacchetti installati — come Claude Code, Cursor e GitHub Copilot — possono scoprire automaticamente la superficie API, i pattern di utilizzo, i percorsi di importazione e i suggerimenti di risoluzione dei problemi senza necessità di guida manuale.

Proprietà degli oggetti formato
Gli oggetti formato restituiti da get_possible_conversions() e get_all_possible_conversions() ora espongono proprietà leggibili:

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

In precedenza questi oggetti venivano visualizzati come <NetObject handle=NNN>; ora appaiono come <NetObject pdf> in repr() e forniscono valori stringa puliti tramite le proprietà sopra elencate.

Esempio di codice

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

Come ottenere l’aggiornamento

PyPI

pip install --upgrade groupdocs-conversion

Risorse