Debreate is a utility to aid in creating Debian (.deb) packages. Currently it only supports binary packaging which allows packaging of pre-compiled or scripted applications, media, artwork, etc. for personal distribution. Plans for using backends such as dh_make & debuild (available in devscripts package) for creating source packages are in the works. But source packaging can be quite different & is a must if you want to get your packages into a distribution's official repositories or a Launchpad Personal Package Archive (PPA). The latter from which Debreate has recently become available.
The definition of Debian source packages may be a little confusing (as it was for me) for those that are new to the Debian format, or perhaps packaging in general. Debian source packages are essentially no different than common tarballed source archives & they can be available in many of the popular formats such as Gzip (.tar.gz), BZip2 (.tar.bz2), XZ (tar.xz), Lzip (tar.lzip), etc. To build Debian binary packages from source code, it must first be "debianized". Debianization involves creating a directory called 'debian' within the source root folder. Files with instructions, meta data, & more are placed within to instruct Debian tools, such as debuild, on how the source must be compiled & packaged into the final .deb. This is the process that must be taken to host software on repositories such as Lauchpad's PPA system. The debianized source is uploaded, then built & packaged on-site automatically. The resulting binary package (.deb) is published to the target PPA.
Debreate needs these packages installed to run:
- python (version 2.7 is supported)
- The goal is to eventually port to Python 3.
- Currently, wxPython only supports up to version 2.7.
- The goal is to eventually port to Python 3.
- python-wxgtk3 or python-wxgtk2.8 (wxPython)
- python-wxversion
- dpkg
- If you are running a Debian/Ubuntu based system, then this is most likely already installed.
- fakeroot
- coreutils
These packages are recommended & enable some features:
Download deb file from Gemfury project page, and use gdebi to install.
A 'setup.py' script is used to generate the Makefile (this is not the same type of 'setup.py' that is used with distutils). A python interpreter must be installed to run the script. From a terminal execute ./setup.py from the source root dirctory then follow the prompts. If you want to bypass prompting & use the default settings execute ./setup.py defaults. The Makefile will be generated in the same directory.
Open a terminal in the root directory & execute make install. To create a distribution package execute make dist. To uninstall execute make uninstall. For help & more options use make help.
If you have debuild installed, you can execute make deb-bin from the command line to build the debian package (.deb).
It is recommended to build the .deb package with make deb-bin & install via the system's package manager.
To run, launch the file named "init.py":
- ./init.py or python init.py (NOTE: Python 3.x is currently not supported)