dupeguru

dupeGuru

dupeGuru ist ein plattformübergreifendes (Linux, OS X, Windows) GUI-Tool zum Auffinden doppelter Dateien in einem System. Es ist größtenteils in Python 3 geschrieben und verwendet qt für die Benutzeroberfläche.

Aktueller Stand

Ich bin immer noch auf der Suche nach zusätzlicher Hilfe, insbesondere in Bezug auf:

• OSX-Wartung: Reproduzieren von Fehlern, Paketüberprüfung.
• Linux-Wartung: Reproduzieren von Fehlern, Pflege des PPA-Repositorys, des Debian-Pakets, des RPM-Pakets.
• Übersetzungen: Aktualisierung fehlender Zeichenfolgen, Transifex-Projekt unter https://www.transifex.com/voltaicideas/dupeguru-1
• Dokumentation: auf dem neuesten Stand halten.

Inhalt dieses Ordners

Dieser Ordner enthält die Quelle für dupeGuru. Die Dokumentation befindet sich in help , ist aber auch in erstellter Form online verfügbar. So ist dieser Quellbaum organisiert:

• core: Enthält den Kernlogikcode für dupeGuru. Es ist Python-Code.
• qt: UI-Code für das Qt-Toolkit. Es ist in Python geschrieben und verwendet PyQt.
• Bilder: Bilder, die von den verschiedenen UI-Codebasen verwendet werden.
• pkg: Skelettdateien, die zum Erstellen verschiedener Pakete erforderlich sind
• Hilfe: Hilfedokument, geschrieben für Sphinx.
• locale: .po-Dateien zur Lokalisierung.
• hscommon: Eine Sammlung von Helfern, die in allen HS-Anwendungen verwendet werden.

So erstellen Sie dupeGuru aus dem Quellcode

Windows- und macOS-spezifische zusätzliche Anweisungen

Anweisungen zu Windows finden Sie in den Windows-Anweisungen.

Anweisungen für macOS (qt-Version) finden Sie in den macOS-Anweisungen.

Voraussetzungen

• Python 3.7+
• PyQt5

System-Setup

Bei der Ausführung in einer Linux-basierten Umgebung sind zum Erstellen die folgenden Systempakete oder Äquivalente erforderlich:

• python3-pyqt5
• pyqt5-dev-tools (auf einigen Systemen, siehe Hinweis)
• python3-venv (nur bei Verwendung einer virtuellen Umgebung)
• python3-dev
• Build-essentiell

Hinweis: Auf einigen Linux-Systemen wird pyrcc5 bei der Installation von python3-pyqt5 nicht in den Pfad eingefügt. Dies führt zu Problemen mit den Ressourcendateien (und Symbolen). Diese Systeme sollten über ein entsprechendes pyqt5-dev-tools-Paket verfügen, das ebenfalls installiert werden sollte. Das Vorhandensein von pyrcc5 kann mit which pyrcc5 überprüft werden. Debian-basierte Systeme benötigen das zusätzliche Paket, Arch jedoch nicht.

Zum Erstellen von Paketen wird außerdem Folgendes benötigt:

• Python3-Setuptools
• Debhelper

Bauen mit Make

dupeGuru wird mit einem Makefile geliefert, mit dem Folgendes erstellt und ausgeführt werden kann:

 $ make && make run

Bauen ohne 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

Generieren eines Debian/Ubuntu-Pakets

Um Pakete zu generieren, müssen die zusätzlichen Anforderungen in „requirements-extra.txt“ installiert werden. Die Schritte sind wie folgt:

 $ 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

Dies kann einzeilig gemacht werden (einmal im Verzeichnis):

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

Laufende Tests

Die komplette Testsuite wird mit Tox 1.7+ ausgeführt. Wenn Sie es systemweit installiert haben, müssen Sie nicht einmal eine virtuelle Umgebung einrichten. Wechseln Sie einfach cd in den Stammordner des Projekts und führen Sie tox aus.

Wenn Sie Tox nicht systemweit haben, installieren Sie es mit pip install tox in Ihrer virtuellen Umgebung und führen Sie dann tox aus.

Sie können auch automatisierte Tests ohne Tox durchführen. Zusätzliche Anforderungen zum Ausführen von Tests finden Sie in requirements-extra.txt . Sie können also pip install -r requirements-extra.txt in Ihrer virtuellen Umgebung und dann py.test core hscommon ausführen