Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/siu/minunit
Minimal unit testing framework for C
https://github.com/siu/minunit
Last synced: about 2 months ago
JSON representation
Minimal unit testing framework for C
- Host: GitHub
- URL: https://github.com/siu/minunit
- Owner: siu
- License: mit
- Created: 2012-06-25T15:17:12.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2023-10-27T06:25:41.000Z (11 months ago)
- Last Synced: 2024-05-02T14:42:34.409Z (5 months ago)
- Language: C
- Size: 49.8 KB
- Stars: 551
- Watchers: 21
- Forks: 94
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: MIT-LICENSE.txt
Awesome Lists containing this project
README
## MinUnit
Minunit is a minimal unit testing framework for C/C++ self-contained in a
single header file.It provides a way to define and configure test suites and a few handy assertion
types. It reports the summary of the number of tests run, number of assertions
and time elapsed.Note that this project is based on:
http://www.jera.com/techinfo/jtns/jtn002.html## How to use it
This is a minimal test suite written with minunit:
```c
#include "minunit.h"MU_TEST(test_check) {
mu_check(5 == 7);
}
MU_TEST_SUITE(test_suite) {
MU_RUN_TEST(test_check);
}int main(int argc, char *argv[]) {
MU_RUN_SUITE(test_suite);
MU_REPORT();
return MU_EXIT_CODE;
}
```Which will produce the following output:
```
F
test_check failed:
readme_sample.c:4: 5 == 71 tests, 1 assertions, 1 failures
Finished in 0.00032524 seconds (real) 0.00017998 seconds (proc)
```Check out `minunit_example.c` to see a complete example. Compile with something
like:```
gcc minunit_example.c -lrt -lm -o minunit_example
```Don't forget to add `-lrt` for the timer and `-lm` for linking the function `fabs`
used in `mu_assert_double_eq`.## Setup and teardown functions
One can define setup and teardown functions and configure the test suite to run
them by using the macro `MU_SUITE_CONFIGURE` with within a `MU_TEST_SUITE`
declaration.## Assertion types
`mu_check(condition)`: will pass if the condition is evaluated to `true`, otherwise
it will show the condition as the error message`mu_fail(message)`: will fail and show the message
`mu_assert(condition, message)`: will pass if the condition is `true`, otherwise it
will show the failed condition and the message`mu_assert_int_eq(expected, result)`: it will pass if the two numbers are
equal or show their values as the error message`mu_assert_double_eq(expected, result)`: it will pass if the two values
are almost equal or show their values as the error message. The value of
`MINUNIT_EPSILON` sets the threshold to determine if the values are close enough.`mu_assert_string_eq(expected, resurt):` it will pass if the two strings are equal.
## Authors
David Siñuela Pastor