@easysociable/cli 0.1.1 → 0.1.3

package/content-engine/workbench/serve.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+"""Serve Content Engine root so workbench can fetch live Markdown.
+
+  python3 workbench/serve.py
+  → http://127.0.0.1:8765/workbench/
+"""
+
+from __future__ import annotations
+
+import argparse
+import functools
+import http.server
+import os
+import webbrowser
+from pathlib import Path
+
+ROOT = Path(__file__).resolve().parent.parent
+DEFAULT_PORT = 8765
+
+
+class QuietHandler(http.server.SimpleHTTPRequestHandler):
+    def end_headers(self) -> None:
+        self.send_header("Cache-Control", "no-store")
+        super().end_headers()
+
+    def log_message(self, fmt: str, *args) -> None:
+        super().log_message(fmt, *args)
+
+
+def main() -> None:
+    ap = argparse.ArgumentParser(description="Local static server for Content Engine workbench")
+    ap.add_argument("-p", "--port", type=int, default=DEFAULT_PORT)
+    ap.add_argument("--no-open", action="store_true", help="Do not open the browser")
+    args = ap.parse_args()
+
+    os.chdir(ROOT)
+    handler = functools.partial(QuietHandler, directory=str(ROOT))
+    url = f"http://127.0.0.1:{args.port}/workbench/"
+    # Threading: browser may open HTML + many md fetches; a stuck client must not block others.
+    with http.server.ThreadingHTTPServer(("127.0.0.1", args.port), handler) as httpd:
+        print(f"Content Engine root: {ROOT}")
+        print(f"Open: {url}")
+        print("Ctrl+C to stop")
+        if not args.no_open:
+            webbrowser.open(url)
+        try:
+            httpd.serve_forever()
+        except KeyboardInterrupt:
+            print("\nstopped")
+
+
+if __name__ == "__main__":
+    main()