Cover llms txt generation check (#3555)

* Cover llms txt generation check

* Normalize llms txt doc paths

Author: koxudaxi

scripts/build_llms_txt.py

@@ -129,7 +129,12 @@ def extract_page_info(md_path: Path, url: str, depth: int = 0) -> PageInfo | Non
     if len(desc) > MAX_DESC_LEN:
         desc = desc[: MAX_DESC_LEN - 3] + "..."
     return PageInfo(
-        title=title, path=str(md_path.relative_to(DOCS_DIR)), url=url, description=desc, content=content, depth=depth
+        title=title,
+        path=md_path.relative_to(DOCS_DIR).as_posix(),
+        url=url,
+        description=desc,
+        content=content,
+        depth=depth,
     )
 
 

tests/test_build_llms_txt_script.py

@@ -0,0 +1,14 @@
+"""Tests for llms.txt documentation generation."""
+
+from __future__ import annotations
+
+import subprocess
+import sys
+from pathlib import Path
+
+SCRIPT = Path(__file__).resolve().parents[1] / "scripts" / "build_llms_txt.py"
+
+
+def test_build_llms_txt_check_is_up_to_date() -> None:
+    """Generated llms.txt files are committed."""
+    subprocess.run([sys.executable, str(SCRIPT), "--check"], check=True)