#!/usr/bin/env python3 """Индекс документации: 946 файлов → одна навигация. Для каждого .md собирает: первую строку-заголовок, размер, дату изменения. Группирует по каталогу. Пишет ops/INDEX.md. Запуск: python3 ops/scripts/build_docs_index.py """ import datetime import os import re ROOT = "/root/buryan-infra" OUT = os.path.join(ROOT, "ops/INDEX.md") SKIP_DIRS = {".git", "node_modules", "__pycache__", "rag", ".venv"} def title_of(path): try: with open(path, encoding="utf-8", errors="ignore") as f: for line in f: s = line.strip() if s.startswith("#"): return re.sub(r"^#+\s*", "", s)[:90] if s and not s.startswith(("---", "```")): return s[:90] except Exception: pass return "" def main(): groups = {} total = 0 for dirpath, dirnames, filenames in os.walk(os.path.join(ROOT, "ops")): dirnames[:] = [d for d in dirnames if d not in SKIP_DIRS] for fn in filenames: if not fn.endswith(".md"): continue p = os.path.join(dirpath, fn) rel = os.path.relpath(p, ROOT) if rel == "ops/INDEX.md": continue try: st = os.stat(p) except OSError: continue groups.setdefault(os.path.relpath(dirpath, ROOT), []).append({ "rel": rel, "title": title_of(p), "size": st.st_size, "mtime": st.st_mtime, }) total += 1 lines = ["# Индекс документации", "", "Сгенерировано: %s · файлов: **%d** · генератор: `ops/scripts/build_docs_index.py`" % (datetime.datetime.now().strftime("%Y-%m-%d %H:%M"), total), "", "Навигация по каталогам. Свежие файлы — сверху."] for d in sorted(groups): items = sorted(groups[d], key=lambda x: -x["mtime"]) fresh = sum(1 for i in items if i["mtime"] > datetime.datetime.now().timestamp() - 7 * 86400) lines.append("") lines.append("## %s — %d файлов (%d за неделю)" % (d, len(items), fresh)) lines.append("") lines.append("| Документ | О чём | Изменён |") lines.append("|---|---|---|") for i in items[:40]: date = datetime.datetime.fromtimestamp(i["mtime"]).strftime("%d.%m") name = i["rel"].split("/")[-1] lines.append("| [%s](%s) | %s | %s |" % (name, i["rel"], (i["title"] or "—").replace("|", "/")[:70], date)) if len(items) > 40: lines.append("| … ещё %d | | |" % (len(items) - 40)) open(OUT, "w", encoding="utf-8").write("\n".join(lines) + "\n") print("записано:", OUT) print("файлов:", total, "| каталогов:", len(groups)) print("размер индекса:", os.path.getsize(OUT) // 1024, "КБ") if __name__ == "__main__": main()