Latest release (June 2026)
GroupDocs.Merger for Python via .NET 26.6 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.
Full List of Changes in This Release
| Key | Category | Summary |
|---|---|---|
| MERGERPYTHON‑30 | Enhancement | Rebuilt the Python binding — a typed, per-overload API with bundled .pyi stubs |
| MERGERPYTHON‑31 | Feature | Python 3.14 support (Requires-Python is now >=3.5,<3.15) |
| MERGERPYTHON‑32 | Feature | Page-preview rendering (generate_preview) and stream-based split are now callable from Python via page-stream callbacks |
| MERGERPYTHON‑33 | Feature | Ship AGENTS.md inside the package for AI agent / LLM integration |
Major Features
A modern, typed Python API
Every class, method overload, and enum is emitted explicitly with type hints and .pyi stubs, so editors provide accurate autocomplete and there is no dynamic attribute proxy at runtime. The Merger class follows a simple open → operate → save flow and works as a context manager:
from groupdocs.merger import Merger
# Combine two documents of the same family into one
with Merger("input.docx") as merger:
merger.join("input2.docx")
merger.save("merged.docx")
The release covers the full document-manipulation surface: merge/join (whole files, page subsets, images, Word/PDF-specific options), split (by page list, interval, or text lines), page operations (extract, remove, swap, move, rotate, change orientation), password management, document inspection, and page preview.
Page-preview rendering from Python
generate_preview now accepts a plain Python callback, so you can rasterize pages to PNG, JPEG, or BMP without dropping to .NET. The callback returns a writable file stream for each requested page:
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]))
Python 3.14 support
The supported Python range is extended to 3.5 – 3.14. The wheel is py3-none-{platform}, so a single build works across all supported interpreters without recompilation.
AGENTS.md — AI Agent and LLM Integration
The groupdocs-merger-net pip package now ships an AGENTS.md file at groupdocs/merger/AGENTS.md inside the wheel, so AI coding assistants (Claude Code, Cursor, GitHub Copilot) can automatically discover the API surface, import paths, and usage patterns. See the Agents and LLM Integration documentation page.
Evaluation and Licensing
Without a license the library runs in evaluation mode: processed documents are subject to a page/document-count cap, and PDF output carries an evaluation watermark (other formats show an equivalent evaluation mark). Apply a license (or set GROUPDOCS_LIC_PATH) to lift both limits. A free 30-day temporary license is available.
Additional Resources
Feedback
If you have any questions, issues, or suggestions, please reach out through the Free Support Forum.