ما خوشحالیم که انتشار GroupDocs.Merger for Python v26.6 را اعلام می‌کنیم که از ژوئن 2026 در دسترس است. این انتشار بزرگ، بایندینگ پایتون را به‌صورت یک API مدرن و تایپ‌شده بازسازی می‌کند، پشتیبانی از Python 3.14 و یکپارچه‌سازی عامل هوش مصنوعی را اضافه می‌کند، امکان رندر پیش‌نمایش صفحه و تقسیم بر پایه جریان را از پایتون فعال می‌سازد و چرخ‌دنده‌های (wheels) خودکفا برای ویندوز، لینوکس و macOS ارائه می‌دهد.

What’s new in this release

  • [Enhancement] بازسازی بایندینگ پایتون — یک API تایپ‌شده، با هر overload به‌صورت جداگانه و شامل stubهای *.pyi (MERGERPYTHON-30)
  • [Feature] پشتیبانی از Python 3.14 (Requires-Python اکنون >=3.5,<3.15) (MERGERPYTHON-31)
  • [Feature] رندر پیش‌نمایش صفحه (generate_preview) و تقسیم بر پایه جریان (split) که اکنون از طریق callbackهای صفحه‑جریان در پایتون قابل فراخوانی هستند (MERGERPYTHON-32)
  • [Feature] افزودن فایل AGENTS.md داخل بسته برای یکپارچه‌سازی عامل هوش مصنوعی / LLM (MERGERPYTHON-33)

Public API changes

  • هر کلاس، overload متد و enum به‌صورت صریح با type hintها و stubهای .pyi صادر می‌شود.
  • Merger اکنون از استفاده به‌عنوان context manager (with statement) پشتیبانی می‌کند.
  • generate_preview یک callback ساده پایتون برای ایجاد جریان صفحه می‌پذیرد.
  • 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 پایتون مدرن و تایپ‌شده با تایپ استاتیک کامل و بدون پراکسی ویژگی پویا در زمان اجرا.
  • رندر پیش‌نمایش صفحه از پایتون با مدل جریان مبتنی بر callback.
  • پشتیبانی از Python 3.14 در تمام پلتفرم‌ها (چرخ‌دنده‌ها به‌صورت py3-none-{platform} هستند).
  • افزودن AGENTS.md داخل بسته برای فعال‌سازی یکپارچه‌سازی عامل هوش مصنوعی و 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:
    # 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