docs: add script to generate config snippets

1 files changed, 47 insertions, 0 deletions

diff --git a/tools/gen-config-doc.py b/tools/gen-config-doc.py
new file mode 100644
index 000000000..a0f3014b0
--- /dev/null
+++ b/tools/gen-config-doc.py
@@ -0,0 +1,47 @@
+#!/usr/bin/python
+
+import re
+
+
+def get_config_key_descriptions():
+    desc_re = re.compile(r"(/\*\*\n|\s+\*/|\s+\*)")
+    key_match_re = re.compile(r"\(\n(.+)\);", re.DOTALL)
+    key_split_re = re.compile(r",\s+", re.DOTALL)
+    snippets = []
+
+    with open("../src/main/java/org/traccar/config/Keys.java", "r") as f:
+        code = f.read()
+        config = re.findall(
+            r"(/\*\*.*?\*/)\n\s+(public static final Config.*?;)", code, re.DOTALL
+        )
+        for i in config:
+            try:
+                key_match = key_match_re.search(i[1])
+                if key_match:
+                    description = desc_re.sub("", i[0]).strip()
+                    terms = [x.strip() for x in key_split_re.split(key_match.group(1))]
+                    key = terms[0].replace('"', "")
+                    default = terms[2] if len(terms) == 3 else None
+                    snippets.append(
+                        f"""        <div class="card mt-3">
+          <div class="card-body">
+              <h5 class="card-title">
+                {key} <span class="badge badge-dark">config</span>
+              </h5>
+              <p class="card-text">
+                {description}{f" Default: {default}" if default else ""}
+              </p>
+          </div>
+        </div>"""
+                    )
+            except IndexError:
+                # will continue if key_match.group(1) or terms[0] does not exist
+                # for some reason
+                pass
+
+    return ("\n").join(snippets)
+
+
+if __name__ == "__main__":
+    html = get_config_key_descriptions()
+    print(html)