"""Shared pytest fixtures for the BanGUI backend test suite.

All fixtures are async-compatible via pytest-asyncio.  External dependencies
(fail2ban socket, HTTP APIs) are always mocked so tests never touch real
infrastructure.
"""

from __future__ import annotations

import sys
from pathlib import Path

# Ensure the bundled fail2ban package is importable.
_FAIL2BAN_MASTER: Path = Path(__file__).resolve().parents[2] / "fail2ban-master"
if str(_FAIL2BAN_MASTER) not in sys.path:
    sys.path.insert(0, str(_FAIL2BAN_MASTER))

import pytest
from httpx import ASGITransport, AsyncClient

from app.config import Settings
from app.main import create_app


@pytest.fixture
def test_settings(tmp_path: Path) -> Settings:
    """Return a ``Settings`` instance configured for testing.

    Uses a temporary directory for the database so tests are isolated from
    each other and from the development database.

    Args:
        tmp_path: Pytest-provided temporary directory (unique per test).

    Returns:
        A :class:`~app.config.Settings` instance with overridden paths.
    """
    return Settings(
        database_path=str(tmp_path / "test_bangui.db"),
        fail2ban_socket="/tmp/fake_fail2ban.sock",
        session_secret="test-secret-key-do-not-use-in-production",
        session_duration_minutes=60,
        timezone="UTC",
        log_level="debug",
    )


@pytest.fixture
async def client(test_settings: Settings) -> AsyncClient:
    """Provide an ``AsyncClient`` wired to a test instance of the BanGUI app.

    The client sends requests directly to the ASGI application (no network).
    A fresh database is created for each test.

    Args:
        test_settings: Injected test settings fixture.

    Yields:
        An :class:`httpx.AsyncClient` with ``base_url="http://test"``.
    """
    app = create_app(settings=test_settings)
    transport: ASGITransport = ASGITransport(app=app)
    async with AsyncClient(transport=transport, base_url="http://test") as ac:
        yield ac