We’re happy to announce the release of GroupDocs.Merger for Python v26.6, available as of June 2026. This major release rebuilds the Python binding as a modern typed API, adds Python 3.14 support and AI agent integration, enables page‑preview rendering and stream‑based split from Python, and ships self‑contained wheels for Windows, Linux, and macOS.

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