Add CATCH_CONFIG_RUN_ORDER_DECLARED flag

BUILD.bazel

@@ -73,6 +73,7 @@ expand_template(
         "#cmakedefine CATCH_CONFIG_USE_ASYNC": "",
         "#cmakedefine CATCH_CONFIG_WCHAR": "",
         "#cmakedefine CATCH_CONFIG_WINDOWS_CRTDBG": "",
+        "#cmakedefine CATCH_CONFIG_RUN_ORDER_DECLARED": "",
         "#cmakedefine CATCH_CONFIG_WINDOWS_SEH": "",
         "#cmakedefine CATCH_CONFIG_USE_BUILTIN_CONSTANT_P": "",
         "#cmakedefine CATCH_CONFIG_NO_USE_BUILTIN_CONSTANT_P": "",

docs/configuration.md

@@ -152,6 +152,7 @@ by using `_NO_` in the macro, e.g. `CATCH_CONFIG_NO_CPP17_UNCAUGHT_EXCEPTIONS`.
     CATCH_CONFIG_FAST_COMPILE               // Sacrifices some (rather minor) features for compilation speed
     CATCH_CONFIG_POSIX_SIGNALS              // Enable handling POSIX signals
     CATCH_CONFIG_WINDOWS_CRTDBG             // Enable leak checking using Windows's CRT Debug Heap
+    CATCH_CONFIG_RUN_ORDER_DECLARED         // Changes the default tests run behavior to declaration ordered
     CATCH_CONFIG_DISABLE_STRINGIFICATION    // Disable stringifying the original expression
     CATCH_CONFIG_DISABLE                    // Disables assertions and test case registration
     CATCH_CONFIG_WCHAR                      // Enables use of wchart_t
@@ -181,6 +182,9 @@ CRT is used to check for memory leaks, and displays them after the tests
 finish running. This option only works when linking against the default
 main, and must be defined for the whole library build.
 
+`CATCH_CONFIG_RUN_ORDER_DECLARED` is off by default. If enabled, it restores
+the tests run ordering as it was before Catch2 3.9.0.
+
 `CATCH_CONFIG_WCHAR` is on by default, but can be disabled. Currently
 it is only used in support for DJGPP cross-compiler.
 

src/catch2/catch_config.cpp

@@ -96,6 +96,12 @@ namespace Catch {
         return lhs.type == rhs.type && lhs.filter == rhs.filter;
     }
 
+    ConfigData::ConfigData() {
+#if defined( CATCH_CONFIG_RUN_ORDER_DECLARED )
+        runOrder = TestRunOrder::Declared;
+#endif
+    }
+
     Config::Config( ConfigData const& data ):
         m_data( data ) {
         // We need to trim filter specs to avoid trouble with superfluous

src/catch2/catch_config.hpp

@@ -46,6 +46,8 @@ namespace Catch {
 
     struct ConfigData {
 
+        ConfigData();
+
         bool listTests = false;
         bool listTags = false;
         bool listReporters = false;

src/catch2/catch_user_config.hpp.in

@@ -227,6 +227,7 @@
 #cmakedefine CATCH_CONFIG_PREFIX_ALL
 #cmakedefine CATCH_CONFIG_PREFIX_MESSAGES
 #cmakedefine CATCH_CONFIG_WINDOWS_CRTDBG
+#cmakedefine CATCH_CONFIG_RUN_ORDER_DECLARED
 
 #cmakedefine CATCH_CONFIG_SHARED_LIBRARY