Single-header C99 test framework for hosted and embedded-oriented C projects.
What it does:
- Assertions for integers, pointers, strings, memory, and optional floats.
- Suites for grouping tests, including multi-translation-unit suites.
- Fixtures with explicit setup and teardown.
- Runtime CLI filtering, list mode, verbose mode, stop-on-fail, and no-color.
- Output callbacks for custom sinks.
- CMake package export, install, and consumer verification.
What it does not do:
- No dynamic allocation.
- No third-party dependencies.
- No claim of thread safety.
- No ASan/UBSan verification on this host.
- No claim of freestanding, ISR, RTOS, or production readiness.
#defineMTEST_IMPLEMENTATION#include"mtest.h"MTEST(test_addition) {
MTEST_ASSERT_EQ(2+2, 4);
}
MTEST_SUITE(math) {
MTEST_RUN(test_addition);
}
intmain(intargc, char**argv) {
MTEST_BEGIN(argc, argv);
MTEST_SUITE_RUN(math);
returnMTEST_END();
}Assertions:
MTEST(test_strings) {
MTEST_ASSERT_STR_EQ("alpha", "alpha");
MTEST_ASSERT_MEM_EQ("abc", "abc", 3);
}Skip:
MTEST(test_skip_example) {
MTEST_SKIP("not supported here");
}Fixture:
staticvoidsetup(void) { }
staticvoidteardown(void) { }
MTEST(test_with_fixture) {
MTEST_ASSERT_TRUE(1);
}
MTEST_SUITE(example) {
MTEST_RUN_F(test_with_fixture, setup, teardown);
}Multi-TU:
/* in one file */MTEST_SUITE_DEFINE(shared) { MTEST_RUN(test_one); }
/* in another file */MTEST_SUITE_DECLARE(shared);Supported options:
--filter=NAME-v,--verbose-x,--stop-on-fail-l,--list-h,--help--no-color
Examples:
./test_all --filter=ring
./test_all -l
./test_all -x
./test_all --no-color--help prints usage and returns success without running suites.
An empty --filter= is invalid.
An unknown option fails with a nonzero exit code.
| Macro | Default | Meaning |
|---|---|---|
MTEST_ENABLE_COLOR | 1 | ANSI colors at runtime |
MTEST_ENABLE_CLI | 1 | CLI parsing and help |
MTEST_ENABLE_ENV | 1 | NO_COLOR support |
MTEST_ENABLE_EXIT | 1 | Hosted exit codes from MTEST_END() |
MTEST_ENABLE_FLOAT | 1 | Float assertions and math helpers |
include/mtest.h- single public headertests/- self-tests, CLI checks, install consumer, and multi-TU checkscmake/- package config templatedocs/- reference notes for API and usage