From 092270834eac54ed33e634494f9f38ba7fd38fd4 Mon Sep 17 00:00:00 2001
From: Sebastiano Tronto <sebastiano@tronto.net>
Date: Sat, 4 Feb 2023 17:26:32 +0100
Subject: Some improvements to test suite, ready to go

---
 tests/test_common.h | 34 ++++++++++++++++++++++++++++------
 1 file changed, 28 insertions(+), 6 deletions(-)

(limited to 'tests/test_common.h')

diff --git a/tests/test_common.h b/tests/test_common.h
index ea35ecd..03511ef 100644
--- a/tests/test_common.h
+++ b/tests/test_common.h
@@ -1,19 +1,41 @@
 #ifndef TEST_COMMON_H
 #define TEST_COMMON_H
 
+/*
+ * Common utilities for testing.
+ * A VoidMethod can be used as a setup or teardown method for testing, see
+ * the TestSuite struct. A TestMethod takes a void pointer (usually cast
+ * to some data to be used for testing, but can also be ignored) and returns
+ * a bool: true for pass, false for fail.
+ * A Test consists of a name (string), a TestMethod and an array of void
+ * pointers that describe the test cases. Each element of this array is
+ * passed to the test method sequentially, and the test session stops on
+ * the first failure.
+ * A test suite is just a list of tests with a setup and a teardown method.
+ * The setup method is run once and for all before the first test, and the
+ * teardown is run at the end of the testsuite.
+ * Finally, a TestModule roughly corresponds to a test file. This type is
+ * only used in test.c to collect multiple test modules.
+ */
+
 typedef void (*VoidMethod)(void);
 typedef bool (*TestMethod)(void *);
 
 typedef struct {
-	char *     name;
-	TestMethod t;
-	void **    cases;
+	char *          name;
+	TestMethod      t;
+	void **         cases;
 } Test;
 
 typedef struct {
-	VoidMethod setup;
-	Test **    tests;
-	VoidMethod teardown;
+	VoidMethod      setup;
+	Test **         tests;
+	VoidMethod      teardown;
 } TestSuite;
 
+typedef struct {
+	char *          name;
+	TestSuite **    suites;
+} TestModule;
+
 #endif
-- 
cgit v1.3