GroupDocs.Conversion for Python v26.3 está agora disponível. Esta versão adiciona conversão por página, saída em fluxo de memória, suporte ao Python 3.14, arquivos de integração com agente de IA, metadados de formato aprimorados e várias refinamentos.

O que há de novo nesta versão

Chave Categoria Resumo
CONVERSIONPYTHON-65 Recurso Conversão por página via convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Recurso Conversão em memória via convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Recurso Suporte ao Python 3.14
CONVERSIONPYTHON-64 Recurso Inclui AGENTS.md no pacote para integração de Agente de IA
CONVERSIONPYTHON-67 Melhoria Objetos de formato expõem as propriedades .extension, .file_format, .description
CONVERSIONPYTHON-68 Melhoria Classificador macOS explícito nos metadados do PyPI

Alterações na API pública

Novos Métodos Funcionais – esses métodos foram declarados na 25.12, mas levantavam NotImplementedError. Agora estão operacionais:

Método Retorno Descrição
Converter.convert_by_page(output_dir, convert_options) None Divide um documento em um arquivo por página no diretório especificado
Converter.convert_to_stream(convert_options) bytes Converte o documento e retorna o resultado como bytes em memória

Métodos Ainda Não Disponíveis – os seguintes métodos existem como proxies de atributo na classe Converter, mas ainda não são funcionais na ligação Python. Chamá‑los levantará uma exceção:

Método Status Solução alternativa
convert_by_page(file_path, page_number, convert_options) TypeError — sobrecarga de 3 argumentos não exposta Use convert_options.page_number + convert_options.pages_count = 1 com convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — sobrecarga de 3 argumentos não exposta Converta para arquivo, então leia em io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Use convert(file_path, options) para obter uma saída consolidada de um único arquivo a partir de arquivos compactados

Novos recursos

Conversão por Página – convert_by_page
O método Converter.convert_by_page(output_dir, convert_options) está agora totalmente funcional. Ele divide um documento multipágina em arquivos de saída individuais — um por página — salvos no diretório especificado. Os arquivos de página são nomeados page_1.ext, page_2.ext e assim por diante. Este método funciona para todas as classes ConvertOptions que suportam saída baseada em página, como ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions e outras.

Conversão em Memória – convert_to_stream
O método Converter.convert_to_stream(convert_options) agora retorna o documento convertido como um objeto bytes do Python, permitindo pipelines de conversão em memória sem gravação em disco. Isso é útil para funções em nuvem, aplicações web e arquiteturas de streaming onde o acesso ao sistema de arquivos é limitado ou indesejado.

Suporte ao Python 3.14
O intervalo de versões suportadas do Python foi ampliado de 3.5–3.13 (25.12) para 3.5–3.14. Os metadados Requires-Python agora indicam >=3.5,<3.15, e a página do PyPI lista explicitamente classificadores para Python 3.8 até 3.14.

AGENTS.md – Integração com Agente de IA e LLM
O pacote groupdocs-conversion no pip agora inclui um arquivo AGENTS.md em groupdocs/conversion/AGENTS.md dentro do wheel. Assistentes de codificação baseados em IA que analisam pacotes instalados — como Claude Code, Cursor e GitHub Copilot — podem descobrir automaticamente a superfície da API, padrões de uso, caminhos de importação e dicas de solução de problemas sem necessidade de orientação manual.

Propriedades dos Objetos de Formato
Objetos de formato retornados por get_possible_conversions() e get_all_possible_conversions() agora expõem propriedades legíveis:

  • .extension – por exemplo, 'pdf'
  • .file_format – por exemplo, 'Portable Document Format'
  • .description – por exemplo, 'Portable Document Format File (pdf)'

Anteriormente esses objetos eram exibidos como <NetObject handle=NNN>; agora aparecem como <NetObject pdf> no repr() e fornecem valores de string limpos através das propriedades acima.

Exemplo de código

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

Como obter a atualização

PyPI

pip install --upgrade groupdocs-conversion

Recursos