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.

Що нового у цьому випуску

  • [Enhancement] Перебудовано Python‑binding — типізований API з підтримкою перевантажень та вбудованими *.pyi stub‑файлами (MERGERPYTHON-30)
  • [Feature] Підтримка Python 3.14 (Requires-Python тепер >=3.5,<3.15) (MERGERPYTHON-31)
  • [Feature] Рендеринг попереднього перегляду сторінок (generate_preview) та потокове розділення split тепер доступні з Python через колбеки потоків сторінок (MERGERPYTHON-32)
  • [Feature] Додано AGENTS.md у пакет для інтеграції AI‑агентів / LLM (MERGERPYTHON-33)

Зміни у публічному API

  • Кожен клас, перевантаження методу та enum явно генеруються з підказками типів та .pyi stub‑файлами.
  • 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.

Нові можливості

  • Сучасний, типізований Python API з повною статичною типізацією та без динамічного проксі‑атрибуту під час виконання.
  • Рендеринг попереднього перегляду сторінок з Python за допомогою моделі потоків, що базується на колбеках.
  • Підтримка Python 3.14 на всіх платформах (колеса мають формат py3-none-{platform}).
  • AGENTS.md включено у пакет для забезпечення інтеграції AI‑агентів та 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:
    # 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]))

Приклад рендерингу попереднього перегляду сторінок:

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.

Ресурси