conftest.py

"""Pytest configuration and fixtures for driver testing."""

import yaml
from pathlib import Path

import pytest

pytest_plugins = ["tests.report_plugin"]


def pytest_addoption(parser):
    parser.addoption(
        "--port",
        action="store",
        default=None,
        help="Serial port for hardware tests (e.g. /dev/ttyACM0)",
    )
    parser.addoption(
        "--driver",
        action="store",
        default=None,
        help="Run tests for a specific driver only (e.g. hts221)",
    )


def pytest_configure(config):
    config.addinivalue_line("markers", "mock: tests that run with FakeI2C (no hardware)")
    config.addinivalue_line("markers", "hardware: tests that require a real board")
    config.addinivalue_line("markers", "manual: tests that require human validation")
    config.addinivalue_line("markers", "board: board qualification tests (no driver, hardware only)")


def pytest_collection_modifyitems(config, items):
    port = config.getoption("--port")
    driver = config.getoption("--driver")
    skip_hardware = pytest.mark.skip(reason="needs --port to run hardware tests")

    selected = []
    for item in items:
        # Filter by driver if --driver is specified
        if driver and f"[{driver}/" not in item.nodeid:
            continue
        if "hardware" in item.keywords and not port:
            item.add_marker(skip_hardware)
        selected.append(item)

    items[:] = selected


@pytest.fixture
def port(request):
    return request.config.getoption("--port")


def load_scenarios():
    """Load all YAML scenario files from tests/scenarios/."""
    scenarios_dir = Path(__file__).parent / "scenarios"
    scenarios = []
    for yaml_file in sorted(scenarios_dir.glob("*.yaml")):
        with open(yaml_file, encoding="utf-8") as f:
            scenario = yaml.safe_load(f)
            scenario["_file"] = yaml_file.name
            scenarios.append(scenario)
    return scenarios


@pytest.fixture
def mpremote_bridge(port):
    """Create a MpremoteBridge connected to the board."""
    from tests.runner.mpremote_bridge import MpremoteBridge

    return MpremoteBridge(port=port)