summaryrefslogtreecommitdiffstats
path: root/scripts/generate-rst-options.py
blob: 3a13074899fff7c0e9737451a62f1d785598c789 (plain)
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
import json
import sys
import re

header = """
Mailserver Options
==================

mailserver
~~~~~~~~~~

"""

template = """
{key}
{line}

{description}

{type}
{default}
"""

f = open(sys.argv[1])
options = json.load(f)

options = {k: v for k, v in options.items()
           if k.startswith("mailserver.")}

groups = ["mailserver.loginAccount",
          "mailserver.certificate",
          "mailserver.dkim",
          "mailserver.fullTextSearch",
          "mailserver.redis",
          "mailserver.monitoring",
          "mailserver.backup",
          "mailserver.borg"]


def print_option(name, value):
    if 'default' in value:
        if value['default'] == "":
            default = '- Default: ``""``'
        else:
            default = '- Default: ``{}``'.format(v['default'])
            # Some default values contains OUTPUTPATHS which make the
            # output not stable across nixpkgs updates.
            default = re.sub('/nix/store/[\w.-]*/', '<OUTPUT-PATH>/', default)  # noqa
    else:
        default = ""
    print(template.format(
        key=name,
        line="-"*len(name),
        description=value['description'],
        type="- Type: ``{}``".format(value['type']),
        default=default))


print(header)
for k, v in options.items():
    if any([k.startswith(c) for c in groups]):
        continue
    print_option(k, v)

for c in groups:
    print(c)
    print("~"*len(c))
    print()
    for k, v in options.items():
        if k.startswith(c):
            print_option(k, v)