dupeguru

dupeGuru

dupeGuru는 시스템에서 중복 파일을 찾는 크로스 플랫폼(Linux, OS X, Windows) GUI 도구입니다. 대부분 Python 3으로 작성되었으며 UI에 qt를 사용합니다.

현황

특히 다음과 관련하여 추가 도움을 찾고 있습니다.

• OSX 유지보수: 버그 재현, 패키징 검증.
• Linux 유지 관리: 버그 재현, PPA 저장소 유지, Debian 패키지, rpm 패키지.
• 번역: https://www.transifex.com/voltaicideas/dupeguru-1에서 누락된 문자열, transifex 프로젝트 업데이트
• 문서화: 최신 상태로 유지합니다.

이 폴더의 내용

이 폴더에는 dupeGuru의 소스가 포함되어 있습니다. 해당 문서는 help 에 있지만 온라인에서 빌드된 형태로 사용할 수도 있습니다. 이 소스 트리가 구성되는 방식은 다음과 같습니다.

• core: dupeGuru의 핵심 논리 코드가 포함되어 있습니다. 파이썬 코드입니다.
• qt: Qt 툴킷용 UI 코드입니다. Python으로 작성되었으며 PyQt를 사용합니다.
• 이미지: 다양한 UI 코드베이스에서 사용되는 이미지입니다.
• pkg: 다양한 패키지를 만드는 데 필요한 스켈레톤 파일
• help: Sphinx용으로 작성된 도움말 문서입니다.
• locale: 현지화를 위한 .po 파일입니다.
• hscommon: HS 애플리케이션 전반에 걸쳐 사용되는 도우미 모음입니다.

소스에서 dupeGuru를 빌드하는 방법

Windows 및 macOS 관련 추가 지침

Windows 지침은 Windows 지침을 참조하세요.

macos 지침(qt 버전)은 macOS 지침을 참조하세요.

전제 조건

• 파이썬 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
• debhelper

Make를 사용하여 빌드

dupeGuru에는 빌드 및 실행에 사용할 수 있는 makefile이 함께 제공됩니다.

 $ make && make run

제조사 없이 구축하기

 $ 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 패키지 생성

패키지를 생성하려면 요구 사항-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 수행할 수 있습니다.