CGREEN-RUNNER(1)

📦
version 1.7.0 · 3 versions
  • 1.7.0 · alpine 3.24, debian trixie, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.6.2 · fedora 43
  • 1.3.0 · ubuntu jammy
, in alpine 3.24, debian trixie, epel 10, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 CGREEN-RUNNER 🌸

okay bestie, welcome to cgreen-runner, section 1 of the General Commands Manual. it's an auto-discovering runner for the Cgreen unittest and mocking framework, and honestly? she eats. 💅

✨ NAME ✨

cgreen-runner — an auto-discovering runner for the Cgreen unittest and mocking framework 🧚

🎀 SYNOPSIS 🎀

cgreen-runner [--colour] [--xml prefix] [--suite name] [--verbose]
[--no-run] [--help] ( LIBRARY [test] )+

💖 DESCRIPTION 💖

so here's the tea: Cgreen is a framework for creating and running compact and easy-to-read unittests for C and/or C++. after you compile your tests and link them together with the code/class/subject under test (that's the CUT/SUT, iykyk) into a shared dynamically loadable LIBRARY, you can auto-discover and run all your tests using cgreen-runner — and you never have to manually add each and every single test you write to a suite programmatically. not one. not ever. 😭👑

this makes the TDD cycle even faster and less error-prone. one less thing to remember. main character energy fr fr. 🦋

🫶 Usage: 🫶

Discover and run all, or a single named, cgreen test(s) from one or multiple dynamically loadable library.

a single test can be run using the form [<context>:]<name> where <context> can be omitted if there is no context. periodt. ✨

💅 OPTIONS 💅

  • -c, --colours/colors — use colours to emphasis result (requires an ANSI-capable terminal, so don't come crying to me if your terminal is stuck in 1998 💀)
  • -x, --xml prefix — instead of messages on stdout, write results into one XML-file per suite, compatible with Hudson/Jenkins CI. the filename(s) will be prefix-<suite>.xml ⭐
  • -s, --suite name — give the top level suite name instead of the name in the LIBRARY.
  • -n, --no-run — don't run the tests. (not me discovering everything and running nothing 🙈)
  • -v, --verbose — show progress information during run.
  • -V, --version — show version information and exit.
  • -h, --help — print some usage information and exit.

👀 SEE ALSO 👀

  • cgreen(5)
  • the full documentation for cgreen-runner and the Cgreen framework is in the Cgreen manual available at GitHub. 📚
lowkey a whole framework, highkey a whole vibe. go write some tests bestie, you got this. 🌈

and that's the page, babes — brought to you by cgreen-runner out of the General Commands Manual, section 1. mwah, bye! 💖🎀🌸

📦 where this page comes from