feat: Add validation for asyncio_default_fixture_loop_scope and asyncio_default_test_loop_scope

fix linters issue

added changelog entry

[pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

docs: Reword changelog entry.

Author: pankaj-bind

changelog.d/1189.added.rst

@@ -0,0 +1 @@
+A ``pytest.UsageError`` for invalid configuration values of ``asyncio_default_fixture_loop_scope`` and ``asyncio_default_test_loop_scope``.

pytest_asyncio/plugin.py

@@ -234,10 +234,25 @@ def _get_asyncio_debug(config: Config) -> bool:
 """
 
 
+def _validate_scope(scope: str | None, option_name: str) -> None:
+    if scope is None:
+        return
+    valid_scopes = [s.value for s in Scope]
+    if scope not in valid_scopes:
+        raise pytest.UsageError(
+            f"{scope!r} is not a valid {option_name}. "
+            f"Valid scopes are: {', '.join(valid_scopes)}."
+        )
+
+
 def pytest_configure(config: Config) -> None:
-    default_loop_scope = config.getini("asyncio_default_fixture_loop_scope")
-    if not default_loop_scope:
+    default_fixture_loop_scope = config.getini("asyncio_default_fixture_loop_scope")
+    _validate_scope(default_fixture_loop_scope, "asyncio_default_fixture_loop_scope")
+    if not default_fixture_loop_scope:
         warnings.warn(PytestDeprecationWarning(_DEFAULT_FIXTURE_LOOP_SCOPE_UNSET))
+
+    default_test_loop_scope = config.getini("asyncio_default_test_loop_scope")
+    _validate_scope(default_test_loop_scope, "asyncio_default_test_loop_scope")
     config.addinivalue_line(
         "markers",
         "asyncio: "

tests/test_fixture_loop_scopes.py

@@ -136,3 +136,20 @@ async def test_runs_in_fixture_loop(fixture_loop):
     )
     result = pytester.runpytest_subprocess("--asyncio-mode=strict")
     result.assert_outcomes(passed=1)
+
+
+def test_invalid_default_fixture_loop_scope_raises_error(pytester: Pytester):
+    pytester.makeini(
+        """\
+        [pytest]
+        asyncio_default_fixture_loop_scope = invalid_scope
+        """
+    )
+    result = pytester.runpytest()
+    result.stderr.fnmatch_lines(
+        [
+            "ERROR: 'invalid_scope' is not a valid "
+            "asyncio_default_fixture_loop_scope. Valid scopes are: "
+            "function, class, module, package, session."
+        ]
+    )