Debreate  0.8.0
Debian Package Creator
Debreate Documentation
logo.png

Debreate - Debian Package Builder

Table of Contents

Description

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.

Dependencies

Debreate needs these packages installed to run:

These packages are recommended & enable some features:

Installation

The source uses a generic Makefile for "building" (because I don't know how to use GNU Autotools or CMake very well). The source is not actually built, but the Makefile simply installs the scripts onto the system. The plan is to eventually switch to the CMake build system, unless a better alternative is decided upon.

Generating the Makefile

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.

Using the Makefile

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.

Standalone Use

To run, launch the file named "init.py":

Other Pages