GroupDocs.Conversion for Python v26.3 đã có sẵn. Bản phát hành này bổ sung chuyển đổi theo trang, xuất luồng bộ nhớ trong, hỗ trợ Python 3.14, tệp tích hợp AI‑agent, siêu dữ liệu định dạng được cải thiện và một số tinh chỉnh.

Những gì mới trong bản phát hành

Khóa Thể loại Tóm tắt
CONVERSIONPYTHON-65 Tính năng Chuyển đổi theo trang qua convert_by_page(output_dir, convert_options)
CONVERSIONPYTHON-66 Tính năng Chuyển đổi trong bộ nhớ qua convert_to_stream(convert_options)
CONVERSIONPYTHON-62 Tính năng Hỗ trợ Python 3.14
CONVERSIONPYTHON-64 Tính năng Đưa AGENTS.md vào gói để tích hợp AI Agent
CONVERSIONPYTHON-67 Cải tiến Các đối tượng định dạng cung cấp thuộc tính .extension, .file_format, .description
CONVERSIONPYTHON-68 Cải tiến Bộ phân loại macOS rõ ràng trong siêu dữ liệu PyPI

Thay đổi API công cộng

Các phương thức chức năng mới – các phương thức này đã được khai báo trong 25.12 nhưng trả về NotImplementedError. Giờ chúng đã hoạt động:

Phương thức Trả về Mô tả
Converter.convert_by_page(output_dir, convert_options) None Tách tài liệu thành một tệp cho mỗi trang trong thư mục được chỉ định
Converter.convert_to_stream(convert_options) bytes Chuyển đổi tài liệu và trả về kết quả dưới dạng byte trong bộ nhớ

Các phương thức chưa khả dụng – các phương thức sau tồn tại như các proxy thuộc tính trên lớp Converter nhưng chưa hoạt động trong binding Python. Gọi chúng sẽ gây ra ngoại lệ:

Phương thức Trạng thái Giải pháp tạm thời
convert_by_page(file_path, page_number, convert_options) TypeError — overload 3‑arg không được phơi bày Dùng convert_options.page_number + convert_options.pages_count = 1 với convert(file_path, options)
convert_by_page(stream, page_number, convert_options) TypeError — overload 3‑arg không được phơi bày Chuyển đổi thành tệp, sau đó đọc vào io.BytesIO
convert_multiple(folder_path, convert_options) MissingMethodException Dùng convert(file_path, options) để tạo đầu ra duy nhất gộp từ các tệp lưu trữ

Tính năng mới

Chuyển đổi theo trang – convert_by_page
Phương thức Converter.convert_by_page(output_dir, convert_options) hiện đã hoạt động đầy đủ. Nó tách tài liệu đa trang thành các tệp đầu ra riêng lẻ — một tệp cho mỗi trang — và lưu vào thư mục được chỉ định. Các tệp trang được đặt tên page_1.ext, page_2.ext, … Phương thức này hỗ trợ tất cả các lớp ConvertOptions cho phép xuất dựa trên trang, chẳng hạn như ImageConvertOptions, PdfConvertOptions, WordProcessingConvertOptions, PresentationConvertOptions và các loại khác.

Chuyển đổi trong bộ nhớ – convert_to_stream
Phương thức Converter.convert_to_stream(convert_options) giờ trả về tài liệu đã chuyển đổi dưới dạng đối tượng bytes của Python, cho phép xây dựng pipeline chuyển đổi trong bộ nhớ mà không cần ghi ra đĩa. Điều này hữu ích cho các hàm đám mây, ứng dụng web và kiến trúc streaming nơi truy cập hệ thống tệp bị hạn chế hoặc không mong muốn.

Hỗ trợ Python 3.14
Phạm vi phiên bản Python được hỗ trợ được mở rộng từ 3.5–3.13 (25.12) lên 3.5–3.14. Siêu dữ liệu Requires-Python hiện là >=3.5,<3.15, và trang PyPI liệt kê rõ các classifier cho Python 3.8 đến 3.14.

AGENTS.md – Tích hợp AI Agent và LLM
Gói pip groupdocs-conversion hiện bao gồm tệp AGENTS.md tại groupdocs/conversion/AGENTS.md trong wheel. Các trợ lý lập trình AI quét các gói đã cài đặt — như Claude Code, Cursor và GitHub Copilot — có thể tự động khám phá bề mặt API, mẫu sử dụng, đường dẫn import và các mẹo khắc phục sự cố mà không cần hướng dẫn thủ công.

Thuộc tính đối tượng Định dạng
Các đối tượng định dạng trả về bởi get_possible_conversions() và get_all_possible_conversions() giờ cung cấp các thuộc tính dễ đọc:

  • .extension – ví dụ 'pdf'
  • .file_format – ví dụ 'Portable Document Format'
  • .description – ví dụ 'Portable Document Format File (pdf)'

Trước đây các đối tượng này hiển thị dưới dạng <NetObject handle=NNN>; bây giờ chúng hiển thị như <NetObject pdf> trong repr() và cung cấp giá trị chuỗi sạch qua các thuộc tính trên.

Ví dụ mã

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ách nhận bản cập nhật

PyPI

pip install --upgrade groupdocs-conversion

Tài nguyên