Molodetz blogrol volgens DPP-template

2026-10-05 09:36:20 +02:00
commit f290a4c766
277 changed files with 15758 additions and 0 deletions
@@ -0,0 +1,56 @@
+# retoor <retoor@molodetz.nl>
+ROLE_BY_AUTH = {"public": "guest", "member": "Member", "admin": "Admin"}
+
+TARGET_TYPES = ("post", "join_request", "user")
+
+
+def field(name, type="string", required=False, description="", enum=None, example=None, location="body"):
+    return {
+        "name": name,
+        "type": type,
+        "required": required,
+        "description": description,
+        "enum": list(enum or []),
+        "example": example,
+        "location": location,
+    }
+
+
+def endpoint(
+    method,
+    path,
+    title,
+    description="",
+    auth="public",
+    fields=None,
+    sample=None,
+    negotiation="negotiable",
+    destructive=False,
+    interactive=True,
+    probe_path=None,
+    probe_body=None,
+):
+    return {
+        "method": method,
+        "path": path,
+        "title": title,
+        "description": description,
+        "auth": auth,
+        "min_role": ROLE_BY_AUTH[auth],
+        "fields": list(fields or []),
+        "sample": sample,
+        "negotiation": negotiation,
+        "destructive": destructive,
+        "interactive": interactive,
+        "probe_path": probe_path or path,
+        "probe_body": probe_body,
+    }
+
+
+def substitute(text, base="", username="", api_key="", app_reference="molodetz-docs-v-1-0-0"):
+    return (
+        text.replace("{{base}}", base)
+        .replace("{{username}}", username)
+        .replace("{{api_key}}", api_key)
+        .replace("{{app_reference}}", app_reference)
+    )