dupeguru

dupeGuru

dupeGuru est un outil GUI multiplateforme (Linux, OS X, Windows) permettant de rechercher les fichiers en double dans un système. Il est écrit principalement en Python 3 et utilise qt pour l'interface utilisateur.

Statut actuel

Je suis toujours à la recherche d'une aide supplémentaire, notamment en ce qui concerne :

• Maintenance OSX : reproduction de bugs, vérification du packaging.
• Maintenance Linux : reproduction de bugs, maintenance du dépôt PPA, du paquet Debian, du paquet rpm.
• Traductions : mise à jour des chaînes manquantes, projet transifex sur https://www.transifex.com/voltaicideas/dupeguru-1
• Documentation : la maintenir à jour.

Contenu de ce dossier

Ce dossier contient la source de dupeGuru. Sa documentation est en help , mais est également disponible en ligne sous sa forme construite. Voici comment cette arborescence des sources est organisée :

• core : contient le code logique de base de dupeGuru. C'est du code Python.
• qt : code d'interface utilisateur pour la boîte à outils Qt. Il est écrit en Python et utilise PyQt.
• images : images utilisées par les différentes bases de code de l'interface utilisateur.
• pkg : fichiers squelettes requis pour créer différents packages
• help : document d'aide, écrit pour Sphinx.
• locale : fichiers .po pour la localisation.
• hscommon : une collection d'assistants utilisés dans les applications HS.

Comment construire dupeGuru à partir des sources

Instructions supplémentaires spécifiques à Windows et macOS

Pour les instructions Windows, consultez les instructions Windows.

Pour les instructions Macos (version QT), consultez les instructions macOS.

Conditions préalables

• Python3.7+
• PyQt5

Configuration du système

Lors de l'exécution dans un environnement basé sur Linux, les packages système suivants ou équivalents sont nécessaires pour la construction :

• python3-pyqt5
• pyqt5-dev-tools (sur certains systèmes, voir note)
• python3-venv (uniquement si vous utilisez un environnement virtuel)
• python3-dev
• essentiel à la construction

Remarque : sur certains systèmes Linux, pyrcc5 n'est pas mis sur le chemin lors de l'installation de python3-pyqt5, cela entraînera des problèmes avec les fichiers de ressources (et les icônes). Ces systèmes doivent avoir un package pyqt5-dev-tools respectif, qui doit également être installé. La présence de pyrcc5 peut être vérifiée avec which pyrcc5 . Les systèmes basés sur Debian ont besoin du package supplémentaire, contrairement à Arch.

Pour créer des packages, les éléments suivants sont également nécessaires :

• python3-setuptools
• Debhelper

Construire avec Make

dupeGuru est livré avec un makefile qui peut être utilisé pour construire et exécuter :

 $ make && make run

Construire sans faire

 $ 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

Génération du paquet Debian/Ubuntu

Pour générer des packages, les exigences supplémentaires dans Requirements-extra.txt doivent être installées, les étapes sont les suivantes :

 $ 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

Cela peut être réalisé en une seule ligne (une fois dans le répertoire) comme :

 $ 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"

Exécution de tests

La suite de tests complète est exécutée avec Tox 1.7+. Si vous l'avez installé sur tout le système, vous n'avez même pas besoin de configurer un virtualenv. cd simplement dans le dossier racine du projet et exécutez tox .

Si vous n'avez pas Tox à l'échelle du système, installez-le dans votre virtualenv avec pip install tox puis exécutez tox .

Vous pouvez également exécuter des tests automatisés sans Tox. Les exigences supplémentaires pour l'exécution des tests se trouvent dans requirements-extra.txt . Ainsi, vous pouvez faire pip install -r requirements-extra.txt dans votre virtualenv puis py.test core hscommon