Instalação

O pacote é disponível em PyPI e pode ser instalado via pip executando o seguinte comando:

pip install groupdocs-comparison-cloud

Requisitos

• Python 2.7 ou 3.4+
• pip gerenciador de pacotes
• GroupDocs Credenciais Cloud — Client ID and Client Secret do Dashboard

Dependências

O SDK instala automaticamente os seguintes pacotes:

Comparação e revisão de documentos Python Cloud REST API

GroupDocs.Comparison Cloud SDK para Python é uma nuvem poderosa REST API projetada para desenvolvedores integrarem funcionalidade de comparação de documentos em aplicativos da web, scripts e fluxos de trabalho de automação Python. Suportando mais de 90 formatos de arquivo, este API permite comparar pastas inteiras, aceitar ou rejeitar revisões de documentos e visualizar alterações com visualizações de páginas. Com recursos como controle granular de alterações, personalização de estilo e suporte a vários documentos, os desenvolvedores podem automatizar com eficiência comparações de arquivos em massa. Recursos adicionais incluem comparação de documentos protegidos por senha, fusão de arquivos de código-fonte e extração de coordenadas detalhadas de alterações. Esta ferramenta é ideal para ambientes colaborativos, revisão de documentos legais e sistemas de controle de versão.

Comparação de pastas e documentos

Compare pastas inteiras - Compare o conteúdo de diretórios inteiros com detecção automática de diferenças.
Filtrar itens alterados - Salve os resultados nos formatos TXT ou HTML e exiba apenas os itens alterados.
Comparação de arquivos em massa - Automatize comparações de arquivos em massa com eficiência em aplicativos Python.

Controle de revisão de documentos

Aceite ou rejeite revisões em DOCX - Aceite ou rejeite programaticamente revisões em arquivos Word DOCX.
Extrair lista de revisões - Recupere todas as revisões, aplique as alterações desejadas e rejeite outras.
Gerenciamento de versões – Habilite controle completo sobre edição de documentos e gerenciamento de versões.

Geração de visualização da página do documento

Gerar visualizações de páginas - Crie imagens de visualização de alta qualidade antes de salvar os resultados da comparação.
Formatos de visualização personalizados - Especifique formatos (PNG, JPG, BMP) e selecione dimensões personalizadas.
Fluxos de trabalho de revisão visual – Integre visualizações de documentos em aplicativos que exigem gerenciamento visual de conteúdo.

Gerenciamento e revisão de mudanças

Aceite ou rejeite alterações detectadas - Controle as alterações nos documentos com precisão granular.
Mostrar revisões e controlar alterações - Destaque as diferenças usando as alterações de controle no estilo Word.
Definir autor das alterações - Atribua autoria às alterações detectadas para maior responsabilidade.

Personalização e Flexibilidade

Personalize estilos de alteração - Controle fontes, cores e estilos de texto (negrito, itálico, tachado).
Ajuste a sensibilidade de comparação - Equilibre velocidade e precisão com configurações de sensibilidade de 0 a 100.

Suporte para vários documentos

Compare vários documentos - Compare mais de dois documentos simultaneamente.
Documentos protegidos por senha - Compare arquivos de origem e de destino protegidos por senha.
Mesclar arquivos de código-fonte - Compare e mescle diversas versões de arquivos de código-fonte com controle de alterações.

Análise detalhada de mudanças

Obter coordenadas de alterações - Recupere a localização exata das alterações nos documentos.
Obter lista de alterações - Receba uma lista detalhada incluindo tipo de alteração, número de página e texto afetado.
Extraia texto de origem e destino - Extraia o texto original e modificado para cada alteração detectada.

Salvamento e controle de metadados

Defina metadados do documento ao salvar - Controle autor, título ou organização nos documentos de saída.
Definir senha para documento de saída - Aplique proteção por senha aos documentos resultantes.

Licenciamento e Autenticação

Modo de avaliação - Experimente o API com uma conta de teste gratuita.
Autenticação segura – Use o ID do cliente e o segredo do cliente para acesso seguro ao API.
Licença MIT - O Python SDK é licenciado sob MIT License.

Formatos de documentos suportados

GroupDocs.Comparison Cloud suporta mais de 90 formatos de arquivo com recursos de comparação e detecção automática:

• Processamento de texto: DOC, DOCM, DOCX, DOT, DOTM, DOTX, ODT, OTT, RTF
• Planilhas: XLS, XLT, XLSX, XLTM, XLSB, XLSM, ODS, CSV
• Apresentações: POT, POTX, PPS, PPSX, PPTX, PPT, ODP, OTP
• Diagramas: VSDX, VSD, VSS, VST, VDX
• Notas: UM (Microsoft OneNote)
• PDF e layout de página: PDF, MOBI, DJVU
• Imagens: BMP, GIF, JPG/JPEG, PNG, DCM, DWG, DXF
• E-mail: EML, EMLX, MSG
• Web: HTML, MHT, MHTML
• Código Fonte: CS, JAVA, CPP, JS, PY, RB As operações suportadas variam de acordo com o formato. Para a matriz de formato completa, consulte documentation.

Início rápido

Obtenha suas credenciais API

Para usar GroupDocs.Comparison Cloud, cadastre-se em GroupDocs.Cloud Dashboard e obtenha seu ID do cliente e Segredo do cliente.

Inicialize o API

Use o código a seguir para começar a usar GroupDocs.Comparison Cloud SDK para 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)

Compare dois documentos

Depois de inicializado, use este exemplo básico para comparar documentos do Word e salvar o resultado:

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)

Com este guia de início rápido, você está pronto para começar a comparar documentos usando GroupDocs.Comparison Cloud em seus aplicativos Python. Para mais detalhes, visite documentation.

Obtenha formatos de arquivo suportados

Recupere a lista completa de formatos de arquivo suportados disponíveis através do Comparador 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)))

Comparar documentos PDF

Compare dois documentos PDF e salve o resultado com as alterações controladas destacadas.

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)

Compare documentos protegidos por senha

Compare dois documentos do Word protegidos por senha, fornecendo credenciais para cada arquivo.

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)

Obtenha lista de alterações

Recupere uma lista detalhada de todas as alterações detectadas entre os documentos de origem e de destino.

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

Aceitar ou rejeitar alterações

Aceite ou rejeite alterações individuais após comparar documentos e salve o resultado atualizado.

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)

Compare vários documentos com opções

Compare um documento de origem com vários destinos e personalize a aparência dos itens inseridos.

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)

Aplicar revisões em documentos DOCX

Aceite ou rejeite revisões controladas em um documento do Word programaticamente.

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)

Exemplos de projetos em GitHub

O repositório GroupDocs.Comparison Cloud Python Samples inclui exemplos prontos para execução que abrangem:

Como executar os exemplos

1. Clone ou baixe o samples repository
2. Edite Examples/RunExamples.py e defina seu client_id e client_secret
3. Vá para o diretório Examples
4. Execute pip install groupdocs-comparison-cloud -U
5. Execute python RunExamples.py Para mais detalhes, visite Getting Started.

Tags

Document Comparison API | Python Cloud API | GroupDocs.Comparison Cloud | REST API | Document Comparison | Folder Comparison | Revision Control | Track Changes | Preview Generation | Multi-format Support | Password Protected Documents | Source Code Comparison | Change Tracking | Customization | Document Merging | Change Coordinates | Metadata Extraction | Document Security | Document Review | Secure API Access | Cloud Storage Integration | Cross-platform API