Files
xiaobaifupan/app/tools/build_api_registry.py
T

108 lines
3.8 KiB
Python

from __future__ import annotations
import argparse
import json
import re
import sys
from pathlib import Path
ROOT = Path(__file__).resolve().parents[1]
OUTPUT = ROOT / "config" / "api.config.json"
if str(ROOT) not in sys.path:
sys.path.insert(0, str(ROOT))
def _owner(path: str) -> str:
ordered = (
("/api/health", "health"),
("/api/auth", "auth"),
("/api/admin", "admin"),
("/api/account", "account"),
("/api/sentiment", "sentiment"),
("/api/dashboard", "market"),
("/api/realtime-aggregate", "market"),
("/api/rotation", "rotation"),
("/api/auction", "auction"),
("/api/themes", "themes"),
("/api/popularity", "popularity"),
("/api/dragon-tiger", "dragon_tiger"),
("/api/search", "search"),
("/api/chart", "charts"),
("/api/stock", "market"),
("/api/screener", "screener"),
("/api/mentors", "mentor"),
("/api/heaven", "heaven"),
("/api/alerts", "alerts"),
("/api/trades", "review"),
("/api/assistant", "review"),
("/api/watchlist", "review"),
("/api/notes", "review"),
("/api/reasons", "admin"),
("/api/seat-aliases", "admin"),
("/api/backfill", "admin"),
)
for prefix, owner in ordered:
if path.startswith(prefix):
return owner
raise ValueError(f"API owner is not registered: {path}")
def _role(method: str, path: str) -> str:
if path == "/api/health" or path in {"/api/auth/register", "/api/auth/login"}:
return "public"
from api_access import required_role
sample = re.sub(r"\\d\{6\}", "000001", path)
sample = re.sub(r"\\d\+", "1", sample)
sample = sample.replace("(.+)", "sample").replace("(", "").replace(")", "")
return required_role(method, sample)
def build() -> dict:
text = (ROOT / "server.py").read_text(encoding="utf-8")
method_matches = list(re.finditer(r"^ def do_(GET|POST|DELETE)\(", text, re.MULTILINE))
routes = []
for index, match in enumerate(method_matches):
method = match.group(1)
end = method_matches[index + 1].start() if index + 1 < len(method_matches) else len(text)
block = text[match.start():end]
exact_paths = set(re.findall(r'parsed\.path\s*==\s*"(/api/[^"]+)"', block))
patterns = set(
re.findall(
r're\.(?:fullmatch|match)\(\s*r?["\']([^"\']*?/api/[^"\']+)["\']\s*,\s*parsed\.path',
block,
)
)
for path in sorted(exact_paths):
routes.append(
{"method": method, "path": path, "match": "exact", "feature": _owner(path), "access": _role(method, path)}
)
for path in sorted(patterns):
normalized = path.replace("^", "").replace("$", "")
routes.append(
{"method": method, "path": normalized, "match": "regex", "feature": _owner(normalized), "access": _role(method, normalized)}
)
routes.sort(key=lambda item: (item["path"], item["method"], item["match"]))
return {"schema_version": 1, "generated_from": "server.py", "routes": routes}
def main() -> int:
parser = argparse.ArgumentParser(description="Build the transitional API ownership registry")
parser.add_argument("--check", action="store_true")
args = parser.parse_args()
rendered = json.dumps(build(), ensure_ascii=False, indent=2) + "\n"
if args.check:
if not OUTPUT.exists() or OUTPUT.read_text(encoding="utf-8") != rendered:
raise SystemExit("API registry is stale; run tools/build_api_registry.py")
print("API registry is current.")
return 0
OUTPUT.parent.mkdir(parents=True, exist_ok=True)
OUTPUT.write_text(rendered, encoding="utf-8")
print(OUTPUT.relative_to(ROOT).as_posix())
return 0
if __name__ == "__main__":
raise SystemExit(main())