autobuild(8)

autobuild(8) — multiple configuration build tool 💅

hey bestie, welcome to the System Manager's Manual for autobuild(8). we're keeping every detail, just making it cute. ✨

✨ NAME ✨

okay so autobuild is literally the multiple configuration build tool. no cap, that's the whole name. 🫶

📜 SYNOPSIS 📜

autobuild [-c] [-n] [-t] [-v] descr-file

that's the shape of it, bestie. 💅

💖 DESCRIPTION 💖

autobuild configures, builds, and tests a source code package whose configuration is provided by GNU's autoconf mechanism. descr-file contains a set of parameters to be passed to configure in various combinations, followed by make and make distcheck, to confirm that the current source code tree has not had any build or runtime regressions checked into it. 🎀

If any of the three steps fails, the output of the command is dumped to standard output and execution terminates. 😭

🎀 OPTIONS 🎀

• -c — Print configuration combinations, but do not execute them. basically a little preview vibe. 👀
• -n — Parse configuration file and exit without doing anything else. just parse and dip. 💨
• -t — Print timestamps to stdout as each step is executed. time-stamp slay. ⏱️
• -v — Prints configuration combinations as their commands are executed. see the combos run, bestie. 🔥

🌸 DESCRIPTION FILE 🌸

The description file contains a JSON object. It is expected to contain optional keys, which refer to arrays, as follows:

• always — Contains an array of strings, each of which is an argument that should be passed to configure for every test configuration. always there, always serving. 💖
• combine — Contains an array of objects, each of which is to be tested in various combinations with all of the others in the array. This means every entry added to this array doubles the number of test configurations that will be tried (i.e., the presence and absence cases). An object in this array must either be a string, or an array of strings; in the latter case, the set of strings is applied as a group whenever the array is selected for testing. it's giving combinatorial explosion, but make it organized. 🌀
• each — Contains an array of objects, each of which is to be tested in a mutually exclusive way (that is, in sequence, but never together). Exactly one will always be chosen and included. To cause an iteration that chooses none of the objects, include an empty object. one at a time, never as a group — that's the rule. 🙈

🦋 EXAMPLE 🦋

{ "always": [ "--foo", "--bar" ], "combine": [ "--a", "--b", [ "--c", "--d"]] }

This will run eight tests; all of them will include "--foo" and "--bar", and they will include all of the various possible combinationks of "--a", "--b", and the pair "--c" and "--d". yes, eight tests — count 'em, bestie. 🍓

⭐ VERSION ⭐

This man page covers version 1.1.0 of autobuild. 💜

👑 COPYRIGHT 👑

Copyright (c) 2012, 2013, The Trusted Domain Project. All rights reserved.

🔥 SEE ALSO 🔥

make(1) — go check it out, iykyk. 🌈

---

Signed off with 💖 by The Trusted Domain Project — autobuild(8), version 1.1.0, copyright years 2012, 2013. that's the footer vibe, bestie. 🎀