pytest-asyncio 0.25.2__tar.gz → 0.26.0__tar.gz

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/PKG-INFO

@@ -1,9 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pytest-asyncio
-Version: 0.25.2
+Version: 0.26.0
 Summary: Pytest support for asyncio
 Author-email: "Tin Tvrtković <tinchester@gmail.com>" <tinchester@gmail.com>
-License: Apache 2.0
+License-Expression: Apache-2.0
 Project-URL: Bug Tracker, https://github.com/pytest-dev/pytest-asyncio/issues
 Project-URL: Changelog, https://pytest-asyncio.readthedocs.io/en/latest/reference/changelog.html
 Project-URL: Documentation, https://pytest-asyncio.readthedocs.io
@@ -13,7 +13,6 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: AsyncIO
 Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -26,12 +25,14 @@ Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: pytest<9,>=8.2
+Requires-Dist: typing-extensions>=4.12; python_version < "3.10"
 Provides-Extra: docs
 Requires-Dist: sphinx>=5.3; extra == "docs"
 Requires-Dist: sphinx-rtd-theme>=1; extra == "docs"
 Provides-Extra: testing
 Requires-Dist: coverage>=6.2; extra == "testing"
 Requires-Dist: hypothesis>=5.7.1; extra == "testing"
+Dynamic: license-file
 
 pytest-asyncio
 ==============

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/dependencies/default/constraints.txt

@@ -1,11 +1,11 @@
-attrs==24.3.0
-coverage==7.6.10
+attrs==25.3.0
+coverage==7.7.1
 exceptiongroup==1.2.2
-hypothesis==6.123.4
-iniconfig==2.0.0
+hypothesis==6.130.3
+iniconfig==2.1.0
 packaging==24.2
 pluggy==1.5.0
-pytest==8.3.4
+pytest==8.3.5
 sortedcontainers==2.4.0
 tomli==2.2.1
 typing_extensions==4.12.2

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/dependencies/docs/constraints.txt

@@ -1,11 +1,11 @@
 alabaster==0.7.16
-Babel==2.16.0
-certifi==2024.12.14
+Babel==2.17.0
+certifi==2025.1.31
 charset-normalizer==3.4.1
 docutils==0.21.2
 idna==3.10
 imagesize==1.4.1
-Jinja2==3.1.5
+Jinja2==3.1.6
 MarkupSafe==3.0.2
 packaging==24.2
 Pygments==2.19.1

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/docs/concepts.rst

@@ -47,8 +47,12 @@ Assigning neighboring tests to different event loop scopes is discouraged as it
 Test discovery modes
 ====================
 
-Pytest-asyncio provides two modes for test discovery, *strict* and *auto*.
+Pytest-asyncio provides two modes for test discovery, *strict* and *auto*. This can be set through Pytest's ``--asyncio-mode`` command line flag, or through the configuration file:
 
+.. code-block:: toml
+
+    [tool.pytest.ini_options]
+    asyncio_mode = "auto" # or "strict"
 
 Strict mode
 -----------

pytest_asyncio-0.26.0/docs/how-to-guides/change_default_test_loop.rst

@@ -0,0 +1,24 @@
+=======================================================
+How to change the default event loop scope of all tests
+=======================================================
+The :ref:`configuration/asyncio_default_test_loop_scope` configuration option sets the default event loop scope for asynchronous tests. The following code snippets configure all tests to run in a session-scoped loop by default:
+
+.. code-block:: ini
+    :caption: pytest.ini
+
+    [pytest]
+    asyncio_default_test_loop_scope = session
+
+.. code-block:: toml
+    :caption: pyproject.toml
+
+    [tool.pytest.ini_options]
+    asyncio_default_test_loop_scope = "session"
+
+.. code-block:: ini
+    :caption: setup.cfg
+
+    [tool:pytest]
+    asyncio_default_test_loop_scope = session
+
+Please refer to :ref:`configuration/asyncio_default_test_loop_scope` for other valid scopes.

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/docs/how-to-guides/index.rst

