[feat] Add skip_test()

CMakeLists.txt

@@ -1,5 +1,4 @@
-# Required cmake version
-cmake_minimum_required(VERSION 2.8.12)
+cmake_minimum_required(VERSION 3.10)
 
 project(cgreen)
 
@@ -34,7 +33,7 @@ set(APPLICATION_NAME ${PROJECT_NAME})
 # automatically updates that...
 set(APPLICATION_VERSION_MAJOR "1")
 set(APPLICATION_VERSION_MINOR "6")
-set(APPLICATION_VERSION_PATCH "3")
+set(APPLICATION_VERSION_PATCH "4")
 
 set(APPLICATION_VERSION ${APPLICATION_VERSION_MAJOR}.${APPLICATION_VERSION_MINOR}.${APPLICATION_VERSION_PATCH}${APPLICATION_VERSION_STATUS})
 add_definitions(-DVERSION="${APPLICATION_VERSION}")

doc/cgreen-guide-en.asciidoc

@@ -539,6 +539,7 @@ assert_that(actual, <constraint>);
 
 NOTE: Sometimes you just want to fail the test explicitly, and there is a function for that too, `fail_test(const char *message)`.
 And there is a function to explicitly pass, `pass_test(void)`.
+There is also a function to programmatically skip a test, `skip_test(void)` to complement the `xEnsure` notation (see <<xensure>>).
 
 Assertions send messages to *Cgreen*, which in turn outputs the results.
 
@@ -2502,6 +2503,10 @@ With this method, it is a one character change to temporarily ignore, and un-ign
 It is also easily found using text searches through a complete source tree.
 *Cgreen* will also tally the skipped tests, so it is clearly visible that you have some skipped test when you run them.
 
+NOTE: You can also programmatically decide to skip a test depending on some run-time information.
+You do that simply by checking for the condition and calling `skip_test()` which will tally the test as skipped.
+
+NOTE: `skip_test()` does *not* exit your test function so you need to take care that continuing after the call does not trigger any undecided behaviour.
 
 
 [[changing_style]]

include/cgreen/assertions.h

@@ -32,6 +32,7 @@ namespace cgreen {
 
 #define pass_test() assert_true(true)
 #define fail_test(...) assert_true_with_message(false, __VA_ARGS__)
+#define skip_test() send_reporter_skipped_notification(get_test_reporter())
 
 
 /* Utility: */

include/cgreen/cgreen.h

@@ -9,10 +9,10 @@
 #include <cgreen/runner.h>
 #include <cgreen/boxed_double.h>
 
-#define CGREEN_VERSION "1.6.3"
+#define CGREEN_VERSION "1.6.4"
 #define CGREEN_VERSION_MAJOR 1
 #define CGREEN_VERSION_MINOR 6
-#define CGREEN_VERSION_PATCH 3
+#define CGREEN_VERSION_PATCH 4
 
 extern char *cgreen_library_version;
 extern char *cgreen_library_revision;