GroupDocs.Comparison for Python 26.5 – Klíčové body vydání května 2026

GroupDocs.Comparison pro Python 26.5.0 je nyní k dispozici. Jedná se o první veřejné vydání knihovny na PyPI od verze 25.12 a přináší čistě Python wrapper, zahrnutý AGENTS.md pro objevování AI asistentů, nový konzolový skript a rozsáhlou restrukturalizaci dokumentace.

Co je nového v tomto vydání

Změny veřejného API

Wrapper verze 26.x byl přestavěn pomocí nového generátoru, který zpřístupňuje širší veřejné API a upravuje několik názvů členů. Většina existujících skriptů napsaných pro 25.12 běží beze změn na 26.5; níže uvedené změny jsou seskupeny podle dopadu na kompatibilitu.

Nově viditelné třídy na nejvyšší úrovni

Tyto třídy existovaly v interních částech 25.12, ale byly skryté před introspekcí v Pythonu díky Nuitka‑kompilovanému wrapperu. Nyní jsou přímo importovatelné:

from groupdocs.comparison.license import License, Metered
from groupdocs.comparison.options import (
    Color, PdfCompareOptions, WordCompareOptions, CalculateCoordinatesModeEnumeration,
    ChangeType, ComparisonDisplayMode, DetalisationLevel, FolderComparisonExtension,
    ImagesInheritance, MetadataType, PagesSetup, PaperSize, PasswordSaveOption,
    PreviewFormats, PreviewResolution,
)
from groupdocs.comparison.result import ComparisonAction, FileType, Rectangle

Nová třída Color

StyleSettings.font_color, .highlight_color, .shape_color a .boarder_color nyní přijímají některou z následujících možností:

from groupdocs.comparison.options import Color

# Named‑color factory
style.font_color = Color.from_name("firebrick")

# RGB / RGBA tuple
style.font_color = (255, 0, 0)
style.font_color = (255, 0, 0, 128)

# Hex string
style.font_color = "#FF8800"
style.font_color = "#80FF8800"  # AARRGGBB

# Packed ARGB int
style.font_color = 0xFF0000

# Or a Color instance directly
style.font_color = Color(178, 34, 34, 255)

Color lze importovat z groupdocs.comparison, groupdocs.comparison.options a groupdocs.pydrawing – všechny tři cesty odkazují na stejnou třídu.

PreviewOptions založené na volatelných objektech

PreviewOptions konstruktor přijímá volatelný objekt Pythonu pro delegáta CreatePageStream. Signatura callbacku je (page_number) -> writable_stream:

from groupdocs.comparison.options import PreviewOptions, PreviewFormats

def create_page_stream(page_number):
    return open(f"page-{page_number}.png", "wb")

def release_page_stream(page_number):
    pass  # the bridge has already flushed/closed the stream

with Comparer("source.docx") as comparer:
    preview = PreviewOptions(create_page_stream, release_page_stream)
    preview.preview_format = PreviewFormats.PNG
    preview.page_numbers = [1, 2, 3]
    comparer.source.generate_preview(preview)

PreviewOptions(create_page_stream) (jeden argument, bez callbacku pro uvolnění) je také platný.

Typovaný Rectangle z vlastností souřadnic

options = CompareOptions(calculate_coordinates=True)
with Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    comparer.compare(options)
    for change in comparer.get_changes():
        b = change.box
        print(f"({b.x:.1f}, {b.y:.1f}) {b.width:.1f}x{b.height:.1f}")
# (488.96, 223.86) 71.09x36.80 — '…'

Oprava je platná pro celý produkt – vztahuje se na každou vlastnost typu hodnota ve všech produktech (Point, Size atd., nejen na Rectangle).

Parametry pojmenované podle názvů vlastností v konstruktorech možností

opts = ApplyChangeOptions(changes=changes, save_original_state=True)
save = SaveOptions(password="secret")
load = LoadOptions(password="open-sesame")
comp = CompareOptions(detect_style_changes=True, sensitivity_of_comparison=85)