@@ -9,10 +9,10 @@ How-To Guides
   migrate_from_0_23
   change_fixture_loop
   change_default_fixture_loop
+  change_default_test_loop
   run_class_tests_in_same_loop
   run_module_tests_in_same_loop
   run_package_tests_in_same_loop
-  run_session_tests_in_same_loop
   multiple_loops
   uvloop
   test_item_is_async

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/docs/how-to-guides/uvloop.rst

@@ -2,7 +2,7 @@
 How to test with uvloop
 =======================
 
-Redefinig the *event_loop_policy* fixture will parametrize all async tests. The following example causes all async tests to run multiple times, once for each event loop in the fixture parameters:
+Redefining the *event_loop_policy* fixture will parametrize all async tests. The following example causes all async tests to run multiple times, once for each event loop in the fixture parameters:
 Replace the default event loop policy in your *conftest.py:*
 
 .. code-block:: python

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/docs/reference/changelog.rst

@@ -2,11 +2,23 @@
 Changelog
 =========
 
-0.25.2 (2025-01-08)
+0.26.0 (2025-03-25)
 ===================
+- Adds configuration option that sets default event loop scope for all tests `#793 <https://github.com/pytest-dev/pytest-asyncio/issues/793>`_
+- Improved type annotations for ``pytest_asyncio.fixture`` `#1045 <https://github.com/pytest-dev/pytest-asyncio/pull/1045>`_
+- Added ``typing-extensions`` as additional dependency for Python ``<3.10`` `#1045 <https://github.com/pytest-dev/pytest-asyncio/pull/1045>`_
+
+
+0.25.3 (2025-01-28)
+===================
+- Avoid errors in cleanup of async generators when event loop is already closed `#1040 <https://github.com/pytest-dev/pytest-asyncio/issues/1040>`_
+
 
+0.25.2 (2025-01-08)
+===================
 - Call ``loop.shutdown_asyncgens()`` before closing the event loop to ensure async generators are closed in the same manner as ``asyncio.run`` does `#1034 <https://github.com/pytest-dev/pytest-asyncio/pull/1034>`_
 
+
 0.25.1 (2025-01-02)
 ===================
 - Fixes an issue that caused a broken event loop when a function-scoped test was executed in between two tests with wider loop scope `#950 <https://github.com/pytest-dev/pytest-asyncio/issues/950>`_
@@ -22,7 +34,6 @@ Changelog
 - Propagates `contextvars` set in async fixtures to other fixtures and tests on Python 3.11 and above. `#1008 <https://github.com/pytest-dev/pytest-asyncio/pull/1008>`_
 
 
-
 0.24.0 (2024-08-22)
 ===================
 - BREAKING: Updated minimum supported pytest version to v8.2.0

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/docs/reference/configuration.rst

@@ -8,6 +8,12 @@ asyncio_default_fixture_loop_scope
 ==================================
 Determines the default event loop scope of asynchronous fixtures. When this configuration option is unset, it defaults to the fixture scope. In future versions of pytest-asyncio, the value will default to ``function`` when unset. Possible values are: ``function``, ``class``, ``module``, ``package``, ``session``
 
