GroupDocs.Conversion for Python 26.9 – Destacados del lanzamiento de septiembre 2026

Estamos felices de anunciar el lanzamiento de GroupDocs.Conversion for Python v26.9, disponible a partir de septiembre de 2026. Esta versión actualiza el motor subyacente de GroupDocs.Conversion de 26.3 a 26.8, introduce la API ConversionEvents para el monitoreo en tiempo real de conversiones, agrega soporte para archivos XAR, diagramas draw.io y Mermaid, e incluye varias nuevas opciones de carga y conversión. También resuelve problemas críticos de compatibilidad en Python 3.5–3.10 y corrige defectos de larga data que afectaban a propiedades de tipo delegado y argumentos de enumeración.

What’s new in this release

• [Feature] Añadir soporte para ConversionEvents para observar el inicio, progreso, finalización por página y por documento, fallos y sustitución de fuentes (CONVERSIONPYTHON-93)
• [Feature] Añadir soporte para nuevos formatos — archivos XAR, diagramas draw.io y diagramas Mermaid (.mmd) (CONVERSIONPYTHON-94)
• [Feature] Añadir CadLoadOptions.layout_scope para restringir la conversión CAD al espacio de modelo, a los diseños de espacio de papel o a ambos (CONVERSIONPYTHON-95)
• [Feature] Añadir MarkdownOptions.image_saving_callback para controlar dónde se guardan las imágenes extraídas al Markdown (CONVERSIONPYTHON-96)
• [Feature] Añadir EmailLoadOptions.page_layout_options y WebLoadOptions.margin_settings / orientation_settings / size_settings (CONVERSIONPYTHON-97)
• [Feature] Añadir ImageConvertOptions.min_resolution y cap_resolution_to_page_content (CONVERSIONPYTHON-98)
• [Feature] Añadir WordProcessingLoadOptions.auto_detect_rtl_direction (CONVERSIONPYTHON-99)
• [Feature] Añadir MissingDependencyException para un fallo más claro cuando falta una dependencia opcional del motor (CONVERSIONPYTHON-100)
• [Enhancement] Actualizar el motor GroupDocs.Conversion de 26.3 a 26.8 (CONVERSIONPYTHON-101)
• [Enhancement] Eliminar el módulo duplicado groupdocs.conversion.file_types — usar groupdocs.conversion.filetypes (CONVERSIONPYTHON-102)
• [Enhancement] Renombrar PdfOptions.remove_pdf_acompliance a remove_pdf_a_compliance (CONVERSIONPYTHON-103)
• [Enhancement] Añadir una sección de Guía del Desarrollador y páginas groupdocs.conversion.integration.* a la referencia de API (CONVERSIONPYTHON-104)
• [Fix] No se puede importar el módulo al usar Python 3.5 – 3.7 (CONVERSIONPYTHON-91)
• [Fix] Error en tiempo de ejecución al pasar un argumento Enum en versiones de Python 3.8 – 3.10 (CONVERSIONPYTHON-92)
• [Fix] El indexador item en *DocumentInfo y PossibleConversions es una propiedad y no puede ser llamado (CONVERSIONPYTHON-105)
• [Fix] Las propiedades de tipo delegado no pueden asignarse desde Python (Object must implement IConvertible) (CONVERSIONPYTHON-106)
• [Fix] Las propiedades de tipo delegado están anotadas con el tipo incorrecto en los stubs y docstrings (CONVERSIONPYTHON-107)

Cambios en la API pública

Clases nuevas

Nuevos miembros en clases existentes

• FluentConverter.with_events(...), y lo mismo en IConversionFrom y IConversionSettings
• Converter(...) — cuatro nuevas sobrecargas del constructor que aceptan un 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

Eliminado — groupdocs.conversion.file_types

El módulo groupdocs.conversion.file_types y sus 23 clases han desaparecido. Las clases en sí no lo están — cada una de ellas sigue existiendo, sin cambios, en groupdocs.conversion.filetypes.

Si importabas desde él, cambia la importación — nada más:

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

Renombrado — PdfOptions.remove_pdf_acompliance

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

Nuevas características

Eventos de conversión

ConversionEvents te permite observar una conversión mientras se ejecuta — progreso, finalización por página y por documento, fallos y sustitución de fuentes. Adjunta funciones Python ordinarias:

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())

Observa que el constructor recibe (path, settings, events) — no existe una sobrecarga (path, events), así que pasa un ConverterSettings() incluso cuando no necesitas configurar nada.

Los ganchos disponibles son on_conversion_started, on_conversion_progress, on_conversion_completed, on_document_converted, on_document_failed, on_page_converted, on_page_failed, on_compression_completed y on_font_substituted.

Nuevos formatos

Ámbito de diseño CAD

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

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

BOTH es el valor predeterminado y no restringe la conversión.

Ejemplo 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())

Cómo obtener la actualización

PyPI

pip install groupdocs-conversion-net==26.9.0

Descarga directa

Descarga desde la página GroupDocs.Conversion for Python via .NET 26.9.

Recursos

• Notas completas de la versión
• Página del producto
• Documentación
• Referencia de API
• Ejemplos de código
• Free Support Forum