Vzor setteru stále funguje (opts = ApplyChangeOptions(); opts.changes = changes). Neznámé kwargs vyvolají TypeError.

Nové metody s příponou overload

Byla přidána sada metod s příponou overload, aby každé .NET přetížení bylo volatelné z Pythonu pomocí explicitního, jednoznačného názvu. Příklady:

• Comparer.add_file(path), add_stream(stream), add_streams(streams), add_string(text)
• Comparer.apply_changes_file(path, options), apply_changes_stream(stream, options), …
• Comparer.compare_file(...), compare_stream(...), compare_streams(...), compare_string(...), compare_compare_options(...), compare_save_options(...)
• Comparer.compare_directory_file(...), compare_directory_string(...)
• Comparer.get_changes_change_type(...), get_changes_get_change_options(...)
• License.set_license_file(...), set_license_stream(...), set_license_streams(...), set_license_string(...)
• Metered.set_metered_key_file(...), set_metered_key_string(...)
• Document.generate_preview_preview_options(...)
• localization.SupportedLocales.is_locale_supported_culture_info(...), is_locale_supported_file(...), is_locale_supported_string(...)

Explicitní Comparer.dispose()

K dispozici pro volající, kteří upřednostňují nepoužívat idiom kontextového manažera with. Doporučený vzor zůstává:

with Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    comparer.compare("result.docx")

Velikost písmen u výčtů

Všechny výčty používají konvenci VELKÝCH PÍSMEN v Pythonu. Běžné výčty:

from groupdocs.comparison.result import ComparisonAction, FileType
from groupdocs.comparison.options import (
    ChangeType, ComparisonDisplayMode, DetalisationLevel,
    FolderComparisonExtension, ImagesInheritance, MetadataType,
    PaperSize, PasswordSaveOption, PreviewFormats, PreviewResolution,
)
from groupdocs.comparison.words.revision import RevisionAction

ComparisonAction.ACCEPT, ComparisonAction.REJECT, ComparisonAction.NONE
RevisionAction.ACCEPT, RevisionAction.REJECT, RevisionAction.NONE
PreviewFormats.PNG, PreviewFormats.JPG
MetadataType.SOURCE, MetadataType.TARGET, MetadataType.FILE_AUTHOR
PasswordSaveOption.USER, PasswordSaveOption.SOURCE, PasswordSaveOption.TARGET

Pokud jste používali dokumentaci verze 25.12, kde byly hodnoty ve stylu .Accept/.Reject, aktualizujte je na verzi s velkými písmeny.

Příklad kódu

Níže je minimální příklad, který ukazuje import nově viditelných tříd na nejvyšší úrovni a provedení jednoduchého porovnání:

from groupdocs.comparison import Comparer
from groupdocs.comparison.options import CompareOptions

options = CompareOptions(detect_style_changes=True)

with Comparer("source.docx") as comparer:
    comparer.add("target.docx")
    comparer.compare(options)
    for change in comparer.get_changes():
        print(f"Change type: {change.change_type}, Box: {change.box}")

Jak získat aktualizaci

PyPI

pip install groupdocs-comparison-net==26.5.0

Wheel je publikován na veřejném PyPI: https://pypi.org/project/groupdocs-comparison-net/

Přímé stažení

Žádné přímé odkazy ke stažení nejsou poskytovány; balíček získáte přes PyPI nebo na webu GroupDocs.

Zdroje

• Stránka projektu na PyPI: https://pypi.org/project/groupdocs-comparison-net/
• Dokumentace Integrace agentů a LLM: https://docs.groupdocs.com/comparison/python-net/agents-and-llm-integration/
• Repozitář příkladů: https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Python-via-.NET
• Fórum pro hlášení problémů: https://forum.groupdocs.com/c/comparison/
• Placená podpora Helpdesk: https://helpdesk.groupdocs.com/