feat: Add CLI command pandas serve for serving local files

Author: nok

pandas_render/cli/__init__.py

@@ -0,0 +1,37 @@
+from functools import partial
+from http.server import SimpleHTTPRequestHandler, ThreadingHTTPServer
+from pathlib import Path
+
+import typer
+from typing_extensions import Annotated
+
+app = typer.Typer()
+
+
+@app.command()
+def render():
+    print("Render dataframe")
+
+
+@app.command()
+def serve(
+    host: str = "0.0.0.0",
+    port: int = 8080,
+    directory: Annotated[str, Path, typer.Argument()] = Path.cwd(),
+):
+    if not directory:
+        directory = Path.cwd()
+
+    if not isinstance(directory, Path):
+        directory = Path(directory)
+
+    assert directory.exists() and directory.is_dir()
+
+    directory = str(directory.resolve().absolute())
+
+    handler = partial(SimpleHTTPRequestHandler, directory=directory)
+    server = ThreadingHTTPServer((host, port), handler)
+
+    print(f"Serving files at http://{host}:{port} ... (ctrl+c to stop)")
+
+    server.serve_forever()

pandas_render/cli/__main__.py

@@ -10,6 +10,7 @@ requires-python = ">=3.9"
 dependencies = [
     "ipython>=7.11.1",
     "jinja2>=3.0.0",
+    "typer>=0.15.2",
 ]
 license = "BSD-3-Clause"
 classifiers = [
@@ -42,6 +43,9 @@ dev = [
     "pytest-xdist>=3.6.1",
 ]
 
+[project.scripts]
+pandas = "pandas_render.cli.__main__:app"
+
 [tool.coverage.run]
 source = ["pandas_render"]