from __future__ import annotations

import re

from pathlib import Path

from typing import Any

import yaml

from tools.catalog import load_catalog

from tools.content_manifest import build_manifest

ROOT = Path(__file__).resolve().parents[1]

# flypython.com links are first-party contextual continuations governed by

# docs/REPO_TO_WEBSITE.md, not catalog references.

FIRST_PARTY_PREFIX = "https://flypython.com"

def _extract_frontmatter(path: Path) -> dict[str, Any]:

text = path.read_text(encoding="utf-8")

assert text.startswith("---\n"), f"{path} must start with frontmatter"

parts = text.split("---\n", maxsplit=2)

return yaml.safe_load(parts[1])

def test_content_manifest_builds_without_errors() -> None:

manifest = build_manifest(ROOT)

assert manifest["schema_version"] == 1

assert len(manifest["documents"]) >= 10

def test_bilingual_guide_urls_are_in_catalog() -> None:

catalog = load_catalog(ROOT / "catalog")

catalog_urls = {resource["url"] for resource in catalog["resources"]}

for guide_path in ROOT.glob("guides/**/*.md"):

if guide_path.name == "README.md" or guide_path.name == "README_cn.md":

continue

text = guide_path.read_text(encoding="utf-8")

external_urls = set(re.findall(r"\]\((https://[^)]+)\)", text))

for url in external_urls:

if url.startswith(FIRST_PARTY_PREFIX):

continue

assert url in catalog_urls, (

f"Guide {guide_path.relative_to(ROOT)} references unreviewed URL: {url}"

)