# -*- coding: utf-8 -*-
"""
README.md 结构完整性属性测试

**Validates: Requirements 1.5**

Property 1: 对于任意 Monorepo 一级目录，其 README.md 文件应存在
且包含"作用说明"、"结构描述"和"Roadmap"三个段落。
"""
import os
import re

from hypothesis import given, settings
from hypothesis.strategies import sampled_from

# Monorepo 根目录
MONOREPO_ROOT = r"C:\Project\NeoZQYY"

# 一级目录列表（需求 1.5 定义）
# 仅包含实际存在的一级目录
TOP_LEVEL_DIRS = [
    "apps",
    "packages",
    "db",
    "docs",
    "infra",
    "scripts",
    "samples",
    "tests",
]


@settings(max_examples=100)
@given(dir_name=sampled_from(TOP_LEVEL_DIRS))
def test_readme_structure_completeness(dir_name: str) -> None:
    """
    Property 1: README.md 结构完整性

    **Validates: Requirements 1.5**

    对于任意一级目录，验证：
    1. README.md 文件存在
    2. 包含"作用说明"段落标题
    3. 包含"内部结构"或"结构"段落标题
    4. 包含"Roadmap"段落标题
    """
    readme_path = os.path.join(MONOREPO_ROOT, dir_name, "README.md")

    # README.md 必须存在
    assert os.path.isfile(readme_path), (
        f"{dir_name}/README.md 不存在: {readme_path}"
    )

    content = open(readme_path, encoding="utf-8").read()

    # 包含"作用说明"段落标题
    assert re.search(r"^#{1,3}\s*作用说明", content, re.MULTILINE), (
        f"{dir_name}/README.md 缺少'作用说明'段落"
    )

    # 包含"结构"相关段落标题（内部结构 或 结构）
    assert re.search(r"^#{1,3}\s*(内部)?结构", content, re.MULTILINE), (
        f"{dir_name}/README.md 缺少'结构'段落"
    )

    # 包含"Roadmap"段落标题
    assert re.search(r"^#{1,3}\s*Roadmap", content, re.MULTILINE | re.IGNORECASE), (
        f"{dir_name}/README.md 缺少'Roadmap'段落"
    )
