sbo-dockerbuild

Docker-based toolchain for test-building SlackBuilds.org (SBo) packages on Slackware, on both -current and 15.0, without touching a real system.

Two tools that share the same set of images:

test-build — verify a SlackBuild (the one you are editing, wherever it lives) builds cleanly in a throwaway container. Resolves and builds its SBo deps from a configured tree, caches built deps per image digest, lints the target with sbopkglint, and reports per-package status.
image-builder/ — build the images test-build consumes (sbo-base → sbo-full → sbo-testbuild, per Slackware version) from a mirror of the Slackware package trees, pushed to a LAN registry.

This started as a helper under .extras/ in the sbo-slackbuilds package repository and was extracted here to be maintained on its own. See HISTORY.md for the original development log.

Layout

test-build                 the test-build tool
test-logic.sh              pure-logic self-check for test-build (no docker)
test-build-config.example  copy to ~/.config/sbo-testbuild/config and edit
overrides.example          current-vs-stable dep overrides (optional)
image-builder/             the image-build scripts + their self-check
docs/specs, docs/plans     design specs and implementation plans

Install

Copy the test-build CLI into ~/bin (on your $PATH):

./install.sh                     # -> ~/bin/test-build
BINDIR=/usr/local/bin ./install.sh
./install.sh --uninstall

It copies the file, so re-run after editing test-build. The image-builder/ scripts are not installed; they run on the docker host from their own checkout.

Quick start

Test-build a package you are editing (from its dir, or by path):

cd some-slackbuild-dir && test-build <name>        # -current
test-build --stable <name>                         # 15.0
test-build --keep <name>                           # also keep the built .txz
test-build --local-deps <name>                     # deps live in the same repo

--local-deps also searches the target's own repo (its grandparent dir) for deps, for packages whose deps are siblings in the same repo and not on SBo. The configured SBo tree is still searched after.

Build the images (on the docker host; see image-builder/README):

cd image-builder
./bootstrap.sh           --version current --force
./build-full-image.sh    --version current --force
./build-sbo-testbuild.sh --version current --force

Requirements

Docker with a reachable LAN registry for the built images.
A local mirror of the Slackware package tree(s) for the image build, and a checkout of the SBo tree(s) for dependency resolution.
sbo-maintainer-tools (baked into the images for sbopkglint).

See the specs under docs/specs/ for the full design.

Versioning

This project follows Semantic Versioning, starting at 1.0.0. Check the version with test-build --version (or install.sh --version). Tagged releases are published on the Slackware Forge.

License

Released under the GNU General Public License, version 2 (v2 only). See LICENSE. Each source file carries a short header notice.

Development Approach

This project is developed using AI-assisted tools. Code is generated with the help of AI based on human-provided specifications, design decisions, and iterative feedback.

All contributions are reviewed, tested, and curated by the maintainer before being included in the codebase. AI is used as a productivity and exploration tool, while human oversight remains central to all decisions.

The goal is to combine the flexibility of AI-assisted development with standard open-source practices such as transparency, review, and accountability.