add new module: help (allows to get manual pages for commands)

modules/help/db/hardsub.txt

@@ -0,0 +1,5 @@
+Usage: !hardsub [event_name]
+
+Permanently subscribes to [event_name]. If blank, uses "default".
+To unsubscribe, use !hardunsub
+For one-time subscriptions, use !sub

modules/help/db/hardunsub.txt

@@ -0,0 +1,5 @@
+Usage: !hardunsub [event_name]
+
+Remove permanent subscription to [event_name]. If blank, uses "default".
+To remove one-time subscription, use !unsub
+To add permanent subscription, use !hardsub

modules/help/db/schedule-ctl.txt

@@ -0,0 +1,5 @@
+Usage:
+    !schedule-ctl list                  - see all settings
+    !schedule-ctl get <setting>         - see specific personal setting
+    !schedule-ctl set <setting> <value> - change <setting> to <value>
+    !schedule-ctl clear <setting>       - restore <setting> to default value

modules/help/db/sub.txt

@@ -0,0 +1,7 @@
+Usage: !sub [event_name]
+
+Soft-subscribes to [event_name]. If black, uses "default".
+If you want to remove soft substription, use !unsub
+
+Soft subscription is automatically removed after the event is triggered once.
+If you want to subscribe permanently, use !hardsub

modules/help/db/unsub.txt

@@ -0,0 +1,5 @@
+Usage: !unsub [event_name]
+
+Removes one-time subscription to [event_name]. If blank, uses "default".
+Does not affect hard subscriptions. To remove hard subscription, use !hardunsub
+To add one-time supscription, use !sub

modules/help/index.py

@@ -0,0 +1,54 @@
+import json
+import os
+
+module_path = ""
+
+def readfile(filename):
+    if os.path.exists(module_path + filename):
+        return open(module_path + filename).read()
+    else:
+        return False
+
+def list_entries(search_query):
+    files = []
+    for p, d, f in os.walk(module_path + "db/"):
+        for i in f:
+            entry_name = f"{p.split('/', 3)[3]}/{i}"
+            if search_query in entry_name:
+                files.append(f"{p.split('/', 3)[3]}/{i}".rsplit(".", 1)[0].replace("/", ".").lstrip("."))
+
+    files.sort()
+    return files
+
+def process(message, path):
+    if message.text[:5] != "!help":
+        return None, None
+
+    global module_path
+    module_path = path
+
+    cmd = message.text[1:].split()
+
+    if len(cmd) == 1:
+        return "Usage:\n```\n!help show <entry> - displays specified manual entry\n!help list [query] - lists out available entries (optionally, filtered by [query])```", "Markdown"
+
+    elif cmd[1] == "list":
+        if len(cmd) == 2:
+            return "Available entries:\n" + "\n".join(list_entries("")), None
+        else:
+            return f"Found entries for {cmd[2]}:\n" + "\n".join(list_entries(cmd[2])), None
+
+    elif cmd[1] == "show":
+        if len(cmd) >= 3:
+            result = ""
+            for entry_name in cmd[2:]:
+                data = readfile("db/" + entry_name.replace(".", "/") + ".txt")
+
+                if data:
+                    result += f"Manual page for {entry_name}:\n```\n{data}```\n"
+                else:
+                    result += f"No manual found for {entry_name}\n\n"
+
+            return result, "Markdown"
+        else:
+            return "Usage: !help show <entry> - displays specified manual entry", None

modules/help/meta.json

@@ -0,0 +1,6 @@
+{
+    "start_on_boot": true,
+    "alias": "help",
+    "version": 2,
+    "index_file": "index.py"
+}