RATT(1)

NAME
ratt - Rebuild All The Things!

SYNOPSIS

            ratt [-h] [-dry_run] [-recheck] [-skip_ftbfs]
                 [-include REGEX] [-exclude REGEX]
                 [-dist DIST] [-sbuild_dist DIST] [-sbuild-keep-build-log]
                 [-log_dir DIR] [-chdist NAME]
                 [-direct-rdeps] [-rdeps-depth N]
                 [-json] <file>.changes

DESCRIPTION

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.

The builds are performed using sbuild(1). See <https://wiki.debian.org/sbuild> for instructions on setting it up.

OPTIONS

    -chdist string
        Use the package index files from a chdist environment instead of the host APT setup. The name must match the one used in chdist create.

-dist string Distribution to look up reverse-build-dependencies from. Defaults to the Distribution: field in the .changes file.

-dry_run Print sbuild command lines, but do not build anything.

-exclude regex Exclude packages matching the given regular expression.

-include regex Only build packages matching the given regular expression.

-log_dir string Directory to store sbuild(1) logs (default: buildlogs).

-recheck Rebuild previously failed packages again, even without new changes.

-sbuild_dist string Value passed to sbuild --dist= (e.g., sid).

-skip_ftbfs Skip packages marked as FTBFS on udd.debian.org.

    -sbuild-keep-build-log
        Let sbuild produce its .build log. Without this option, ratt passes sbuild's --nolog and saves console output in -log_dir instead.

    -direct-rdeps
        Limit the reverse dependency analysis to packages that directly Build-Depend on the target. Equivalent to using -rdeps-depth=2.

    -rdeps-depth N
        Set the maximum depth for reverse dependency resolution (via dose-ceve(1)).  If unset, all the transitive reverse dependencies will be included.  See the --depth option in dose-ceve(1) manpage to see more details.

    -json
        Output results in JSON format (currently only works in combination with -dry_run). JSON is written to stdout; human-readable logs go to stderr. Each entry includes the reverse build-dependency name, its version, and the corresponding sbuild command that would be executed.

USING -CHDIST FOR SUITE ISOLATION

To avoid modifying your system-wide /etc/apt/sources.list, you can use chdist to simulate isolated APT environments per distribution suite.

Basic steps:

    1.  Create the chdist environment:

                $ chdist create bookworm http://deb.debian.org/debian bookworm main

    2.  Update its APT metadata:

                $ chdist bookworm apt-get update

    3.  Run ratt using the chdist environment:

                $ ratt -chdist bookworm yourpackage_*.changes

This will use the package index files from ~/.chdist/bookworm instead of your system's APT configuration.

Note: The value passed to -chdist must match the name used in chdist create.

EXAMPLES

Basic:

            $ ratt yourpackage_*.changes

With chdist:

            $ ratt -chdist sid yourpackage_*.changes

Dry run:

            $ ratt -dry_run -chdist sid yourpackage_*.changes

Skip packages known FTBFS:

            $ ratt -skip_ftbfs -chdist sid yourpackage_*.changes

Keep sbuild .build logs:

            $ ratt -sbuild-keep-build-log yourpackage_*.changes

Limit to direct reverse build-dependencies only:

            $ ratt -direct-rdeps yourpackage_*.changes

Print dry-run result in JSON format:

            $ ratt -dry_run -json yourpackage_*.changes

Suppress all logs and print only JSON (clean output):

            $ ratt -dry_run -json yourpackage_*.changes 2>/dev/null

Extract only the sbuild commands (with jq):

            $ ratt -dry_run -json yourpackage_*.changes 2>/dev/null | jq -r '.dry_run_builds[].sbuild_command'

Filter specific packages:

            $ ratt -include '^(hwloc|fltk1.3)$' yourpackage_*.changes

Exclude expensive packages:

            $ ratt -exclude '^(gcc-9|gcc-8|llvm-toolchain)$' yourpackage_*.changes

SEE ALSO

sbuild(1), chdist(1)

AUTHOR
This manual page was written by Aquila Macedo Costa <aquilamacedo@riseup.net>.

COPYRIGHT
MIT (Expat)