dupeguru

dupeGuru

dupeGuru é uma ferramenta GUI multiplataforma (Linux, OS X, Windows) para localizar arquivos duplicados em um sistema. Ele é escrito principalmente em Python 3 e usa qt para a IU.

Estado atual

Ainda estou procurando ajuda adicional, especialmente em relação a:

• Manutenção OSX: reprodução de bugs, verificação de empacotamento.
• Manutenção Linux: reprodução de bugs, manutenção de repositório PPA, pacote Debian, pacote rpm.
• Traduções: atualização de strings faltantes, projeto transifex em https://www.transifex.com/voltaicideas/dupeguru-1
• Documentação: mantendo-a atualizada.

Conteúdo desta pasta

Esta pasta contém a fonte do dupeGuru. Sua documentação está em help , mas também está disponível online em sua forma construída. Veja como esta árvore de origem está organizada:

• core: Contém o código lógico principal do dupeGuru. É código Python.
• qt: código UI para o kit de ferramentas Qt. Está escrito em Python e usa PyQt.
• imagens: imagens usadas pelas diferentes bases de código da IU.
• pkg: arquivos esqueleto necessários para criar pacotes diferentes
• help: Documento de ajuda, escrito para o Sphinx.
• locale: arquivos .po para localização.
• hscommon: Uma coleção de auxiliares usados ​​em aplicativos HS.

Como construir o dupeGuru a partir do código-fonte

Instruções adicionais específicas para Windows e macOS

Para obter instruções do Windows, consulte as instruções do Windows.

Para obter instruções do macOS (versão qt), consulte as instruções do macOS.

Pré-requisitos

• Python 3.7+
• PyQt5

Configuração do sistema

Ao executar em um ambiente baseado em Linux, os seguintes pacotes de sistema ou equivalentes são necessários para compilar:

• python3-pyqt5
• pyqt5-dev-tools (em alguns sistemas, consulte a nota)
• python3-venv (somente se estiver usando um ambiente virtual)
• python3-dev
• essencial para construção

Nota: Em alguns sistemas Linux, o pyrcc5 não é colocado no caminho durante a instalação do python3-pyqt5, isso causará alguns problemas com os arquivos de recursos (e ícones). Esses sistemas devem ter um respectivo pacote pyqt5-dev-tools, que também deve estar instalado. A presença de pyrcc5 pode ser verificada com which pyrcc5 . Os sistemas baseados em Debian precisam do pacote extra, e o Arch não.

Para criar pacotes também são necessários:

• ferramentas de configuração python3
• debhelper

Construindo com Make

dupeGuru vem com um makefile que pode ser usado para construir e executar:

 $ make && make run

Construindo sem Make

 $ cd <dupeGuru directory>
$ python3 -m venv --system-site-packages ./env
$ source ./env/bin/activate
$ pip install -r requirements.txt
$ python build.py
$ python run.py

Gerando pacote Debian/Ubuntu

Para gerar pacotes os requisitos extras em requisitos-extra.txt devem estar instalados, os passos são os seguintes:

 $ cd <dupeGuru directory>
$ python3 -m venv --system-site-packages ./env
$ source ./env/bin/activate
$ pip install -r requirements.txt -r requirements-extra.txt
$ python build.py --clean
$ python package.py

Isso pode ser feito em uma linha (uma vez no diretório) como:

 $ bash -c "python3 -m venv --system-site-packages env && source env/bin/activate && pip install -r requirements.txt -r requirements-extra.txt && python build.py --clean && python package.py"

Executando testes

O conjunto de testes completo é executado com Tox 1.7+. Se você o tiver instalado em todo o sistema, nem precisará configurar um virtualenv. Basta cd na pasta raiz do projeto e executar tox .

Se você não possui o Tox em todo o sistema, instale-o em seu virtualenv com pip install tox e execute tox .

Você também pode executar testes automatizados sem Tox. Requisitos extras para execução de testes estão em requirements-extra.txt . Então, você pode fazer pip install -r requirements-extra.txt dentro do seu virtualenv e depois py.test core hscommon