Suite to help with maintaining [Debian](http://www.debian.org) packages in [Git](http://git-scm.com) repositories. [[!toc]] [[!template id=project_logo img="gbp.png"]] ## Tools GBP ships the following tools: * *gbp buildpackage*: build a package out of a git repository, check for local modifications and tag appropriately * *gbp import-{dsc,dscs}*: import existing Debian source packages into a git repository * *gbp import-orig*: import a new upstream version into the git repository * *gbp export-orig*: export an upstream tarball from the git repository * *gbp dch*: generate Debian changelog entries from Git commit messages * *gbp pq*: maintain *debian/patches* on a patch queue branch * *gbp clone*: clone a remote repository and make it ready for *gbp buildpackage* * *gbp pull*: pull from a remote repository and update the necessary branches * *gbp create-remote-repo*: mirror your git repository to a remote side * *gbp config*: print configuration values * *gbp push*: push content to remote repositories * *gbp tag*: tag a Debian package in git * *gbp pristine-tar*: create pristine-tar commits There's also some support for maintaining RPMs in (*gbp buildpackage-rpm*, *gbp import-srpm*, *gbp pq-rpm*, *gbp rpm-ch*). and helpers in */usr/share/doc/git-buildpackage/examples/*: * *gbp-add-patch*: Commits a patch to the current branch and uses the patch header for the commit message, useful after *gbp pq export*. ## Documentation * git-buildpackage's [official manual](https://gbp.sigxcpu.org/manual). * A possible workflow for maintaining [[development/debian packages in git]]. * The current [api documentation](https://gbp.sigxcpu.org/apidocs) in case you want to extend git-buildpackage. The usage of the *GitRepository* class is shown (and tested) in [test_GitRepository](https://honk.sigxcpu.org/projects/git-buildpackage/apidocs/doctests.test_GitRepository.html). ## Download [[!template id=honk_git repo="git-buildpackage"]] There's also a clone on [github](https://github.com/agx/git-buildpackage). ### Debian packages Debian packages of git-buildpackage can be downloaded from the [[!debpkg git-buildpackage desc="Debian Archive"]]. ### Pypi If not on a Debian system you can fetch the package from [pypi](https://pypi.python.org/pypi/gbp): pip install gbp ## Bugreports For enhancements and feature requests you can either use the [Debian bugtracking system](https://bugs.debian.org/git-buildpackage) or email [me](mailto:agx@sigxcpu.org) directly. [[!template id=honk_ml project="git-buildpackage"]] If you encounter a security issue please report it via the above channels. ## gbp.conf Here's my current [[gbp.conf]]. ## Related Tools * [Git-pbuilder][0] by Russ Allbery is included in gbp but a newer version might be available. * [Chef Cookbook for gbp][1] * [git-buildpackage-rpm][2] by Markus Lehtonen. A fork of gbp adding RPM support. Large parts have been merged into *gbp*. ## Todo * templating for gbp dch ([[!debbug 536719]]. [[!debbug 529332]]) * translate the manual * [[!debbug git-buildpackage desc="bugs"]] filed in the Debian bugtracking system ## Author *git-buildpackage* was written by [[Guido Günther|/agx]] with contributions from many individuals. See the [changelog](https://git.sigxcpu.org/cgit/git-buildpackage/tree/debian/changelog) for attributions. ## License git-buildpackage is free software and licensed under the GPL Version 2. [0]: http://www.eyrie.org/~eagle/software/scripts/git-pbuilder.html [1]: https://github.com/mlafeldt/gbp-cookbook [2]: https://github.com/marquiz/git-buildpackage-rpm