ratt (“Rebuild All The Things!”) operates on a Debian .changes file of a just-built package, identifies all reverse-build-dependencies and rebuilds them with the .debs from the .changes file.
The intended use-case is, for example, to package a new snapshot of a Go library and verify that the new version does not break any other Go libraries/binaries.
Please install ratt from Debian. In case you want to hack on ratt, you can use the following commands to install Go, download ratt from git and compile/install it:
sudo apt-get install golang-go
git clone https://github.com/Debian/ratt
cd ratt
go installStart the resulting binary in ~/go/bin/ratt:
~/go/bin/ratt -helpAfter making changes to the code, to recompile and install it again, use:
go installLet’s assume you build a new version of a Go library, like so:
debcheckout golang-github-jacobsa-gcloud-dev
cd golang-github-jacobsa-gcloud-dev
dch -i -m 'dummy new version'
git commit -a -m 'dummy new version'
gbp buildpackage --git-pbuilder Now you can use ratt to identify and rebuild all reverse-build-dependencies:
$ ratt golang-github-jacobsa-gcloud_0.0\~git20150709-2_amd64.changes
2015/08/16 11:48:41 Loading changes file "golang-github-jacobsa-gcloud_0.0~git20150709-2_amd64.changes"
2015/08/16 11:48:41 - 1 binary packages: golang-github-jacobsa-gcloud-dev
2015/08/16 11:48:41 - corresponding .debs (will be injected when building):
2015/08/16 11:48:41 golang-github-jacobsa-gcloud-dev_0.0~git20150709-2_all.deb
2015/08/16 11:48:41 Loading sources index "/var/lib/apt/lists/ftp.ch.debian.org_debian_dists_sid_contrib_source_Sources"
2015/08/16 11:48:41 Loading sources index "/var/lib/apt/lists/ftp.ch.debian.org_debian_dists_sid_main_source_Sources"
2015/08/16 11:48:43 Loading sources index "/var/lib/apt/lists/ftp.ch.debian.org_debian_dists_sid_non-free_source_Sources"
2015/08/16 11:48:43 Building golang-github-jacobsa-ratelimit_0.0~git20150723.0.2ca5e0c-1 (commandline: [sbuild --arch-all --dist=sid --nolog golang-github-jacobsa-ratelimit_0.0~git20150723.0.2ca5e0c-1 --extra-package=golang-github-jacobsa-gcloud-dev_0.0~git20150709-2_all.deb])
2015/08/16 11:49:19 Build results:
2015/08/16 11:49:19 PASSED: golang-github-jacobsa-ratelimit_0.0~git20150723.0.2ca5e0c-1
ratt uses sbuild(1) to build packages, see https://wiki.debian.org/sbuild for instructions on how to set up sbuild. Be sure to add --components=main,contrib,non-free to the sbuild-createchroot line in case you want to deal with packages outside of main as well.
Imagine you’re running Debian stable on your machine, but you’re working on a package for Debian unstable (“sid”). Unless you already have configured a corresponding sources.list entry for sid, you will encounter an error message like this:
$ ratt golang-google-grpc_1.11.0-1_amd64.changes
2019/01/19 10:44:34 Loading changes file "golang-google-grpc_1.11.0-1_amd64.changes"
2019/01/19 10:44:34 - 1 binary packages: golang-google-grpc-dev
2019/01/19 10:44:34 Corresponding .debs (will be injected when building):
2019/01/19 10:44:34 golang-google-grpc-dev_1.11.0-1_all.deb
2019/01/19 10:44:34 Setting -dist=sid (from .changes file)
2019/01/19 10:44:34 Could not find InRelease file for sid . Are you missing sid in your /etc/apt/sources.list?
The most direct solution is to add sid to your /etc/apt/sources.list file, then set Default-Release to stable, so that apt prefers the same packages as before your addition:
# echo 'deb http://deb.debian.org/debian sid main' >> /etc/apt/sources.list
# echo 'deb-src http://deb.debian.org/debian sid main' >> /etc/apt/sources.list
# echo 'APT::Default-Release "stable";' >> /etc/apt/apt.conf
# apt update
$ ratt ...
An alternative solution is to use chdist(1), a tool that allows to create and maintain different apt trees for different suites. Assuming that you have a sid distribution ready in your ~/.chdist, you can then use it by setting the environment variable APT_CONFIG:
APT_CONFIG=~/.chdist/sid/etc/apt/apt.conf ratt ...
In some cases there are many build dependencies; to focus on a smaller set of packages, invoke ratt with the -include / -exclude options.
To only build selected packages, use:
ratt -recheck -include '^(hwloc|fltk1.3|wcslib|ccfits|qevercloud|libstxxl|caffe|frobby|starpu)$' ../doxygen_1.8.17-1_amd64.changes
To exclude certain packages (for example those with longer build times):
ratt -recheck -exclude '^(gcc-9|gcc-8|llvm-toolchain-10|libreoffice|trilinos|llvm-toolchain-9|llvm-toolchain-8|llvm-toolchain-7|gcc-snapshot|gcc-10|deal.ii|kodi|vg|qgis|openms|siconos|ball|gtg-trace|libsbml|dcmtk|gromacs|gudhi|kicad|libpwiz)$' ../doxygen_1.8.17-1_amd64.changes
Note: you need to escape the + sign in package names as in dbus-c\+\+ to avoid messing up the regexp expression.