feat: add plug-and-play devRant API client examples with Python and JavaScript

Add complete set of example scripts for the devRant REST protocol under examples/devrant/, including reusable client libraries, a rant poster, a live feed watcher with keyword-based auto-upvote, and an end-to-end smoke test that exercises every endpoint. Both Python (stdlib-only) and JavaScript (Node 18+ global fetch) implementations are provided.
2026-06-14 07:48:37 +00:00
parent f2b910ea75
commit c151325916
23 changed files with 1451 additions and 0 deletions
@@ -0,0 +1,38 @@
+# retoor <retoor@molodetz.nl>
+
+from __future__ import annotations
+
+import xmlrpc.client
+from typing import Any
+from urllib.parse import quote, urlsplit, urlunsplit
+
+
+class DevPlace:
+    def __init__(
+        self,
+        base_url: str,
+        api_key: str | None = None,
+        username: str | None = None,
+        password: str | None = None,
+    ) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.api_key = api_key
+        endpoint = self.base_url + "/xmlrpc"
+        if username and password:
+            parts = urlsplit(self.base_url)
+            credentials = f"{quote(username, safe='')}:{quote(password, safe='')}"
+            endpoint = urlunsplit(
+                (parts.scheme, f"{credentials}@{parts.netloc}", parts.path + "/xmlrpc", "", "")
+            )
+        self.proxy = xmlrpc.client.ServerProxy(endpoint, allow_none=True)
+
+    def call(self, method: str, **params: Any) -> Any:
+        if self.api_key and "api_key" not in params:
+            params["api_key"] = self.api_key
+        return getattr(self.proxy, method)(params)
+
+    def methods(self) -> list[str]:
+        return sorted(self.proxy.system.listMethods())
+
+    def help(self, method: str) -> str:
+        return self.proxy.system.methodHelp(method)