Incredibly impressed, good job

Author: TrentHouliston

.gitignore

@@ -31,3 +31,5 @@ site/
 
 # Node modules
 node_modules/
+.playwright-mcp/
+tests/guides/*/screenshots/*

pyproject.toml

@@ -9,8 +9,10 @@ dependencies = ["homeassistant>=2025.12.2", "numpy>=2.3.2", "highspy>=1.12.0"]
 
 [dependency-groups]
 dev = [
+    "beautifulsoup4>=4.14.3",
     "freezegun>=1.5.2",
     "matplotlib>=3.10.8",
+    "playwright>=1.57.0",
     "mdformat-beautysh>=1.0.0",
     "mdformat-config>=0.2.1",
     "mdformat-footnote>=0.1.1",
@@ -130,6 +132,7 @@ asyncio_mode = "auto"
 addopts = ["--strict-markers", "--strict-config", "--disable-warnings"]
 markers = [
     "scenario: marks tests as scenario tests (select with '-m \"scenario\"')",
+    "browser: marks tests as browser automation tests (select with '-m \"browser\"')",
 ]
 
 [tool.coverage.run]

tests/guides/__init__.py

@@ -0,0 +1 @@
+"""Guide tests with browser automation and live Home Assistant."""

tests/guides/conftest.py

@@ -0,0 +1,20 @@
+"""Configuration for guide tests.
+
+Guide tests are designed to run Home Assistant in-process with browser
+automation. They do NOT use pytest-homeassistant-custom-component fixtures
+since they need a full HTTP server for Playwright.
+
+These tests should be run with:
+    uv run python tests/guides/<test_file>.py
+
+Or via pytest with explicit socket enabling:
+    uv run pytest tests/guides/ --force-enable-socket -m guide
+"""
+
+
+def pytest_configure(config):
+    """Register guide marker."""
+    config.addinivalue_line(
+        "markers",
+        "guide: mark test as a guide test (runs full HA with HTTP, needs network)",
+    )