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

What’s new in this release

  • [Enhancement] 重建 Python 綁定 — 具備型別化、每個重載皆有明確 API，並捆綁 *.pyi 存根 (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 代理 / 大型語言模型整合 (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 代理與大型語言模型整合（例如 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]))

頁面預覽渲染範例：

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