mirror of
https://github.com/arsenetar/dupeguru.git
synced 2024-11-18 04:59:03 +00:00
75 lines
3.3 KiB
Plaintext
75 lines
3.3 KiB
Plaintext
Contents
|
|
=====
|
|
|
|
This package contains the source for dupeGuru. To learns how to build it, refer to the "Build dupeGuru" section. Below is the description of the various subfolders:
|
|
|
|
- core: Contains the core logic code for dupeGuru. It's Python code written in TDD style.
|
|
- core_*: Edition-specific-cross-toolkit code written in Python.
|
|
- cocoa: UI code for the Cocoa toolkit. It's Objective-C code.
|
|
- qt: UI code for the Qt toolkit. It's written in Python and uses PyQt. Before redistributing changes in this part of the code, read the "qt/WARNING" file.
|
|
- images: Images used by the different UI codebases.
|
|
|
|
There are also other sub-folder that comes from external repositories (automatically checked out
|
|
with svn:externals):
|
|
|
|
- hscommon: A collection of helpers used across HS applications.
|
|
- hsdocgen: An ad-hoc document generation used across HS project (used for help files)
|
|
- cocoalib: A collection of helpers used across Cocoa UI codebases of HS applications.
|
|
- qtlib: A collection of helpers used across Qt UI codebases of HS applications.
|
|
|
|
dupeGuru Dependencies
|
|
=====
|
|
|
|
Before being able to build dupeGuru, a few dependencies have to be installed:
|
|
|
|
General dependencies
|
|
-----
|
|
|
|
- Python 3.1 (http://www.python.org)
|
|
- Send2Trash3k (http://hg.hardcoded.net/send2trash3k)
|
|
- hsutil3k (http://hg.hardcoded.net/hsutil3k)
|
|
- hsaudiotag3k (for ME) (http://hg.hardcoded.net/hsaudiotag3k)
|
|
- lxml, to read and write XML files. (http://codespeak.net/lxml/)
|
|
- Markdown, to generate help files. (http://pypi.python.org/pypi/Markdown)
|
|
- PyYaml, for help files and the build system. (http://pyyaml.org/)
|
|
- py.test, to run unit tests. (http://codespeak.net/py/dist/test/)
|
|
|
|
OS X prerequisites
|
|
-----
|
|
|
|
- XCode 3.1 (http://developer.apple.com/TOOLS/xcode/)
|
|
- Sparkle (http://sparkle.andymatuschak.org/)
|
|
- PyObjC 2.3. (http://pyobjc.sourceforge.net/)
|
|
- py2app 0.5.4 (http://svn.pythonmac.org/py2app/py2app/trunk/doc/index.html)
|
|
|
|
Windows prerequisites
|
|
---
|
|
|
|
- Visual Studio 2008 (Express is enough) is needed to build C extensions. (http://www.microsoft.com/Express/)
|
|
- PyQt 4.7 (http://www.riverbankcomputing.co.uk/news)
|
|
- Python Imaging Library for dupeGuru PE. (http://www.pythonware.com/products/pil/)
|
|
- cx_Freeze, if you want to build a exe. You don't need it if you just want to run dupeGuru. (http://cx-freeze.sourceforge.net/)
|
|
- Advanced Installer, if you want to build the installer file. (http://www.advancedinstaller.com/)
|
|
|
|
Building dupeGuru
|
|
=====
|
|
|
|
First, make sure you meet the dependencies listed in the section above. Then you need to configure your build with:
|
|
|
|
python configure.py
|
|
|
|
If you want, you can specify a UI to use with the `--ui` option. So, if you want to build dupeGuru with Qt on OS X, then you have to type `python configure.py --ui=qt`. You can also use the `--dev` flag to indicate a dev build (it will build `dg_cocoa.plugin` in alias mode and use the "dev" config in XCode).
|
|
|
|
Then, just build the thing and then run it with:
|
|
|
|
python build.py
|
|
python run.py
|
|
|
|
If you want to create ready-to-upload package, run:
|
|
|
|
python package.py
|
|
|
|
64-bit on OS X
|
|
---
|
|
|
|
The "release" configuration of dupeGuru's XCode project build with archs "i386 x86_64 ppc". However there are currently problems with py2app and 64 bit. If you want to correctly build 64-bit apps, refer to http://www.hardcoded.net/articles/building-64-bit-pyobjc-applications-with-py2app.htm . |