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] Rebuilt the Python binding — a typed, per-overload API with bundled *.pyi stubs (MERGERPYTHON-30)
  • [Feature] Python 3.14 support (Requires-Python is now >=3.5,<3.15) (MERGERPYTHON-31)
  • [Feature] Page-preview rendering (generate_preview) and stream-based split are now callable from Python via page-stream callbacks (MERGERPYTHON-32)
  • [Feature] Ship AGENTS.md inside the package for AI agent / LLM integration (MERGERPYTHON-33)

Public API changes

  • Every class, method overload, and enum is emitted explicitly with type hints and .pyi stubs.
  • Merger now supports context manager usage (with statement).
  • generate_preview accepts a plain Python callback for page-stream creation.
  • split, extract_pages, remove_pages, swap_pages, move_page, rotate, change_orientation, and password-related methods return IMerger (for chaining).
  • New imports from groupdocs.merger.domain.options: SplitOptions, ExtractOptions, RotateOptions, RotateMode, PreviewOptions, PreviewMode.

New features

  • A modern, typed Python API with full static typing and no dynamic attribute proxy at runtime.
  • Page-preview rendering from Python using a callback-based stream model.
  • Python 3.14 support across all platforms (wheels are py3-none-{platform}).
  • AGENTS.md shipped inside the package to enable AI agent and LLM integration (e.g., 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:
    # Keep pages 1-3, rotate page 2, then save
    merger.extract_pages(ExtractOptions([1, 2, 3]))
    merger.rotate(RotateOptions(RotateMode.ROTATE90, [2]))
    merger.save("reordered.pdf")

# Split a document into one file per page
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

Upgrade via pip:

pip install groupdocs-merger-net

Direct download

Download the latest wheel from the GroupDocs.Merger for Python via .NET 26.6 page.

Resources