docs: Added how-to guide on changing the default event loop scope of all fixtures.

Signed-off-by: Michael Seifert <[email protected]>

Author: seifertm

docs/source/how-to-guides/change_default_fixture_loop.rst

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

docs/source/how-to-guides/index.rst

@@ -6,6 +6,7 @@ How-To Guides
   :hidden:
 
   change_fixture_loop
+  change_default_fixture_loop
   run_class_tests_in_same_loop
   run_module_tests_in_same_loop
   run_package_tests_in_same_loop

docs/source/reference/configuration.rst

@@ -2,6 +2,8 @@
 Configuration
 =============
 
+.. _configuration/asyncio_default_fixture_loop_scope:
+
 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``