NAME¶

Debcraft - Easy, fast and secure way to build Debian packages

DESCRIPTION¶

usage: debcraft <build|improve|test|release|update|shell|logs|prune> [options] [<path|pkg|srcpkg|dsc|git-url>]

Debcraft is a tool to easily build .deb packages. The 'build' argument accepts any of the following:

* path to directory with program sources including a debian/ subdirectory with

the Debian packaging instructions

* path to a .dsc file and source tarballs that can be built into a .deb

* Debian package name or source package name that apt can download

* git http(s) or ssh URL that can be downloaded and built

The command 'improve' will try to apply various improvements to the package based on tools in Debian that automate package maintenance. The command 'test' will run the Debian-specific regression test suite if the package has autopkgtest support, and drops to a shell for investigation if tests fail to pass. The command 'release' uploads a package that is ready to be released and the command 'update' tries to update the package to the latest upstream version if the package git repository layout is compatible. The command 'shell' can be used to explore the container and run various tests and build commands one-by-one, typically for debugging purposes.

The command 'logs' lists previous builds and their logs and 'prune' cleans up the build directories of all packages, and reports how much disk space Debcraft occupies before it deletes anything. These two commands are not tied to any source package and can be invoked from anywhere.

In addition to parameters below, anything passed in DEB_BUILD_OPTIONS will also be honored. Successful builds include running './debian/rules clean' to clean up artifacts, while failed builds will leave them around for inspection.