mirror of
https://github.com/pomerium/pomerium.git
synced 2025-06-14 08:42:51 +02:00
e0b90a0750
* init console-specific reference docs files * remove shortdoc for name * init Enterprise Reference doc
42 lines
1 KiB
Python
Executable file
42 lines
1 KiB
Python
Executable file
#!/usr/bin/env python3
|
|
import os.path
|
|
from typing import Any, IO
|
|
import yaml
|
|
|
|
|
|
def main():
|
|
d = os.path.join(os.path.dirname(__file__),
|
|
"..", "docs", "enterprise")
|
|
d = os.path.normpath(d)
|
|
print(f"generating {d}/reference.md")
|
|
|
|
f = open(os.path.join(d, "console-settings.yaml"))
|
|
doc = yaml.full_load(f)
|
|
f.close()
|
|
|
|
f = open(os.path.join(os.path.dirname(__file__),
|
|
"..", "docs", "enterprise", "reference.md"), "w")
|
|
f.write(f"{doc['preamble']}\n")
|
|
write_setting(f, 1, doc)
|
|
f.write(f"{doc['postamble']}")
|
|
f.close()
|
|
|
|
|
|
def write_setting(w, depth, setting):
|
|
if 'name' in setting:
|
|
w.write(f"{'#' * depth} {setting.get('name', '')}\n")
|
|
|
|
if 'attributes' in setting:
|
|
w.write(f"{setting.get('attributes','')}\n")
|
|
|
|
if 'doc' in setting:
|
|
w.write(f"{setting.get('doc', '')}\n")
|
|
|
|
w.write("\n")
|
|
|
|
for subsetting in setting.get('settings', []):
|
|
write_setting(w, depth+1, subsetting)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
main()
|