# debreate **Repository Path**: zhangyongwei11/debreate ## Basic Information - **Project Name**: debreate - **Description**: debian package utils - **Primary Language**: Python - **License**: GPL-3.0 - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 1 - **Forks**: 0 - **Created**: 2021-11-09 - **Last Updated**: 2023-07-31 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README ![][icon] ## Debreate - Debian Package Builder ### Table of Contents * [Description](#description) * [Dependencies](#dependencies) * [Installation](#installation) * [Standalone Use](#standalone-use) * [Links](#links) * [Other Pages](#other-pages) ### [Description](#table-of-contents) Debreate is a utility to aid in creating [Debian (.deb)][wiki.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][pkg.dh-make] & debuild (available in [devscripts][pkg.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][launchpad] [Personal Package Archive (PPA)][wiki.ppa]. The latter from which [Debreate has recently become available][ppa.debreate]. 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](#table-of-contents) Debreate needs these packages installed to run: * [python][pkg.python] (version 2.7 is supported) * The goal is to eventually port to Python 3. * Currently, wxPython only supports up to version 2.7. * [python-wxgtk3][pkg.python-wxgtk3] or [python-wxgtk2.8][pkg.python-wxgtk2.8] (wxPython) * [python-wxversion][pkg.python-wxversion] * [dpkg][pkg.dpkg] * If you are running a Debian/Ubuntu based system, then this is most likely already installed. * [fakeroot][pkg.fakeroot] * [coreutils][pkg.coreutils] These packages are recommended & enable some features: * [lintian][pkg.lintian] If the package [gvfs-bin][pkg.gvfs-bin] is installed, there will be an option to use custom save/open dialogs. But, this is not recommended as these dialogs are currently very buggy. It is possible the option will be removed completely in future releases. ### [Installation](#table-of-contents) #### Using make command The source uses a generic [Makefile][wiki.makefile] for "building" (because I don't know how to use [GNU Autotools][gnu-autotools] or [CMake][cmake] very well yet). The source is not actually built, but the Makefile simply installs the scripts onto the system. Just open a terminal in the extracted root directory & execute ***make install*** with [superuser privileges][wiki.superuser]. To uninstall, execute ***make uninstall***. For more information, execute ***make help***. #### Creating .deb package & using installer If you have devscripts installed, you can execute ***make deb-bin*** to build the debian package (.deb). To install the package, type ***dpkg --install ../debreate_\_all.deb*** with superuser privileges, or open in a GUI package installer such as [gdebi][pkg.gdebi]. This is the recommended method if you are not installing from a remote APT/PPA repository. ### [Standalone Use](#table-of-contents) To run without installing, open a terminal in the extracted root directory. Then launch the file named "init.py" (***./init.py*** or ***python init.py***). It should execute via mouse-click for the system's file manager as well. ### [Licensing](#table-of-contents) * [MIT](docs/LICENSE.txt) ### [Links](#table-of-contents) * [Homepage](https://antumdeluge.github.io/debreate-web) * [GitHub project page](https://github.com/AntumDeluge/debreate) * [SourceForge project page](https://sourceforge.net/projects/debreate) * [PPA][ppa.debreate] * [Development PPA][ppa.debreate-dev] ### [Other Pages](#table-of-contents) * [OpenDesktop](https://www.opendesktop.org/content/show.php?content=101776) * [alternativeTo](http://alternativeto.net/software/debreate/) [icon]: bitmaps/icon/64/logo.png [launchpad]: https://launchpad.net/ [wiki.deb]: https://en.wikipedia.org/wiki/Deb_(file_format) [wiki.makefile]: https://en.wikipedia.org/wiki/Makefile [wiki.ppa]: https://en.wikipedia.org/wiki/Personal_Package_Archive [wiki.superuser]: https://en.wikipedia.org/wiki/Superuser [ppa.debreate]: https://launchpad.net/~antumdeluge/+archive/ubuntu/debreate [ppa.debreate-dev]: https://launchpad.net/~antumdeluge/+archive/ubuntu/debreate-dev [pkg.coreutils]: http://packages.ubuntu.com/coreutils [pkg.devscripts]: http://packages.ubuntu.com/devscripts [pkg.dh-make]: http://packages.ubuntu.com/dh-make [pkg.dpkg]: http://packages.ubuntu.com/dpkg [pkg.fakeroot]: http://packages.ubuntu.com/fakeroot [pkg.gdebi]: http://packages.ubuntu.com/gdebi [pkg.gvfs-bin]: http://packages.ubuntu.com/gvfs-bin [pkg.lintian]: http://packages.ubuntu.com/lintian [pkg.python]: http://packages.ubuntu.com/python2.7 [pkg.python-wxversion]: http://packages.ubuntu.com/python-wxversion [pkg.python-wxgtk2.8]: http://packages.ubuntu.com/python-wxgtk2.8 [pkg.python-wxgtk3]: http://packages.ubuntu.com/python-wxgtk3 [ubu.wily.python-wxgtk]: http://packages.ubuntu.com/wily/python-wxgtk2.8 [cmake]: https://cmake.org/ [gnu-autotools]: https://en.wikipedia.org/wiki/GNU_Build_System