Update error message for module level skip to include 'allow_module_l…

…evel' (pytest-dev#8906)

Co-authored-by: Naveen <[email protected]>
Co-authored-by: Bruno Oliveira <[email protected]>

changelog/8432.trivial.rst

@@ -0,0 +1 @@
+Improve error message when :func:`pytest.skip` is used at module level without passing `allow_module_level=True`.

src/_pytest/python.py

@@ -608,10 +608,10 @@ def _importtestmodule(self):
             if e.allow_module_level:
                 raise
             raise self.CollectError(
-                "Using pytest.skip outside of a test is not allowed. "
-                "To decorate a test function, use the @pytest.mark.skip "
-                "or @pytest.mark.skipif decorators instead, and to skip a "
-                "module use `pytestmark = pytest.mark.{skip,skipif}."
+                "Using pytest.skip outside of a test will skip the entire module. "
+                "If that's your intention, pass `allow_module_level=True`. "
+                "If you want to skip a specific test or an entire class, "
+                "use the @pytest.mark.skip or @pytest.mark.skipif decorators."
             ) from e
         self.config.pluginmanager.consider_module(mod)
         return mod

testing/test_skipping.py

@@ -1341,7 +1341,7 @@ def test_func():
     )
     result = pytester.runpytest()
     result.stdout.fnmatch_lines(
-        ["*Using pytest.skip outside of a test is not allowed*"]
+        ["*Using pytest.skip outside of a test will skip the entire module*"]
     )