Chúng tôi rất vui thông báo về việc phát hành GroupDocs.Merger for Python v26.6, có sẵn từ tháng 6 năm 2026. Bản phát hành lớn này tái xây dựng binding Python thành một API kiểu tĩnh hiện đại, bổ sung hỗ trợ Python 3.14 và tích hợp AI agent, cho phép render bản xem trước trang và tách file dựa trên stream từ Python, đồng thời cung cấp các gói wheel tự chứa cho Windows, Linux và macOS.

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

  • [Enhancement] Tái xây dựng binding Python — một API kiểu, theo overload với các stub *.pyi được đóng gói (MERGERPYTHON-30)
  • [Feature] Hỗ trợ Python 3.14 (Requires-Python hiện là >=3.5,<3.15) (MERGERPYTHON-31)
  • [Feature] Render bản xem trước trang (generate_preview) và tách file dựa trên stream (split) giờ có thể gọi từ Python thông qua callback stream trang (MERGERPYTHON-32)
  • [Feature] Đưa AGENTS.md vào trong package để tích hợp AI agent / LLM (MERGERPYTHON-33)

Thay đổi API công khai

  • Mọi lớp, overload phương thức và enum đều được xuất ra rõ ràng với các gợi ý kiểu và stub .pyi.
  • Merger hiện hỗ trợ sử dụng dưới dạng context manager (with statement).
  • generate_preview chấp nhận một callback Python thuần để tạo stream cho mỗi trang.
  • split, extract_pages, remove_pages, swap_pages, move_page, rotate, change_orientation và các phương thức liên quan tới mật khẩu đều trả về IMerger (để chuỗi lệnh).
  • Các import mới từ groupdocs.merger.domain.options: SplitOptions, ExtractOptions, RotateOptions, RotateMode, PreviewOptions, PreviewMode.

Tính năng mới

  • Một API Python hiện đại, có kiểu tĩnh đầy đủ và không có proxy thuộc tính động tại thời gian chạy.
  • Render bản xem trước trang từ Python bằng mô hình stream dựa trên callback.
  • Hỗ trợ Python 3.14 trên mọi nền tảng (các wheel là py3-none-{platform}).
  • AGENTS.md được đưa vào trong package để kích hoạt tích hợp AI agent và LLM (ví dụ: GitHub Copilot, Claude Code, Cursor).

Ví dụ mã

from groupdocs.merger import Merger
from groupdocs.merger.domain.options import (
    SplitOptions, ExtractOptions, RotateOptions, RotateMode,
)

with Merger("input.pdf") as merger:
    # Giữ các trang 1-3, xoay trang 2, sau đó lưu
    merger.extract_pages(ExtractOptions([1, 2, 3]))
    merger.rotate(RotateOptions(RotateMode.ROTATE90, [2]))
    merger.save("reordered.pdf")

# Tách tài liệu thành một file cho mỗi trang
with Merger("input.pdf") as merger:
    merger.split(SplitOptions("page_{0}.pdf", [1, 2, 3]))

Ví dụ render bản xem trước trang:

from groupdocs.merger import Merger
from groupdocs.merger.domain.options import PreviewOptions, PreviewMode

def create_page_stream(page_number):
    return open(f"page-{page_number}.png", "wb")

with Merger("input.pdf") as merger:
    merger.generate_preview(PreviewOptions(create_page_stream, PreviewMode.PNG, [1, 2]))

Cách nhận bản cập nhật

PyPI

Nâng cấp bằng pip:

pip install groupdocs-merger-net

Tải trực tiếp

Tải wheel mới nhất từ trang GroupDocs.Merger for Python via .NET 26.6.

Tài nguyên