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

چه چیزهایی در این نسخه جدید است

  • [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)

تغییرات API عمومی

  • هر کلاس، 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 را برمی‌گردانند (برای chaining).
  • ایمپورت‌های جدید از groupdocs.merger.domain.options: SplitOptions، ExtractOptions، RotateOptions، RotateMode، PreviewOptions، PreviewMode.

ویژگی‌های جدید

  • یک API پایتون مدرن و تایپ‌شده با تایپ استاتیک کامل و بدون پراکسی ویژگی‌های پویا در زمان اجرا.
  • رندر پیش‌نمایش صفحه از پایتون با مدل استریم مبتنی بر callback.
  • پشتیبانی از Python 3.14 در تمام پلتفرم‌ها (چرخ‌دنده‌ها به‌صورت py3-none-{platform} هستند).
  • فایل AGENTS.md داخل بسته برای فعال‌سازی یکپارچه‌سازی عامل هوش مصنوعی و LLM (مانند GitHub Copilot، Claude Code، Cursor) گنجانده شده است.

مثال کد

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

مثال رندر پیش‌نمایش صفحه:

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

نحوه دریافت به‌روزرسانی

PyPI

به‌روزرسانی با pip:

pip install groupdocs-merger-net

دانلود مستقیم

چرخ‌دندهٔ جدید را از صفحهٔ GroupDocs.Merger for Python via .NET 26.6 دانلود کنید.

منابع