mirror of
https://github.com/kuhyx/testsAndMisc.git
synced 2026-11-13 20:30:47 +01:00
Krzysztof kuhy Rudnicki
6342eaf0e2
Ranks the codecrafters build-your-own-x projects by difficulty and emits two offline, self-contained HTML pages: a per-guide ladder (~360 tutorials) and a per-category ladder (30 categories), grouped into Beginner/Intermediate/Advanced/ Expert tiers plus an Unsorted bucket. A guide inherits its category's tier; language only nudges order within a tier. Includes a Makefile pipeline (fetch -> parse -> build) and 100%-branch-covered tests. Excludes the generated guide page from codespell since it inlines upstream titles verbatim. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QNRTPNYvoBTQoTEWkYtCJD
81 lines
2.9 KiB
Python
Executable File
81 lines
2.9 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
"""Build the standalone HTML ladder pages from templates and parsed guide data.
|
|
|
|
Produces two self-contained, dependency-free pages next to this script:
|
|
|
|
* ``guide-ladder.html`` — every individual guide, built by injecting
|
|
``guides.json`` (written by ``parse_guides.py``) into the guide template.
|
|
* ``category-ladder.html`` — the 30-category ladder, a static template.
|
|
|
|
Both are wrapped in a minimal HTML document skeleton so they open directly via
|
|
``file://`` with no server, fonts, or network access. Run ``make build`` to
|
|
regenerate the whole pipeline.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
import logging
|
|
from pathlib import Path
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
HERE = Path(__file__).resolve().parent
|
|
TEMPLATES = HERE / "templates"
|
|
GUIDES_JSON = HERE / "guides.json"
|
|
|
|
# Placeholder in the guide template that the inlined dataset replaces.
|
|
MARKER = "/*__GUIDES__*/"
|
|
|
|
# Minimal, valid document skeleton added around the published page content
|
|
# (claude.ai injects an equivalent wrapper; local files need their own).
|
|
SKELETON_HEAD = (
|
|
"<!doctype html>\n"
|
|
'<html lang="en">\n'
|
|
"<head>\n"
|
|
'<meta charset="utf-8">\n'
|
|
'<meta name="viewport" content="width=device-width, initial-scale=1">\n'
|
|
)
|
|
SKELETON_TAIL = "\n</html>\n"
|
|
|
|
|
|
def standalone(content: str) -> str:
|
|
"""Wrap page content in a minimal HTML document skeleton."""
|
|
return SKELETON_HEAD + content + SKELETON_TAIL
|
|
|
|
|
|
def build_guide_page() -> str:
|
|
"""Inject ``guides.json`` into the guide template; return standalone HTML."""
|
|
guides = json.loads(GUIDES_JSON.read_text(encoding="utf-8"))
|
|
# Compact payload; guard any "</" so inline data can't close the script tag.
|
|
payload = json.dumps(guides, separators=(",", ":")).replace("</", "<\\/")
|
|
template = (TEMPLATES / "guide.template.html").read_text(encoding="utf-8")
|
|
if MARKER not in template:
|
|
message = f"marker {MARKER!r} not found in guide template"
|
|
raise ValueError(message)
|
|
return standalone(template.replace(MARKER, f"const GUIDES = {payload};"))
|
|
|
|
|
|
def build_category_page() -> str:
|
|
"""Return the standalone category ladder (static content, no data)."""
|
|
content = (TEMPLATES / "category.html").read_text(encoding="utf-8")
|
|
return standalone(content)
|
|
|
|
|
|
def main() -> int:
|
|
"""Write both standalone ladder pages next to this script; return an exit code."""
|
|
if not GUIDES_JSON.exists():
|
|
logger.error(
|
|
"missing %s — run parse_guides.py first (or make build)", GUIDES_JSON
|
|
)
|
|
return 1
|
|
(HERE / "guide-ladder.html").write_text(build_guide_page(), encoding="utf-8")
|
|
(HERE / "category-ladder.html").write_text(build_category_page(), encoding="utf-8")
|
|
logger.info("wrote guide-ladder.html and category-ladder.html")
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
logging.basicConfig(level=logging.INFO, format="%(message)s")
|
|
raise SystemExit(main())
|