Установка

Пакет доступен в PyPI, и его можно установить через pip, выполнив следующую команду:

pip install groupdocs-comparison-cloud

Требования

• Python 2.7 или 3.4+
• менеджер пакетов pip
• Учетные данные GroupDocs Cloud — Client ID и Client Secret из панели управления

Зависимости

SDK автоматически устанавливает следующие пакеты:

Сравнение и пересмотр документов Python Cloud REST API

GroupDocs.Comparison Cloud SDK для Python — это мощный облачный REST API, предназначенный для разработчиков для интеграции функций сравнения документов в веб-приложения, сценарии и рабочие процессы автоматизации Python. Поддерживая более 90 форматов файлов, этот API позволяет сравнивать целые папки, принимать или отклонять версии документов, а также визуализировать изменения с помощью предварительного просмотра страниц. Благодаря таким функциям, как детальный контроль изменений, настройка стиля и поддержка нескольких документов, разработчики могут эффективно автоматизировать массовое сравнение файлов. Дополнительные функции включают сравнение документов, защищенных паролем, объединение файлов исходного кода и извлечение подробных координат изменений. Этот инструмент идеально подходит для сред совместной работы, проверки юридических документов и систем контроля версий.

Сравнение папок и документов

Сравнить папки целиком - Сравнивайте содержимое целых каталогов с автоматическим обнаружением различий.
Фильтровать измененные элементы - Сохраняйте результаты в форматах TXT или HTML и отображайте только измененные элементы.
Массовое сравнение файлов - Эффективно автоматизируйте массовое сравнение файлов в приложениях Python.

Контроль версий документов

Принять или отклонить изменения в формате DOCX - Программно принимать или отклонять изменения в файлах Word DOCX.
Извлечь список изменений - Получите все версии, примените нужные изменения и отклоните другие.
Управление версиями - Обеспечьте полный контроль над редактированием документов и управлением версиями.

Создание предварительного просмотра страницы документа

Создание предварительного просмотра страниц - Создавайте высококачественные изображения для предварительного просмотра перед сохранением результатов сравнения.
Пользовательские форматы предварительного просмотра - Укажите форматы (PNG, JPG, BMP) и выберите специальные размеры.
Рабочие процессы визуальной проверки - Интегрируйте предварительный просмотр документов в приложения, требующие визуального управления контентом.

Управление изменениями и обзор

Принять или отклонить обнаруженные изменения - Контролируйте изменения документов с высокой точностью.
Показывать версии и отслеживать изменения - Выделите различия, используя отслеживание изменений в стиле Word.
Установить автора изменений - Присвойте авторство обнаруженным изменениям для повышения ответственности.

Кастомизация и гибкость

Настройка стилей изменения - Управляйте шрифтами, цветами и стилями текста (жирный, курсив, зачеркивание).
Настройте чувствительность сравнения - Балансируйте скорость и точность с настройками чувствительности от 0 до 100.

Поддержка нескольких документов

Сравнить несколько документов - Сравнивайте более двух документов одновременно.
Документы, защищенные паролем - Сравните исходные и целевые файлы, защищенные паролем.
Объединить файлы исходного кода - Сравнивайте и объединяйте несколько версий файлов исходного кода с контролем изменений.

Подробный анализ изменений

Получить координаты изменений - Получите точное местоположение изменений в документах.
Получить список изменений - Получите подробный список, включающий тип изменения, номер страницы и затронутый текст.
Извлечение исходного и целевого текста - Извлекайте исходный и измененный текст для каждого обнаруженного изменения.

Сохранение и контроль метаданных

Устанавливать метаданные документа при сохранении - Управляйте автором, названием или организацией в выходных документах.
Установить пароль для выходного документа - Примените защиту паролем к полученным документам.

Лицензирование и аутентификация

Режим оценки - Попробуйте API с помощью бесплатной пробной учетной записи.
Безопасная аутентификация - Используйте идентификатор клиента и секрет клиента для безопасного доступа к API.
Лицензия MIT - Python SDK лицензируется по Лицензии MIT.

Поддерживаемые форматы документов

GroupDocs.Comparison Cloud поддерживает более 90 форматов файлов с возможностями сравнения и автоматического определения:

• Обработка текста: DOC, DOCM, DOCX, DOT, DOTM, DOTX, ODT, OTT, RTF
• Таблицы: XLS, XLT, XLSX, XLTM, XLSB, XLSM, ODS, CSV
• Презентации: POT, POTX, PPS, PPSX, PPTX, PPT, ODP, OTP
• Диаграммы: VSDX, VSD, VSS, VST, VDX
• Примечания: ONE (Microsoft OneNote)
• PDF и макет страницы: PDF, MOBI, DJVU
• Изображения: BMP, GIF, JPG/JPEG, PNG, DCM, DWG, DXF
• Электронная почта: EML, EMLX, MSG
• Интернет: HTML, MHT, MHTML
• Исходный код: CS, JAVA, CPP, JS, PY, RB

Поддерживаемые операции зависят от формата. Полную матрицу форматов см. в документации.

Быстрый старт

Получите учетные данные API

Чтобы использовать GroupDocs.Comparison Cloud, зарегистрируйтесь на GroupDocs.Cloud Dashboard и получите свой Идентификатор клиента и Секрет клиента.

Инициализируйте API

Используйте следующий код, чтобы начать использовать Cloud SDK GroupDocs.Comparison для Python:

