GroupDocs.Conversion for Python v26.3 ya está disponible. Esta versión añade conversión por página, salida en flujo de memoria, soporte para Python 3.14, archivos de integración de agente de IA, metadatos de formato mejorados y varias refinaciones.

Qué hay de nuevo en esta versión

Clave Categoría Resumen
CONVERSIONPYTHON-65 Feature Conversión por página mediante convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Feature Conversión en memoria mediante convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Feature Soporte para Python 3.14
CONVERSIONPYTHON-64 Feature Incluye AGENTS.md dentro del paquete para integración de AI Agent
CONVERSIONPYTHON-67 Enhancement Los objetos de formato exponen las propiedades .extension, .file_format, .description
CONVERSIONPYTHON-68 Enhancement Clasificador explícito de macOS en los metadatos de PyPI

Cambios en la API pública

Nuevos métodos funcionales – estos métodos fueron declarados en 25.12 pero lanzaban NotImplementedError. Ahora están operativos:

Método Devuelve Descripción
Converter.convert_by_page(output_dir, convert_options) None Divide un documento en un archivo por página en el directorio especificado
Converter.convert_to_stream(convert_options) bytes Convierte el documento y devuelve el resultado como bytes en memoria

Métodos aún no disponibles – los siguientes métodos existen como proxies de atributos en la clase Converter pero todavía no son funcionales en el enlace de Python. Llamarlos generará una excepción:

Método Estado Solución alternativa
convert_by_page(file_path, page_number, convert_options) TypeError — sobrecarga de 3 argumentos no expuesta Use convert_options.page_number + convert_options.pages_count = 1 con convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — sobrecarga de 3 argumentos no expuesta Convierta a archivo, luego léalo en io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Use convert(file_path, options) para una salida consolidada de un solo archivo a partir de archivos comprimidos

Nuevas características

Conversión por página – convert_by_page
El método Converter.convert_by_page(output_dir, convert_options) ahora funciona completamente. Divide un documento multipágina en archivos de salida individuales — uno por página — guardados en el directorio especificado. Los archivos de página se nombran page_1.ext, page_2.ext, etc. Este método funciona con todas las clases ConvertOptions que admiten salida basada en páginas, como ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions y otras.

Conversión en memoria – convert_to_stream
El método Converter.convert_to_stream(convert_options) ahora devuelve el documento convertido como un objeto bytes de Python, lo que permite canalizaciones de conversión en memoria sin escribir en disco. Esto es útil para funciones en la nube, aplicaciones web y arquitecturas de streaming donde el acceso al sistema de archivos es limitado o indeseable.

Soporte para Python 3.14
El rango de versiones de Python compatibles se amplía de 3.5–3.13 (25.12) a 3.5–3.14. Los metadatos Requires-Python ahora indican >=3.5,<3.15, y la página de PyPI lista explícitamente clasificadores para Python 3.8 hasta 3.14.

AGENTS.md – Integración de AI Agent y LLM
El paquete pip groupdocs-conversion ahora incluye un archivo AGENTS.md en groupdocs/conversion/AGENTS.md dentro del wheel. Los asistentes de codificación de IA que escanean paquetes instalados — como Claude Code, Cursor y GitHub Copilot — pueden descubrir automáticamente la superficie de la API, patrones de uso, rutas de importación y consejos de solución de problemas sin guía manual.

Propiedades de los objetos de formato
Los objetos de formato devueltos por get_possible_conversions() y get_all_possible_conversions() ahora exponen propiedades legibles:

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

Anteriormente estos objetos se mostraban como <NetObject handle=NNN>; ahora aparecen como <NetObject pdf> en repr() y proporcionan valores de cadena limpios mediante las propiedades enumeradas arriba.

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

Cómo obtener la actualización

PyPI

pip install --upgrade groupdocs-conversion

Recursos