From 0c6f39c9566ffbf9fe6dadbeb27616108302abc0 Mon Sep 17 00:00:00 2001 From: Adwaith-Rajesh Date: Sun, 28 Sep 2025 17:51:10 +0530 Subject: [PATCH] Added a README --- README.md | 76 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 76 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..938cef5 --- /dev/null +++ b/README.md @@ -0,0 +1,76 @@ +# test.h + +A simple header file to get test statistics. + + +> Currently under development things might change without notice + +## Usage + +Here is a simple simple example for `test.h` + +```c +// sample_test.c + +#include "test.h" + +TEST(sample1, { + ASSERT(1 == 1, ""); +}) + +TEST_INIT({}) +``` + +You can compile and rum this test file, and will get an output like this. + +```console +========================================================================= +TEST doc.c + +test_sample1 + (1/1) passed (0) failed + +PASSED - (1/1) passed (0) failed +========================================================================= +``` + +An example with two tests. + +```c +#include "test.h" + +TEST(sample1, { + ASSERT(1 == 1, ""); +}) + +TEST(sample2, { + ASSERT(1 == 1, ""); + ASSERT(1 == 0, "This assertion will fail"); +}) + +TEST_INIT({}) +``` + +```console +========================================================================= +TEST doc.c + +test_sample1 + (1/1) passed (0) failed + +test_sample2 + assertion failed (l.no - 9) [1 == 0] - This assertion will fail + (1/2) passed (1) failed + +FAILED - (1/2) passed (1) failed +========================================================================= +``` + + +To know about all the macros that you can use, check the [examples](./examples/) folder. + +--- + +If you have any issues or want to discuss, [Join my Discord](https://discord.gg/BxMbWzZe2Z) + +## Bye....