GroupDocs.Conversion for Python 26.9 – Destaques do Lançamento de Setembro 2026

Estamos felizes em anunciar o lançamento do GroupDocs.Conversion for Python v26.9, disponível a partir de setembro de 2026. Esta versão atualiza o mecanismo subjacente do GroupDocs.Conversion de 26.3 para 26.8, introduz a API ConversionEvents para monitoramento em tempo real da conversão, adiciona suporte a arquivos XAR, diagramas draw.io e Mermaid, e inclui várias novas opções de carregamento e conversão. Também resolve problemas críticos de compatibilidade nas versões Python 3.5–3.10 e corrige defeitos antigos que afetavam propriedades do tipo delegate e argumentos enum.

O que há de novo nesta versão

• [Feature] Adicionar suporte a ConversionEvents para observar início, progresso, conclusão por página e por documento, falhas e substituição de fontes (CONVERSIONPYTHON-93)
• [Feature] Adicionar suporte a novos formatos — arquivos XAR, diagramas draw.io e diagramas Mermaid (.mmd) (CONVERSIONPYTHON-94)
• [Feature] Adicionar CadLoadOptions.layout_scope para restringir a conversão CAD ao espaço de modelo, layouts de papel ou ambos (CONVERSIONPYTHON-95)
• [Feature] Adicionar MarkdownOptions.image_saving_callback para controlar onde as imagens extraídas para Markdown são gravadas (CONVERSIONPYTHON-96)
• [Feature] Adicionar EmailLoadOptions.page_layout_options e WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
• [Feature] Adicionar ImageConvertOptions.min_resolution e cap_resolution_to_page_content (CONVERSIONPYTHON-98)
• [Feature] Adicionar WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
• [Feature] Adicionar MissingDependencyException para falha mais clara quando uma dependência opcional do motor está ausente (CONVERSIONPYTHON-100)
• [Enhancement] Atualizar o motor GroupDocs.Conversion de 26.3 para 26.8 (CONVERSIONPYTHON-101)
• [Enhancement] Remover o módulo duplicado groupdocs.conversion.file_types — usar groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
• [Enhancement] Renomear PdfOptions.remove_pdf_acompliance para remove_pdf_a_compliance (CONVERSIONPYTHON-103)
• [Enhancement] Adicionar seção Guia do Desenvolvedor e páginas groupdocs.conversion.integration.* à referência da API (CONVERSIONPYTHON-104)
• [Fix] Não é possível importar o módulo ao usar Python 3.5 – 3.7 (CONVERSIONPYTHON-91)
• [Fix] Erro de tempo de execução ao passar argumento Enum nas versões Python 3.8 – 3.10 (CONVERSIONPYTHON-92)
• [Fix] O indexador item em *DocumentInfo e PossibleConversions é uma propriedade e não pode ser chamado (CONVERSIONPYTHON-105)
• [Fix] Propriedades do tipo delegate não podem ser atribuídas a partir do Python (Object must implement IConvertible) (CONVERSIONPYTHON-106)
• [Fix] Propriedades do tipo delegate são anotadas com o tipo errado em stubs e docstrings (CONVERSIONPYTHON-107)

Alterações na API pública

Novas classes

Novos membros em classes existentes

• FluentConverter.with_events(...), e o mesmo em IConversionFrom e IConversionSettings
• Converter(...) — quatro novas sobrecargas de construtor que aceitam um ConversionEvents
• CadLoadOptions.layout_scope
• EmailLoadOptions.page_layout_options
• WebLoadOptions.margin_settings, .orientation_settings, .size_settings
• MarkdownOptions.image_saving_callback
• ImageConvertOptions.min_resolution, .cap_resolution_to_page_content
• WordProcessingLoadOptions.auto_detect_rtl_direction
• CompressionFileType.XAR, DiagramFileType.DRAWIO, DiagramFileType.MMD

Removido — groupdocs.conversion.file_types

O módulo groupdocs.conversion.file_types e suas 23 classes foram removidos. As classes em si não foram — cada uma ainda existe, inalterada, em groupdocs.conversion.filetypes.

Se você importava dele, altere a importação — nada mais:

# before
from groupdocs.conversion.file_types import WordProcessingFileType
# after
from groupdocs.conversion.filetypes import WordProcessingFileType

Renomeado — PdfOptions.remove_pdf_acompliance

# before
options.remove_pdf_acompliance = True
# after
options.remove_pdf_a_compliance = True

Novos recursos

Eventos de conversão

ConversionEvents permite observar uma conversão enquanto ela está em execução — progresso, conclusão por página e por documento, falhas e substituição de fontes. Anexe funções Python comuns:

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

Observe que o construtor recebe (path, settings, events) — não existe sobrecarga (path, events), portanto passe um ConverterSettings() mesmo quando não precisar configurar nada.

Os ganchos disponíveis são on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed e on_font_substituted.

Novos formatos

Escopo de layout CAD

from groupdocs.conversion.options.load import CadLayoutScope, CadLoadOptions

load_options = CadLoadOptions()
load_options.layout_scope = CadLayoutScope.MODEL     # MODEL | LAYOUTS | BOTH

BOTH é o padrão e não restringe a conversão.

Exemplo de código

from groupdocs.conversion import ConversionEvents, Converter, ConverterSettings
from groupdocs.conversion.options.convert import PdfConvertOptions

events = ConversionEvents()
events.on_conversion_started = lambda: print("started")
events.on_conversion_progress = lambda percent: print(f"{percent}%")
events.on_document_converted = lambda ctx: print("document done")
events.on_font_substituted = lambda ctx: print(
    f"{ctx.original_font_name} -> {ctx.substitute_font_name} ({ctx.reason})")
events.on_conversion_completed = lambda: print("completed")

with Converter("business-plan.docx", ConverterSettings(), events) as converter:
    converter.convert("business-plan.pdf", PdfConvertOptions())

Como obter a atualização

PyPI

pip install groupdocs-conversion-net==26.9.0

Download direto

Baixe a partir da página GroupDocs.Conversion for Python via .NET 26.9.

Recursos

• Notas completas da versão
• Página do produto
• Documentação
• Referência da API
• Exemplos de código
• Free Support Forum