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 — 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 داخل الحزمة لتكامل وكيل الذكاء الاصطناعي / نماذج اللغة الكبيرة (MERGERPYTHON-33)

Public API changes

  • كل فئة، وتحميل طريقة، وتعداد يتم إصدارها صراحةً مع تلميحات النوع وملفات .pyi.
  • Merger يدعم الآن الاستخدام كمدير سياق (with statement).
  • 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

  • API Python حديث مكتوب بنوعيات مع دعم كامل للكتابة الساكنة دون أي وكيل خصائص ديناميكي في وقت التشغيل.
  • عرض معاينة الصفحات من Python باستخدام نموذج تدفق يعتمد على ردود النداء.
  • دعم Python 3.14 عبر جميع المنصات (العجلات هي py3-none-{platform}).
  • تضمين ملف AGENTS.md داخل الحزمة لتمكين تكامل وكيل الذكاء الاصطناعي ونماذج اللغة الكبيرة (مثل 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