Skip asyncio tests when pytest-asyncio missing

Author: Luca Candela

conftest.py

@@ -13,6 +13,12 @@
 
 pytest_plugins = ['tests.integration.shared.fixtures_services']
 
+try:  # pragma: no cover - optional dependency guard
+    import pytest_asyncio  # type: ignore[unused-import]
+    HAS_PYTEST_ASYNCIO = True
+except ImportError:  # pragma: no cover - plugin unavailable
+    HAS_PYTEST_ASYNCIO = False
+
 # This code adds the project root directory to the Python path, allowing imports to work correctly when running tests.
 # Without this file, you might encounter ModuleNotFoundError when trying to import modules from your project, especially when running tests.
 sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__))))
@@ -49,6 +55,14 @@ def mock_embedder():
     return make_mock_embedder()
 
 
+def pytest_collection_modifyitems(config, items):  # pragma: no cover - discovery guard
+    if not HAS_PYTEST_ASYNCIO:
+        skip_asyncio = pytest.mark.skip(reason='pytest-asyncio is not installed in this environment')
+        for item in items:
+            if 'asyncio' in item.keywords:
+                item.add_marker(skip_asyncio)
+
+
 @pytest.fixture(scope='session', autouse=True)
 def _patch_aiohttp_client_session():
     yield