"""Allure 集成辅助 — 截图附件 + 报告环境信息。

allure-pytest 未安装时所有函数静默降级（截图仍保存到本地文件）。
"""

from pathlib import Path

try:
    import allure
except ImportError:  # pragma: no cover
    allure = None


def attach_png(path: str, name: str = "screenshot") -> None:
    """把 PNG 文件附加到 Allure 报告当前用例/步骤上。"""
    if allure is None:
        return
    try:
        allure.attach.file(path, name=name, attachment_type=allure.attachment_type.PNG)
    except Exception:
        pass  # 附件失败不影响用例主流程


def write_environment_properties(results_dir: str, config: dict) -> None:
    """向 allure-results 目录写入 environment.properties（报告环境页展示）。"""
    if not results_dir:
        return
    admin = config.get("admin", {})
    lines = [
        f"base_url={admin.get('base_url', '')}",
        f"browsers={','.join(admin.get('browsers', []))}",
        f"skip_login={admin.get('skip_login', '')}",
        "platform=Windows",
        "project=运八网络货运平台",
    ]
    # Allure 按 ISO-8859-1 解析 properties，非 ASCII 内容转 \uXXXX 防乱码
    content = "\n".join(lines) + "\n"
    content = content.encode("ascii", "backslashreplace").decode("ascii")
    out_dir = Path(results_dir)
    out_dir.mkdir(parents=True, exist_ok=True)
    (out_dir / "environment.properties").write_text(content, encoding="ascii")