wibble-test-genrunner(1)

📦 version 1.1, in ubuntu jammy, ubuntu noble

💅 wibble-test-genrunner 💅

okay bestie, so this one is wibble-test-genrunner, and it lives in the General Commands Manual — it's the code generator for wibble testsuites, and honestly? it's giving quiet little build-tool icon. no options, no drama, just vibes and .cpp files. 🎀

✨ NAME ✨

wibble-test-genrunner — the code generator for wibble testsuites, periodt.

🌸 SYNOPSIS 🌸

wibble-test-genrunner header <file>

wibble-test-genrunner main <files>

🦋 DESCRIPTION 🦋

so what this program does is it generates .cpp files, and those .cpp files get compiled and linked into a test program that runs the tests living inside .test.h files. like, that's the whole gig. 💖

if you wanna peek at what these .test.h files look like irl, there's examples hanging out among the wibble headers, e.g. /usr/include/wibble/regexp.test.h. go look, it's cute.

now, the two forms — lemme break it down for you:

  • form one: header <file> — the program takes a single header file (usually shaped like foo.test.h) and produces a corresponding .cpp file that's meant to be compiled. one header in, one .cpp out. slay.
  • form two: main <files> — here you pass all the .test.h headers as <files>, and it produces a single main.cpp that contains the main() function of the test program. that main() then runs all the tests in all the .test.h files. main character energy fr fr. 👑

and here's the thing you gotta remember: the generated source code is always written to standard output. every single time. it is fully on you to redirect it somewhere meaningful. no cap. 🙈

bestie the program currently has no options other than the two forms above. that's it. that's the whole flag situation. it's minimal and it knows it. 💅

this program is intended to be run as part of the build process of programs or libraries that use the wibble testing framework. so like, it's not really a "sit down and chat with it in your terminal" tool, it's a "the build system yells at it and it does its job" tool. iconic.

and for convenient use from CMake, there's a test.cmake script sitting under /usr/share/wibble that handles all of it for you: producing all the .cpp files (both the per-header ones and the main one), compiling them, and linking them into a single binary which executes the testsuite. obsessed. 🫶

💜 AUTHOR 💜

Petr Rockai <me@mornfall.net>

aaaand that's the whole page, bestie ✨ thanks for reading, mwah 🎀 — this was wibble-test-genrunner(1) from the General Commands Manual, out here doing build-tool things and looking adorable while it does. 💖

📦 where this page comes from