+.. _configuration/asyncio_default_test_loop_scope:
+
+asyncio_default_test_loop_scope
+===============================
+Determines the default event loop scope of asynchronous tests. When this configuration option is unset, it default to function scope. Possible values are: ``function``, ``class``, ``module``, ``package``, ``session``
+
 asyncio_mode
 ============
 The pytest-asyncio mode can be set by the ``asyncio_mode`` configuration option in the `configuration file

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/pyproject.toml

@@ -1,10 +1,8 @@
 [build-system]
 build-backend = "setuptools.build_meta"
-
 requires = [
-  "setuptools>=51",
+  "setuptools>=77",
   "setuptools-scm[toml]>=6.2",
-  "wheel>=0.36",
 ]
 
 [project]
@@ -12,7 +10,10 @@ name = "pytest-asyncio"
 description = "Pytest support for asyncio"
 readme.content-type = "text/x-rst"
 readme.file = "README.rst"
-license.text = "Apache 2.0"
+license = "Apache-2.0"
+license-files = [
+  "LICENSE",
+]
 authors = [
   { name = "Tin Tvrtković <tinchester@gmail.com>", email = "tinchester@gmail.com" },
 ]
@@ -22,7 +23,6 @@ classifiers = [
   "Framework :: AsyncIO",
   "Framework :: Pytest",
   "Intended Audience :: Developers",
-  "License :: OSI Approved :: Apache Software License",
   "Programming Language :: Python :: 3 :: Only",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
@@ -38,6 +38,7 @@ dynamic = [
 
 dependencies = [
   "pytest>=8.2,<9",
+  "typing-extensions>=4.12; python_version<'3.10'",
 ]
 optional-dependencies.docs = [
   "sphinx>=5.3",
@@ -59,9 +60,6 @@ packages = [
   "pytest_asyncio",
 ]
 include-package-data = true
-license-files = [
-  "LICENSE",
-]
 
 [tool.setuptools_scm]
 write_to = "pytest_asyncio/_version.py"

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/pytest_asyncio/_version.py

@@ -1,8 +1,13 @@
-# file generated by setuptools_scm
+# file generated by setuptools-scm
 # don't change, don't track in version control
+
+__all__ = ["__version__", "__version_tuple__", "version", "version_tuple"]
+
 TYPE_CHECKING = False
 if TYPE_CHECKING:
-    from typing import Tuple, Union
+    from typing import Tuple
+    from typing import Union
+
     VERSION_TUPLE = Tuple[Union[int, str], ...]
 else:
     VERSION_TUPLE = object
@@ -12,5 +17,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.25.2'
-__version_tuple__ = version_tuple = (0, 25, 2)
+__version__ = version = '0.26.0'
+__version_tuple__ = version_tuple = (0, 26, 0)

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/pytest_asyncio/plugin.py

@@ -9,6 +9,7 @@ import enum
 import functools
 import inspect
 import socket
+import sys
 import warnings
 from asyncio import AbstractEventLoop, AbstractEventLoopPolicy
 from collections.abc import (
@@ -53,17 +54,17 @@ from pytest import (
     StashKey,
 )
 
+if sys.version_info >= (3, 10):
+    from typing import ParamSpec
+else:
+    from typing_extensions import ParamSpec
+
+
 _ScopeName = Literal["session", "package", "module", "class", "function"]
 _T = TypeVar("_T")
-
-SimpleFixtureFunction = TypeVar(
-    "SimpleFixtureFunction", bound=Callable[..., Awaitable[object]]
-)
-FactoryFixtureFunction = TypeVar(
-    "FactoryFixtureFunction", bound=Callable[..., AsyncIterator[object]]
-)
-FixtureFunction = Union[SimpleFixtureFunction, FactoryFixtureFunction]
-FixtureFunctionMarker = Callable[[FixtureFunction], FixtureFunction]
+_R = TypeVar("_R", bound=Union[Awaitable[Any], AsyncIterator[Any]])
+_P = ParamSpec("_P")
+FixtureFunction = Callable[_P, _R]
 
 
 class PytestAsyncioError(Exception):
@@ -107,11 +108,17 @@ def pytest_addoption(parser: Parser, pluginmanager: PytestPluginManager) -> None
         help="default scope of the asyncio event loop used to execute async fixtures",
         default=None,
     )
+    parser.addini(
+        "asyncio_default_test_loop_scope",
+        type="string",
+        help="default scope of the asyncio event loop used to execute tests",
+        default="function",
+    )
 
 
 @overload
 def fixture(
-    fixture_function: FixtureFunction,
+    fixture_function: FixtureFunction[_P, _R],
     *,
     scope: _ScopeName | Callable[[str, Config], _ScopeName] = ...,
     loop_scope: _ScopeName | None = ...,
@@ -123,7 +130,7 @@ def fixture(
         | None
     ) = ...,
     name: str | None = ...,
-) -> FixtureFunction: ...
+) -> FixtureFunction[_P, _R]: ...
 
 
 @overload
@@ -140,14 +147,17 @@ def fixture(
         | None
     ) = ...,
     name: str | None = None,
-) -> FixtureFunctionMarker: ...
+) -> Callable[[FixtureFunction[_P, _R]], FixtureFunction[_P, _R]]: ...
 
 
 def fixture(
-    fixture_function: FixtureFunction | None = None,
+    fixture_function: FixtureFunction[_P, _R] | None = None,
     loop_scope: _ScopeName | None = None,
     **kwargs: Any,
-) -> FixtureFunction | FixtureFunctionMarker:
+) -> (
+    FixtureFunction[_P, _R]
+    | Callable[[FixtureFunction[_P, _R]], FixtureFunction[_P, _R]]
+):
     if fixture_function is not None:
         _make_asyncio_fixture_function(fixture_function, loop_scope)
         return pytest.fixture(fixture_function, **kwargs)
@@ -155,7 +165,7 @@ def fixture(
     else:
 
         @functools.wraps(fixture)
-        def inner(fixture_function: FixtureFunction) -> FixtureFunction:
+        def inner(fixture_function: FixtureFunction[_P, _R]) -> FixtureFunction[_P, _R]:
             return fixture(fixture_function, loop_scope=loop_scope, **kwargs)
 
         return inner
@@ -217,9 +227,15 @@ def pytest_configure(config: Config) -> None:
 def pytest_report_header(config: Config) -> list[str]:
     """Add asyncio config to pytest header."""
     mode = _get_asyncio_mode(config)
-    default_loop_scope = config.getini("asyncio_default_fixture_loop_scope")
+    default_fixture_loop_scope = config.getini("asyncio_default_fixture_loop_scope")
+    default_test_loop_scope = _get_default_test_loop_scope(config)
+    header = [
+        f"mode={mode}",
+        f"asyncio_default_fixture_loop_scope={default_fixture_loop_scope}",
+        f"asyncio_default_test_loop_scope={default_test_loop_scope}",
+    ]
     return [
-        f"asyncio: mode={mode}, asyncio_default_fixture_loop_scope={default_loop_scope}"
+        "asyncio: " + ", ".join(header),
     ]
 
 
@@ -667,7 +683,7 @@ _fixture_scope_by_collector_type: Mapping[type[pytest.Collector], _ScopeName] =
 
 # A stack used to push package-scoped loops during collection of a package
 # and pop those loops during collection of a Module
-__package_loop_stack: list[FixtureFunctionMarker | FixtureFunction] = []
+__package_loop_stack: list[Callable[..., Any]] = []
 
 
 @pytest.hookimpl
@@ -807,7 +823,8 @@ def pytest_generate_tests(metafunc: Metafunc) -> None:
     marker = metafunc.definition.get_closest_marker("asyncio")
     if not marker:
         return
-    scope = _get_marked_loop_scope(marker)
+    default_loop_scope = _get_default_test_loop_scope(metafunc.config)
+    scope = _get_marked_loop_scope(marker, default_loop_scope)
     if scope == "function":
         return
     event_loop_node = _retrieve_scope_root(metafunc.definition, scope)
@@ -1078,7 +1095,8 @@ def pytest_runtest_setup(item: pytest.Item) -> None:
     marker = item.get_closest_marker("asyncio")
     if marker is None:
         return
-    scope = _get_marked_loop_scope(marker)
+    default_loop_scope = _get_default_test_loop_scope(item.config)
+    scope = _get_marked_loop_scope(marker, default_loop_scope)
     if scope != "function":
         parent_node = _retrieve_scope_root(item, scope)
         event_loop_fixture_id = parent_node.stash[_event_loop_fixture_id]
@@ -1108,7 +1126,9 @@ Please use the "loop_scope" argument instead.
 """
 
 
-def _get_marked_loop_scope(asyncio_marker: Mark) -> _ScopeName:
+def _get_marked_loop_scope(
+    asyncio_marker: Mark, default_loop_scope: _ScopeName
+) -> _ScopeName:
     assert asyncio_marker.name == "asyncio"
     if asyncio_marker.args or (
         asyncio_marker.kwargs and set(asyncio_marker.kwargs) - {"loop_scope", "scope"}
@@ -1119,12 +1139,18 @@ def _get_marked_loop_scope(asyncio_marker: Mark) -> _ScopeName:
             raise pytest.UsageError(_DUPLICATE_LOOP_SCOPE_DEFINITION_ERROR)
         warnings.warn(PytestDeprecationWarning(_MARKER_SCOPE_KWARG_DEPRECATION_WARNING))
     scope = asyncio_marker.kwargs.get("loop_scope") or asyncio_marker.kwargs.get(
-        "scope", "function"
+        "scope"
     )
+    if scope is None:
+        scope = default_loop_scope
     assert scope in {"function", "class", "module", "package", "session"}
     return scope
 
 
+def _get_default_test_loop_scope(config: Config) -> _ScopeName:
+    return config.getini("asyncio_default_test_loop_scope")
+
+
 def _retrieve_scope_root(item: Collector | Item, scope: str) -> Collector:
     node_type_by_scope = {
         "class": Class,
@@ -1164,10 +1190,14 @@ def _provide_event_loop() -> Iterator[asyncio.AbstractEventLoop]:
     try:
         yield loop
     finally:
-        try:
-            loop.run_until_complete(loop.shutdown_asyncgens())
-        finally:
-            loop.close()
+        # cleanup the event loop if it hasn't been cleaned up already
+        if not loop.is_closed():
+            try:
+                loop.run_until_complete(loop.shutdown_asyncgens())
+            except Exception as e:
+                warnings.warn(f"Error cleaning up asyncio loop: {e}", RuntimeWarning)
+            finally:
+                loop.close()
 
 
 @pytest.fixture(scope="session")

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/pytest_asyncio.egg-info/PKG-INFO

@@ -1,9 +1,9 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: pytest-asyncio
-Version: 0.25.2
+Version: 0.26.0
 Summary: Pytest support for asyncio
 Author-email: "Tin Tvrtković <tinchester@gmail.com>" <tinchester@gmail.com>
-License: Apache 2.0
+License-Expression: Apache-2.0
 Project-URL: Bug Tracker, https://github.com/pytest-dev/pytest-asyncio/issues
 Project-URL: Changelog, https://pytest-asyncio.readthedocs.io/en/latest/reference/changelog.html
 Project-URL: Documentation, https://pytest-asyncio.readthedocs.io
@@ -13,7 +13,6 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Framework :: AsyncIO
 Classifier: Framework :: Pytest
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
@@ -26,12 +25,14 @@ Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 Requires-Dist: pytest<9,>=8.2
+Requires-Dist: typing-extensions>=4.12; python_version < "3.10"
 Provides-Extra: docs
 Requires-Dist: sphinx>=5.3; extra == "docs"
 Requires-Dist: sphinx-rtd-theme>=1; extra == "docs"
 Provides-Extra: testing
 Requires-Dist: coverage>=6.2; extra == "testing"
 Requires-Dist: hypothesis>=5.7.1; extra == "testing"
+Dynamic: license-file
 
 pytest-asyncio
 ==============

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/pytest_asyncio.egg-info/SOURCES.txt

@@ -20,6 +20,7 @@ docs/conf.py
 docs/index.rst
 docs/support.rst
 docs/how-to-guides/change_default_fixture_loop.rst
+docs/how-to-guides/change_default_test_loop.rst
 docs/how-to-guides/change_fixture_loop.rst
 docs/how-to-guides/change_fixture_loop_example.py
 docs/how-to-guides/class_scoped_loop_example.py
@@ -33,11 +34,8 @@ docs/how-to-guides/package_scoped_loop_example.py
 docs/how-to-guides/run_class_tests_in_same_loop.rst
 docs/how-to-guides/run_module_tests_in_same_loop.rst
 docs/how-to-guides/run_package_tests_in_same_loop.rst
-docs/how-to-guides/run_session_tests_in_same_loop.rst
-docs/how-to-guides/session_scoped_loop_example.py
 docs/how-to-guides/test_item_is_async.rst
 docs/how-to-guides/test_item_is_async_example.py
-docs/how-to-guides/test_session_scoped_loop_example.py
 docs/how-to-guides/uvloop.rst
 docs/reference/changelog.rst
 docs/reference/configuration.rst

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/pytest_asyncio.egg-info/requires.txt

@@ -1,5 +1,8 @@
 pytest<9,>=8.2
 
+[:python_version < "3.10"]
+typing-extensions>=4.12
+
 [docs]
 sphinx>=5.3
 sphinx-rtd-theme>=1

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/tests/test_asyncio_mark.py

@@ -146,3 +146,80 @@ def test_asyncio_mark_on_async_generator_staticmethod_emits_warning_in_auto_mode
     result.stdout.fnmatch_lines(
         ["*Tests based on asynchronous generators are not supported*"]
     )
+
+
+def test_asyncio_marker_fallbacks_to_configured_default_loop_scope_if_not_set(
+    pytester: Pytester,
+):
+    pytester.makeini(
+        dedent(
+            """\
+            [pytest]
+            asyncio_default_fixture_loop_scope = function
+            asyncio_default_test_loop_scope = session
+            """
+        )
+    )
+
+    pytester.makepyfile(
+        dedent(
+            """\
+            import asyncio
+            import pytest_asyncio
+            import pytest
+
+            loop: asyncio.AbstractEventLoop
+
+            @pytest_asyncio.fixture(loop_scope="session", scope="session")
+            async def session_loop_fixture():
+                global loop
+                loop = asyncio.get_running_loop()
+
+            async def test_a(session_loop_fixture):
+                global loop
+                assert asyncio.get_running_loop() is loop
+            """
+        )
+    )
+
+    result = pytester.runpytest("--asyncio-mode=auto")
+    result.assert_outcomes(passed=1)
+
+
+def test_asyncio_marker_uses_marker_loop_scope_even_if_config_is_set(
+    pytester: Pytester,
+):
+    pytester.makeini(
+        dedent(
+            """\
+            [pytest]
+            asyncio_default_fixture_loop_scope = function
+            asyncio_default_test_loop_scope = module
+            """
+        )
+    )
+
+    pytester.makepyfile(
+        dedent(
+            """\
+            import asyncio
+            import pytest_asyncio
+            import pytest
+
+            loop: asyncio.AbstractEventLoop
+
+            @pytest_asyncio.fixture(loop_scope="session", scope="session")
+            async def session_loop_fixture():
+                global loop
+                loop = asyncio.get_running_loop()
+
+            @pytest.mark.asyncio(loop_scope="session")
+            async def test_a(session_loop_fixture):
+                global loop
+                assert asyncio.get_running_loop() is loop
+            """
+        )
+    )
+
+    result = pytester.runpytest("--asyncio-mode=auto")
+    result.assert_outcomes(passed=1)

{pytest_asyncio-0.25.2 → pytest_asyncio-0.26.0}/tests/test_event_loop_fixture.py

@@ -80,3 +80,61 @@ def test_event_loop_fixture_handles_unclosed_async_gen(
     )
     result = pytester.runpytest_subprocess("--asyncio-mode=strict", "-W", "default")
     result.assert_outcomes(passed=1, warnings=0)
+
+
+def test_event_loop_already_closed(
+    pytester: Pytester,
+):
+    pytester.makeini("[pytest]\nasyncio_default_fixture_loop_scope = function")
+    pytester.makepyfile(
+        dedent(
+            """\
+            import asyncio
+            import pytest
+            import pytest_asyncio
+            pytest_plugins = 'pytest_asyncio'
+
+            @pytest_asyncio.fixture
+            async def _event_loop():
+                return asyncio.get_running_loop()
+
+            @pytest.fixture
+            def cleanup_after(_event_loop):
+                yield
+                # fixture has its own cleanup code
+                _event_loop.close()
+
+            @pytest.mark.asyncio
+            async def test_something(cleanup_after):
+                await asyncio.sleep(0.01)
+            """
+        )
+    )
+    result = pytester.runpytest_subprocess("--asyncio-mode=strict", "-W", "default")
+    result.assert_outcomes(passed=1, warnings=0)
+
+
+def test_event_loop_fixture_asyncgen_error(
+    pytester: Pytester,
+):
+    pytester.makeini("[pytest]\nasyncio_default_fixture_loop_scope = function")
+    pytester.makepyfile(
+        dedent(
+            """\
+            import asyncio
+            import pytest
+
+            pytest_plugins = 'pytest_asyncio'
+
+            @pytest.mark.asyncio
+            async def test_something():
+                # mock shutdown_asyncgen failure
+                loop = asyncio.get_running_loop()
+                async def fail():
+                    raise RuntimeError("mock error cleaning up...")
+                loop.shutdown_asyncgens = fail
+            """
+        )
+    )
+    result = pytester.runpytest_subprocess("--asyncio-mode=strict", "-W", "default")
+    result.assert_outcomes(passed=1, warnings=1)

pytest_asyncio-0.25.2/docs/how-to-guides/run_session_tests_in_same_loop.rst

@@ -1,10 +0,0 @@
-==========================================================
-How to run all tests in the session in the same event loop
-==========================================================
-All tests can be run inside the same event loop by marking them with ``pytest.mark.asyncio(loop_scope="session")``.
-The easiest way to mark all tests is via a ``pytest_collection_modifyitems`` hook in the ``conftest.py`` at the root folder of your test suite.
-
-.. include:: session_scoped_loop_example.py
-    :code: python
-
-Note that this will also override *all* manually applied marks in *strict* mode.

pytest_asyncio-0.25.2/docs/how-to-guides/session_scoped_loop_example.py

@@ -1,10 +0,0 @@
-import pytest
-
-from pytest_asyncio import is_async_test
-
-
-def pytest_collection_modifyitems(items):
-    pytest_asyncio_tests = (item for item in items if is_async_test(item))
-    session_scope_marker = pytest.mark.asyncio(loop_scope="session")
-    for async_test in pytest_asyncio_tests:
-        async_test.add_marker(session_scope_marker, append=False)

pytest_asyncio-0.25.2/docs/how-to-guides/test_session_scoped_loop_example.py

@@ -1,63 +0,0 @@
-from pathlib import Path
-from textwrap import dedent
-
-from pytest import Pytester
-
-
-def test_session_scoped_loop_configuration_works_in_auto_mode(
-    pytester: Pytester,
-):
-    session_wide_mark_conftest = (
-        Path(__file__).parent / "session_scoped_loop_example.py"
-    )
-    pytester.makeconftest(session_wide_mark_conftest.read_text())
-    pytester.makepyfile(
-        dedent(
-            """\
-            import asyncio
-
-            session_loop = None
-
-            async def test_store_loop(request):
-                global session_loop
-                session_loop = asyncio.get_running_loop()
-
-            async def test_compare_loop(request):
-                global session_loop
-                assert asyncio.get_running_loop() is session_loop
-            """
-        )
-    )
-    result = pytester.runpytest_subprocess("--asyncio-mode=auto")
-    result.assert_outcomes(passed=2)
-
-
-def test_session_scoped_loop_configuration_works_in_strict_mode(
-    pytester: Pytester,
-):
-    session_wide_mark_conftest = (
-        Path(__file__).parent / "session_scoped_loop_example.py"
-    )
-    pytester.makeconftest(session_wide_mark_conftest.read_text())
-    pytester.makepyfile(
-        dedent(
-            """\
-            import asyncio
-            import pytest
-
-            session_loop = None
-
-            @pytest.mark.asyncio
-            async def test_store_loop(request):
-                global session_loop
-                session_loop = asyncio.get_running_loop()
-
-            @pytest.mark.asyncio
-            async def test_compare_loop(request):
-                global session_loop
-                assert asyncio.get_running_loop() is session_loop
-            """
-        )
-    )
-    result = pytester.runpytest_subprocess("--asyncio-mode=strict")
-    result.assert_outcomes(passed=2)