Add should_test_module hook

src/core.jl

@@ -90,7 +90,17 @@ function prepare_local(m::Module)
     LoadAllPackages.loadall(projectfile(m))
 end
 
+function should_test(m::Module)
+    f = try
+        m.should_test_module
+    catch
+        return true
+    end
+    return f()::Bool
+end
+
 function runtests(m::Module; recursive::Bool = true)
+    should_test(m) || return
     @debug "Testing module: `$m`"
     @testset "$f" for f in test_functions(m)
         @debug "Testing function: `$m.$f`"

test/TestFunctionRunnerTests/src/test_mockedtests.jl

@@ -34,11 +34,22 @@ function test_runtests_fail()
     @test runtests_process(SCRIPT; env = env) ⊜ false
 end
 
+function test_should_test_module()
+    env = cleanenv()
+    env["SampleMockedTests.TestShouldTest.test"] = "false"
+    @test runtests_process(SCRIPT; env = env) ⊜ false
+    env["SampleMockedTests.TestShouldTest.should_test_module"] = "false"
+    @test runtests_process(SCRIPT; env = env) ⊜ true
+end
+
 function test_discovery()
     @test test_functions(SampleMockedTests) ==
           [SampleMockedTests.test, SampleMockedTests.test_2]
-    @test test_modules(SampleMockedTests) ==
-          [SampleMockedTests.TestNested, SampleMockedTests.TestNested2]
+    @test test_modules(SampleMockedTests) == [
+        SampleMockedTests.TestNested,
+        SampleMockedTests.TestNested2,
+        SampleMockedTests.TestShouldTest,
+    ]
 end
 
 end  # module

test/samples/mockedtests/SampleMockedTests/src/SampleMockedTests.jl

@@ -20,6 +20,13 @@ using ...Utils: @defmock
 end  # module TestNested3
 end  # module TestNested2
 
+module TestShouldTest
+using ..Utils: @defmock
+should_test_module() =
+    lowercase(get(ENV, "$(@__MODULE__).should_test_module", "true")) == "true"
+@defmock test
+end  # module TestShouldTest
+
 module NotATestModule
 test() = error("this should not be executed")
 end  # module NotATestModule