dupeguru

カモの達人

dupeGuru は、システム内の重複ファイルを検索するためのクロスプラットフォーム (Linux、OS X、Windows) GUI ツールです。これは主に Python 3 で書かれており、UI には qt を使用します。

現在の状況

特に以下に関してさらなる支援を求めています。

• OSXのメンテナンス：バグの再現、パッケージングの検証。
• Linux のメンテナンス: バグの再現、PPA リポジトリ、Debian パッケージ、rpm パッケージのメンテナンス。
• 翻訳: 欠落している文字列の更新、transifex プロジェクト (https://www.transifex.com/voltaicideas/dupeguru-1)
• ドキュメント: 常に最新の状態に保ちます。

このフォルダの内容

このフォルダーには dupeGuru のソースが含まれています。そのドキュメントはhelpにありますが、構築された形式でオンラインでも入手できます。このソース ツリーは次のように構成されています。

• core: dupeGuru のコア ロジック コードが含まれています。 Pythonのコードです。
• qt: Qt ツールキットの UI コード。 Python で書かれており、PyQt を使用します。
• 画像: さまざまな UI コードベースで使用される画像。
• pkg: さまざまなパッケージを作成するために必要なスケルトン ファイル
• help: Sphinx 用に書かれたヘルプ ドキュメント。
• locale: ローカライズ用の .po ファイル。
• hscommon: HS アプリケーション全体で使用されるヘルパーのコレクション。

ソースから dupeGuru をビルドする方法

Windows および macOS 固有の追加手順

Windows の説明については、「Windows の説明」を参照してください。

MacOS の手順 (QT バージョン) については、「macOS の手順」を参照してください。

前提条件

• Python 3.7以降
• PyQt5

システムセットアップ

Linux ベースの環境で実行する場合は、次のシステム パッケージまたは同等のものを構築する必要があります。

• python3-pyqt5
• pyqt5-dev-tools (一部のシステムでは、注を参照)
• python3-venv (仮想環境を使用する場合のみ)
• python3-dev
• ビルド必須

注: 一部の Linux システムでは、python3-pyqt5 のインストール時に pyrcc5 がパスに配置されません。これにより、リソース ファイル (およびアイコン) で問題が発生します。これらのシステムにはそれぞれの pyqt5-dev-tools パッケージがあり、これもインストールする必要があります。 pyrcc5 の存在はwhich pyrcc5で確認できます。 Debian ベースのシステムには追加のパッケージが必要ですが、Arch には必要ありません。

パッケージを作成するには、以下も必要です。

• python3-setuptools
• デベルパー

Make を使用して構築する

dupeGuru には、ビルドと実行に使用できる Makefile が付属しています。

 $ make && make run

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

Debian/Ubuntu パッケージの生成

パッケージを生成するには、requirements-extra.txt の追加要件をインストールする必要があります。手順は次のとおりです。

 $ 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

これは、次のように (ディレクトリ内で) ワンライナーで作成できます。

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

テストの実行

完全なテスト スイートは Tox 1.7+ で実行されます。システム全体にインストールされている場合は、virtualenv をセットアップする必要さえありません。 cdルート プロジェクト フォルダーに移動し、 tox実行するだけです。

システム全体に Tox がない場合は、 pip install toxを使用して virtualenv にインストールし、 tox実行します。

Tox を使用せずに自動テストを実行することもできます。テストを実行するための追加の要件はrequirements-extra.txtにあります。したがって、virtualenv内でpip install -r requirements-extra.txt実行してから、 py.test core hscommon実行できます。