import groupdocs_comparison_cloud

# Get your ClientId and ClientSecret at https://dashboard.groupdocs.cloud
client_id = "YourClientId"
client_secret = "YourClientSecret"

# Create API configuration
configuration = groupdocs_comparison_cloud.Configuration(client_id, client_secret)
configuration.api_base_url = "https://api.groupdocs.cloud"

# Create instance of the Compare API
compare_api = groupdocs_comparison_cloud.CompareApi.from_config(configuration)

Сравните два документа

После инициализации используйте этот базовый пример для сравнения документов Word и сохранения результата:

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Благодаря этому краткому руководству вы можете начать сравнивать документы с помощью GroupDocs.Comparison Cloud в своих приложениях Python. Для получения более подробной информации посетите документацию.

Получить поддерживаемые форматы файлов

Получите полный список поддерживаемых форматов файлов, доступных через API сравнения.

import groupdocs_comparison_cloud

info_api = groupdocs_comparison_cloud.InfoApi.from_keys("YourClientId", "YourClientSecret")

result = info_api.get_supported_file_formats()

print("Formats count: " + str(len(result.formats)))

Сравнить PDF-документы

Сравните два PDF-документа и сохраните результат с выделенными отслеживаемыми изменениями.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/pdf/source.pdf"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/pdf/target.pdf"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.pdf"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Сравнение документов, защищенных паролем

Сравните два документа Word, защищенных паролем, указав учетные данные для каждого файла.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source_protected.docx"
source.password = "1231"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target_protected.docx"
target.password = "5784"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Получить список изменений

Получите подробный список всех изменений, обнаруженных между исходным и целевым документами.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

changes = compare_api.post_changes(groupdocs_comparison_cloud.PostChangesRequest(options))

print("Changes count: " + str(len(changes)))

Принять или отклонить изменения

Примите или отклоните отдельные изменения после сравнения документов и сохраните обновленный результат.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
options = groupdocs_comparison_cloud.UpdatesOptions()
options.source_file = source
options.target_files = [target]
options.output_path = "output/result.docx"

changes = compare_api.post_changes(groupdocs_comparison_cloud.PostChangesRequest(options))

for change in changes:
    change.comparison_action = "Reject"
changes[0].comparison_action = "Accept"

options.changes = changes

response = compare_api.put_changes_document(groupdocs_comparison_cloud.PutChangesDocumentRequest(options))

print("Output file link: " + response.href)

Сравните несколько документов с параметрами

Сравните исходный документ с несколькими целевыми и настройте внешний вид вставленных элементов.

import groupdocs_comparison_cloud

compare_api = groupdocs_comparison_cloud.CompareApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source.docx"
target = groupdocs_comparison_cloud.FileInfo()
target.file_path = "target_files/word/target.docx"
target1 = groupdocs_comparison_cloud.FileInfo()
target1.file_path = "target_files/word/target_1.docx"
target2 = groupdocs_comparison_cloud.FileInfo()
target2.file_path = "target_files/word/target_2.docx"
options = groupdocs_comparison_cloud.ComparisonOptions()
options.source_file = source
options.target_files = [target, target1, target2]
options.output_path = "output/result.docx"
settings = groupdocs_comparison_cloud.Settings()
settings.inserted_items_style = groupdocs_comparison_cloud.ItemsStyle()
settings.inserted_items_style.font_color = "16711680"
options.settings = settings

response = compare_api.comparisons(groupdocs_comparison_cloud.ComparisonsRequest(options))

print("Output file link: " + response.href)

Применить изменения в документах DOCX

Принимайте или отклоняйте отслеживаемые изменения в документе Word программным способом.

import groupdocs_comparison_cloud

review_api = groupdocs_comparison_cloud.ReviewApi.from_keys("YourClientId", "YourClientSecret")

source = groupdocs_comparison_cloud.FileInfo()
source.file_path = "source_files/word/source_with_revs.docx"
options = groupdocs_comparison_cloud.ApplyRevisionsOptions()
options.source_file = source
options.output_path = "output/result.docx"

revisions = review_api.get_revisions(groupdocs_comparison_cloud.GetRevisionsRequest(source))

for revision in revisions:
    revision.action = "Accept"

options.revisions = revisions

response = review_api.apply_revisions(groupdocs_comparison_cloud.ApplyRevisionsRequest(options))

print("Output file link: " + response.href)

Примеры проектов на GitHub

Репозиторий GroupDocs.Comparison Cloud Python Samples включает готовые к использованию примеры, охватывающие:

Как запустить примеры

1. Клонируйте или загрузите репозиторий образцов.
2. Отредактируйте «Examples/RunExamples.py» и установите «client_id» и «client_secret».
3. Перейдите в каталог «Примеры».
4. Запустите pip install groupdocs-comparison-cloud -U
5. Выполните python RunExamples.py

Для получения более подробной информации посетите Начало работы.

Теги

Document Comparison API | Python Cloud API | GroupDocs.Comparison Cloud | REST API | Сравнение документов | Сравнение папок | Контроль версий | Отслеживать изменения | Предварительный просмотр | Поддержка нескольких форматов | Документы, защищенные паролем | Сравнение исходного кода | Отслеживание изменений | Кастомизация | Объединение документов | Изменить координаты | Извлечение метаданных | Безопасность документа | Просмотр документа | Безопасный доступ к API | Интеграция облачного хранилища | Кроссплатформенный API