remove old stuff, docs, cleanup

Author: gjoseph92

js/hello.tsx

@@ -1,3 +1,10 @@
+"""
+User-facing functions of the ``fused_local`` library.
+
+Only `tile` and `configure_map` actually exist yet.
+The rest are ideas of what the interface will be like.
+"""
+
 from functools import singledispatchmethod
 import geopy.geocoders
 from typing import Callable, Concatenate, Generic, ParamSpec, Self, TypeVar

sractch-flat.py

@@ -1,3 +1,5 @@
+"Generate self-signed certificates for serving HTTPS locally"
+
 import datetime
 
 from os import PathLike

src/fused_local/lib.py

@@ -2,14 +2,13 @@
 from typing import Annotated
 
 import trio
-from hypercorn.trio import serve
+import typer
 from hypercorn.config import Config as HyperConfig
+from hypercorn.trio import serve
 
+import fused_local.config
 from fused_local.app import app, setup_static_serving
 from fused_local.local_certs import generate_certs
-import fused_local.config
-
-import typer
 
 # TODO: we can't easily serve HTTP/2 over localhost, because it requires HTTPS.
 # The browser won't trust our self-signed certificates, which isn't great UX.

src/fused_local/local_certs.py

@@ -1,6 +1,6 @@
-from pathlib import Path
 import importlib.util
 import sys
+from pathlib import Path
 from types import ModuleType
 
 import anyio
@@ -43,6 +43,8 @@ def reload_user_code(path: Path) -> None:
 
 
 class RepeatEvent:
+    "anyio Event that can be reset"
+
     _event: anyio.Event
 
     def __init__(self) -> None:
@@ -64,6 +66,7 @@ def reset(self) -> None:
 
 
 async def watch_with_event(path: Path, event: RepeatEvent) -> RepeatEvent:
+    "Watch a file/directory; reset the event every time it changes"
     async for _ in awatch(path):
         event.reset()
 

src/fused_local/serve.py

@@ -1,3 +1,13 @@
+"""
+Something kinda like a process pool, for Trio.
+
+Wraps ``trio-parallel`` to add support for restarting the worker pool.
+
+(We might want to use this when user code changes.)
+
+Currently we don't actually restart the pool because it's way too slow.
+"""
+
 import os
 from functools import partial
 from pathlib import Path

src/fused_local/tiler-rio.py

@@ -5,7 +5,7 @@
 from fastapi.testclient import TestClient
 # from fused_local.cancellation_middleware import CancelOnDisconnectMiddleware
 
-pytest.mark.skip(reason="Test doesn't work")
+pytest.skip(reason="Test doesn't work", allow_module_level=True)
 
 app = FastAPI()
 # app.add_middleware(CancelOnDisconnectMiddleware)