"""配置加载器。

从 tests/config/test_config.yaml 读取配置，提供类型安全的访问接口。

Usage:
    from tests.config.test_config import load_config

    config = load_config()
    admin_url = config["admin"]["base_url"]
    admin_phone = config["accounts"]["super_admin"]["phone"]

各端通过 fixture 直接引用对应 section:
    def test_xxx(admin_config):
        page.goto(admin_config["base_url"])
"""

from pathlib import Path
from typing import Any, Dict

import yaml

_CONFIG_PATH = Path(__file__).parent / "test_config.yaml"
_cache: Dict[str, Any] | None = None


def load_config(force_reload: bool = False) -> Dict[str, Any]:
    """加载测试配置（带缓存，force_reload=True 可强制重载）。"""
    global _cache
    if _cache is not None and not force_reload:
        return _cache

    if not _CONFIG_PATH.exists():
        raise FileNotFoundError(f"配置文件不存在: {_CONFIG_PATH}")

    with open(_CONFIG_PATH, encoding="utf-8") as f:
        _cache = yaml.safe_load(f)

    return _cache


def get_config_section(section: str) -> Dict[str, Any]:
    """获取配置中指定 section 的字典。"""
    config = load_config()
    if section not in config:
        raise KeyError(f"配置中不存在 section '{section}'，可用: {list(config.keys())}")
    return config[section]
