docs: refactor serve-docs; add nix run .#docs

Refactor `serve-docs` using `makeWrapper`, make it available as a
`serve-docs` package and as the `docs` "app".

This means `nix build .#docs` will build the docs while `nix run .#docs`
will run the server.

docs/default.nix

@@ -132,5 +132,9 @@ lib.fix (
       inherit evaledModules transformOptions;
       inherit (self) search lib-docs;
     };
+
+    serve-docs = pkgs.callPackage ./server {
+      inherit (self) docs;
+    };
   }
 )

docs/server/default.nix

@@ -0,0 +1,19 @@
+{
+  lib,
+  runCommand,
+  makeBinaryWrapper,
+  python3,
+  docs,
+}:
+runCommand "serve-docs"
+  {
+    nativeBuildInputs = [ makeBinaryWrapper ];
+    meta.mainProgram = "server";
+  }
+  ''
+    mkdir -p $out/bin
+    makeWrapper ${lib.getExe python3} \
+        $out/bin/server \
+        --add-flags ${./server.py} \
+        --chdir ${docs}
+  ''

docs/server/server.py

@@ -0,0 +1,16 @@
+import http.server
+
+PORT = 8000
+
+
+class UncachedHTTPHandler(http.server.SimpleHTTPRequestHandler):
+    def end_headers(self):
+        self.send_header("Cache-Control", "no-cache, no-store, must-revalidate")
+        self.send_header("Pragma", "no-cache")
+        self.send_header("Expires", "0")
+        super().end_headers()
+
+
+with http.server.HTTPServer(("", PORT), UncachedHTTPHandler) as httpd:
+    print(f"Serving documentation at http://localhost:{PORT}")
+    httpd.serve_forever()