From e642cd45ae56aa4a6a2c05e3c9a72cdaa30e09dd Mon Sep 17 00:00:00 2001
From: epenet <6771947+epenet@users.noreply.github.com>
Date: Mon, 30 Jun 2025 11:56:26 +0200
Subject: [PATCH] Enforce async_load_fixture in async test functions (#145709)

---
 pylint/plugins/hass_async_load_fixtures.py | 80 ++++++++++++++++++++++
 pyproject.toml                             |  1 +
 tests/util/test_location.py                | 18 +++--
 3 files changed, 94 insertions(+), 5 deletions(-)
 create mode 100644 pylint/plugins/hass_async_load_fixtures.py

diff --git a/pylint/plugins/hass_async_load_fixtures.py b/pylint/plugins/hass_async_load_fixtures.py
new file mode 100644
index 00000000000..b1680f3f280
--- /dev/null
+++ b/pylint/plugins/hass_async_load_fixtures.py
@@ -0,0 +1,80 @@
+"""Plugin for logger invocations."""
+
+from __future__ import annotations
+
+from astroid import nodes
+from pylint.checkers import BaseChecker
+from pylint.lint import PyLinter
+
+FUNCTION_NAMES = (
+    "load_fixture",
+    "load_json_array_fixture",
+    "load_json_object_fixture",
+)
+
+
+class HassLoadFixturesChecker(BaseChecker):
+    """Checker for I/O load fixtures."""
+
+    name = "hass_async_load_fixtures"
+    priority = -1
+    msgs = {
+        "W7481": (
+            "Test fixture files should be loaded asynchronously",
+            "hass-async-load-fixtures",
+            "Used when a test fixture file is loaded synchronously",
+        ),
+    }
+    options = ()
+
+    _decorators_queue: list[nodes.Decorators]
+    _function_queue: list[nodes.FunctionDef | nodes.AsyncFunctionDef]
+    _in_test_module: bool
+
+    def visit_module(self, node: nodes.Module) -> None:
+        """Visit a module definition."""
+        self._in_test_module = node.name.startswith("tests.")
+        self._decorators_queue = []
+        self._function_queue = []
+
+    def visit_decorators(self, node: nodes.Decorators) -> None:
+        """Visit a function definition."""
+        self._decorators_queue.append(node)
+
+    def leave_decorators(self, node: nodes.Decorators) -> None:
+        """Leave a function definition."""
+        self._decorators_queue.pop()
+
+    def visit_functiondef(self, node: nodes.FunctionDef) -> None:
+        """Visit a function definition."""
+        self._function_queue.append(node)
+
+    def leave_functiondef(self, node: nodes.FunctionDef) -> None:
+        """Leave a function definition."""
+        self._function_queue.pop()
+
+    visit_asyncfunctiondef = visit_functiondef
+    leave_asyncfunctiondef = leave_functiondef
+
+    def visit_call(self, node: nodes.Call) -> None:
+        """Check for sync I/O in load_fixture."""
+        if (
+            # Ensure we are in a test module
+            not self._in_test_module
+            # Ensure we are in an async function context
+            or not self._function_queue
+            or not isinstance(self._function_queue[-1], nodes.AsyncFunctionDef)
+            # Ensure we are not in the decorators
+            or self._decorators_queue
+            # Check function name
+            or not isinstance(node.func, nodes.Name)
+            or node.func.name not in FUNCTION_NAMES
+        ):
+            return
+
+        self.add_message("hass-async-load-fixtures", node=node)
+
+
+def register(linter: PyLinter) -> None:
+    """Register the checker."""
+    linter.register_checker(HassLoadFixturesChecker(linter))
diff --git a/pyproject.toml b/pyproject.toml
index d97bf3e1890..7ab0e89bce5 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -118,6 +118,7 @@ init-hook = """\
 load-plugins = [
   "pylint.extensions.code_style",
   "pylint.extensions.typing",
+  "hass_async_load_fixtures",
   "hass_decorator",
   "hass_enforce_class_module",
   "hass_enforce_sorted_platforms",
diff --git a/tests/util/test_location.py b/tests/util/test_location.py
index ecb54eeeaa9..61d879f3827 100644
--- a/tests/util/test_location.py
+++ b/tests/util/test_location.py
@@ -9,7 +9,7 @@ from homeassistant.core import HomeAssistant
 from homeassistant.helpers.aiohttp_client import async_get_clientsession
 from homeassistant.util import location as location_util
 
-from tests.common import load_fixture
+from tests.common import async_load_fixture
 from tests.test_util.aiohttp import AiohttpClientMocker
 
 # Paris
@@ -77,10 +77,14 @@ def test_get_miles() -> None:
 
 
 async def test_detect_location_info_whoami(
-    aioclient_mock: AiohttpClientMocker, session: aiohttp.ClientSession
+    hass: HomeAssistant,
+    aioclient_mock: AiohttpClientMocker,
+    session: aiohttp.ClientSession,
 ) -> None:
     """Test detect location info using services.home-assistant.io/whoami."""
-    aioclient_mock.get(location_util.WHOAMI_URL, text=load_fixture("whoami.json"))
+    aioclient_mock.get(
+        location_util.WHOAMI_URL, text=await async_load_fixture(hass, "whoami.json")
+    )
 
     with patch("homeassistant.util.location.HA_VERSION", "1.0"):
         info = await location_util.async_detect_location_info(session, _test_real=True)
@@ -101,10 +105,14 @@ async def test_detect_location_info_whoami(
 
 
 async def test_dev_url(
-    aioclient_mock: AiohttpClientMocker, session: aiohttp.ClientSession
+    hass: HomeAssistant,
+    aioclient_mock: AiohttpClientMocker,
+    session: aiohttp.ClientSession,
 ) -> None:
     """Test usage of dev URL."""
-    aioclient_mock.get(location_util.WHOAMI_URL_DEV, text=load_fixture("whoami.json"))
+    aioclient_mock.get(
+        location_util.WHOAMI_URL_DEV, text=await async_load_fixture(hass, "whoami.json")
+    )
     with patch("homeassistant.util.location.HA_VERSION", "1.0.dev0"):
         info = await location_util.async_detect_location_info(session, _test_real=True)