Siamo felici di annunciare il rilascio di GroupDocs.Merger for Python v26.6, disponibile a partire da giugno 2026. Questa versione importante ricostruisce il binding Python come una moderna API tipizzata, aggiunge il supporto a Python 3.14 e l’integrazione con agenti AI, abilita il rendering di anteprime di pagina e lo split basato su stream direttamente da Python, e fornisce wheel auto‑contenute per Windows, Linux e macOS.

Novità di questa versione

  • [Enhancement] Ricostruito il binding Python — un’API tipizzata, per overload, con stub *.pyi inclusi (MERGERPYTHON-30)
  • [Feature] Supporto a Python 3.14 (Requires-Python è ora >=3.5,<3.15) (MERGERPYTHON-31)
  • [Feature] Rendering di anteprime di pagina (generate_preview) e split basato su stream ora invocabili da Python tramite callback di stream di pagina (MERGERPYTHON-32)
  • [Feature] Inclusione di AGENTS.md nel pacchetto per l’integrazione con agenti AI / LLM (MERGERPYTHON-33)

Modifiche all’API pubblica

  • Ogni classe, overload di metodo ed enum vengono emessi esplicitamente con suggerimenti di tipo e stub .pyi.
  • Merger ora supporta l’uso come context manager (istruzione with).
  • generate_preview accetta una semplice callback Python per la creazione dello stream di pagina.
  • split, extract_pages, remove_pages, swap_pages, move_page, rotate, change_orientation e i metodi relativi alle password restituiscono IMerger (per il chaining).
  • Nuove importazioni da groupdocs.merger.domain.options: SplitOptions, ExtractOptions, RotateOptions, RotateMode, PreviewOptions, PreviewMode.

Nuove funzionalità

  • Un’API Python moderna e tipizzata con typing statico completo e senza proxy di attributi dinamici a runtime.
  • Rendering di anteprime di pagina da Python usando un modello di stream basato su callback.
  • Supporto a Python 3.14 su tutte le piattaforme (le wheel sono py3-none-{platform}).
  • AGENTS.md incluso nel pacchetto per abilitare l’integrazione con agenti AI e LLM (ad es., GitHub Copilot, Claude Code, Cursor).

Esempio di codice

from groupdocs.merger import Merger
from groupdocs.merger.domain.options import (
    SplitOptions, ExtractOptions, RotateOptions, RotateMode,
)

with Merger("input.pdf") as merger:
    # Mantieni le pagine 1-3, ruota la pagina 2, poi salva
    merger.extract_pages(ExtractOptions([1, 2, 3]))
    merger.rotate(RotateOptions(RotateMode.ROTATE90, [2]))
    merger.save("reordered.pdf")

# Dividi un documento in un file per pagina
with Merger("input.pdf") as merger:
    merger.split(SplitOptions("page_{0}.pdf", [1, 2, 3]))

Esempio di rendering di anteprima di pagina:

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

Come ottenere l’aggiornamento

PyPI

Aggiorna tramite pip:

pip install groupdocs-merger-net

Download diretto

Scarica l’ultima wheel dalla pagina GroupDocs.Merger for Python via .NET 26.6.

Risorse