ru-python/generate_docs.py at main · suscersal/ru-python · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
from pathlib import Path
import json
import html
import re

snippets_file = Path("rus-python/snippets/rupy-words.json")

def esc(s):
    return html.escape(str(s))

def strip_placeholders(text):
    text = str(text)
    # ${1:default} → default
    text = re.sub(r'\$\{(\d+):([^}]*)\}', r'\2', text)
    # ${1|a,b|} → a,b
    text = re.sub(r'\$\{\d+\|([^}]*)\}', r'\1', text)
    # ${0}, ${1} → ''
    text = re.sub(r'\$\{\d+\}', '', text)
    # $0, $1 → ''
    text = re.sub(r'\$\d+', '', text)
    return text

def clean_body(body):
    if isinstance(body, list):
        return "\n".join(strip_placeholders(line) for line in body)
    return strip_placeholders(body)

def build_index():
    return """<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8">
<meta http-equiv="refresh" content="0; url=documentation.html">
<title>Ru-Python</title>
</head>
<body>
<p>Redirecting to <a href="documentation.html">documentation.html</a>...</p>
</body>
</html>
"""

def build_documentation():
    parts = ["""<!DOCTYPE html>
<html lang="ru">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Snippets документация</title>
<style>
body { font-family: Arial, sans-serif; max-width: 1000px; margin: 0 auto; padding: 20px; background: #f6f8fa; }
.container { background: white; padding: 24px; border-radius: 12px; }
.snippet { border: 1px solid #ddd; border-radius: 10px; padding: 16px; margin: 16px 0; background: #fafbfc; }
.title { font-size: 28px; margin: 0 0 20px; }
.name { font-size: 20px; font-weight: 700; margin: 0 0 10px; }
.meta { margin: 6px 0; color: #555; line-height: 1.5; white-space: pre-wrap; }
pre { background: #1e1e1e; color: #fff; padding: 14px; border-radius: 6px; overflow-x: auto; margin: 12px 0 0; white-space: pre-wrap; }
code { font-family: Consolas, monospace; white-space: pre-wrap; }
a { color: #0969da; text-decoration: none; }
</style>
</head>
<body>
<div class="container">
<p><a href="index.html">← На главную</a></p>
<h1 class="title">Snippets документация</h1>
"""]

    count = 0
    if snippets_file.exists():
        data = json.loads(snippets_file.read_text(encoding="utf-8"))
        for name, item in data.items():
            description = item.get("description", "")
            body_text = clean_body(item.get("body", ""))
            parts.append(f"""
<div class="snippet">
<div class="name">{esc(name)}</div>
<div class="meta"><b>Description:</b> {esc(description)}</div>
<pre><code>{esc(body_text)}</code></pre>
</div>
""")
            count += 1
    else:
        parts.append("<p>Файл rupy-words.json не найден.</p>")

    parts.append(f"<p>Всего snippets: {count}</p>\n</div>\n</body>\n</html>")
    return "".join(parts)

Path("index.html").write_text(build_index(), encoding="utf-8")
Path("documentation.html").write_text(build_documentation(), encoding="utf-8")
print("Generated index.html and documentation.html")