我們很高興宣佈 GroupDocs.Merger for Python v26.6 已於 2026 年 6 月 正式發佈。此重大版本將 Python 綁定重建為現代化的型別化 API，加入 Python 3.14 支援與 AI 代理整合，支援頁面預覽渲染與基於串流的分割功能，並提供適用於 Windows、Linux 與 macOS 的自包含 wheel。

What’s new in this release

  • [Enhancement] 重建 Python 綁定 — 具型別化、每個重載皆有 *.pyi 存根的 API (MERGERPYTHON-30)
  • [Feature] 支援 Python 3.14（Requires-Python 現已設定為 >=3.5,<3.15）(MERGERPYTHON-31)
  • [Feature] 頁面預覽渲染 (generate_preview) 與基於串流的 split 現可透過頁面串流回呼在 Python 中呼叫 (MERGERPYTHON-32)
  • [Feature] 在套件內加入 AGENTS.md，供 AI 代理 / LLM 整合使用 (MERGERPYTHON-33)

Public API changes

  • 每個類別、方法重載與列舉皆明確輸出型別提示與 .pyi 存根。
  • Merger 現支援使用情境管理器（with 陳述式）。
  • generate_preview 接受純 Python 回呼，用於建立頁面串流。
  • split、extract_pages、remove_pages、swap_pages、move_page、rotate、change_orientation 以及與密碼相關的方法皆回傳 IMerger（可鏈式呼叫）。
  • 新增從 groupdocs.merger.domain.options 匯入的類別：SplitOptions、ExtractOptions、RotateOptions、RotateMode、PreviewOptions、PreviewMode。

New features

  • 現代化、型別化的 Python API，具完整靜態型別檢查，且在執行時不再使用動態屬性代理。
  • 透過回呼式串流模型，從 Python 執行頁面預覽渲染。
  • 在所有平台上支援 Python 3.14（wheel 為 py3-none-{platform}）。
  • 套件內附帶 AGENTS.md，可啟用 AI 代理與 LLM 整合（例如 GitHub Copilot、Claude Code、Cursor）。

Code example

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

with Merger("input.pdf") as merger:
    # 保留第 1‑3 頁，旋轉第 2 頁，然後儲存
    merger.extract_pages(ExtractOptions([1, 2, 3]))
    merger.rotate(RotateOptions(RotateMode.ROTATE90, [2]))
    merger.save("reordered.pdf")

# 將文件拆分為每頁一個檔案
with Merger("input.pdf") as merger:
    merger.split(SplitOptions("page_{0}.pdf", [1, 2, 3]))

Page-preview rendering example:

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

How to get the update

PyPI

使用 pip 升級：

pip install groupdocs-merger-net

Direct download

從 GroupDocs.Merger for Python via .NET 26.6 頁面下載最新的 wheel。

Resources