Hide implementation details of doctest macros

`test_macros.h` is created to provide various macros acting as aliases for
doctest macros to work better with Godot internals and conventions. This also
makes it accessible for those who'd like to start writing tests in Godot, as
most vital information can be put together and documented directly in
`test_macros.h` header.

Developers are encouraged to include the new `tests/test_macros.h` for writing
new tests over `thirdparty/doctest/doctest.h`.

Added `TEST_CASE_PENDING("name")` as an alias for
`TEST_CASE("name", doctest::skip())` which could be used to mark failing tests
for issues yet to be fixed, so as to not affect CI testing results.

Added `ERR_PRINT_OFF` and `ERR_PRINT_ON` to control error printing for testing
various **expected** failure paths within Godot without polluting the test
summary with error messages.

1 files changed, 19 insertions, 3 deletions

diff --git a/tests/test_validate_testing.h b/tests/test_validate_testing.h
index 5be7d45185..24acdec96c 100644
--- a/tests/test_validate_testing.h
+++ b/tests/test_validate_testing.h
@@ -33,10 +33,26 @@
 
 #include "core/os/os.h"
 
-#include "thirdparty/doctest/doctest.h"
+#include "tests/test_macros.h"
 
-TEST_CASE("Validate Test will always pass") {
-	CHECK(true);
+TEST_SUITE("Validate tests") {
+	TEST_CASE("Always pass") {
+		CHECK(true);
+	}
+	TEST_CASE_PENDING("Pending tests are skipped") {
+		if (!doctest::getContextOptions()->no_skip) { // Normal run.
+			FAIL("This should be skipped if `--no-skip` is NOT set (missing `doctest::skip()` decorator?)");
+		} else {
+			CHECK_MESSAGE(true, "Pending test is run with `--no-skip`");
+		}
+	}
+	TEST_CASE("Muting Godot error messages") {
+		ERR_PRINT_OFF;
+		CHECK_MESSAGE(!_print_error_enabled, "Error printing should be disabled.");
+		ERR_PRINT("Still waiting for Godot!"); // This should never get printed!
+		ERR_PRINT_ON;
+		CHECK_MESSAGE(_print_error_enabled, "Error printing should be re-enabled.");
+	}
 }
 
 #endif // TEST_VALIDATE_TESTING_H