update project metadata

Author: CNSeniorious000

Diff for: packages/uvicorn-hmr/README.md

@@ -0,0 +1,41 @@
+# uvicorn-hmr
+
+This package provides hot module reloading (HMR) for [`uvicorn`](https://github.com/encode/uvicorn).
+
+It uses [`watchfiles`](https://github.com/samuelcolvin/watchfiles) to detect FS modifications,
+re-executes the corresponding modules and restart the server (in the same process).
+
+Since the reload is on-demand and the server is not restarted on every request, it is much faster than the built-in `--reload` option provided by `uvicorn`.
+
+## Installation
+
+```sh
+pip install uvicorn-hmr
+```
+
+## Usage
+
+Replace
+
+```sh
+uvicorn main:app --reload
+```
+
+with
+
+```sh
+uvicorn-hmr main:app
+```
+
+> [!NOTE]
+> Since this package is a proof-of-concept yet, there is no configuration available. But contributions are welcome!
+
+## Why?
+
+1. Restarting process on every request is not always necessary, and is rather expensive. With `hmr`, 3-party packages imports are memoized.
+2. `hmr` track dependencies on runtime, and only rerun necessary modules. If you changed a python file not used by the server entrypoint, it won't be reloaded.
+
+## What this package is not?
+
+> [!CAUTION]
+> `hmr` are sometimes refer to a feature that updates the page in the browser on the client side when the server code changes. This is not that. This package is a server-side HMR, that reloads the server code when it changes.

Diff for: packages/uvicorn-hmr/pyproject.toml

@@ -1,6 +1,7 @@
 [project]
 name = "uvicorn-hmr"
-version = "0.0.2"
+version = "0.0.2.1"
+readme = "README.md"
 dependencies = [
     "hmr~=0.1.2",
     "typer-slim~=0.15.1",
@@ -10,6 +11,9 @@ dependencies = [
 [project.scripts]
 uvicorn-hmr = "uvicorn_hmr:app"
 
+[project.urls]
+Homepage = "https://github.com/promplate/hmr"
+
 [build-system]
 requires = ["pdm-backend"]
 build-backend = "pdm.backend"

Diff for: packages/uvicorn-hmr/uvicorn_hmr.py

@@ -1,21 +1,28 @@
 from pathlib import Path
 from typing import TYPE_CHECKING
 
-from typer import Argument, Typer
+from typer import Argument, Typer, secho
 
 app = Typer(help="Hot Module Replacement for Uvicorn", add_completion=False)
 
 
 @app.command(no_args_is_help=True)
 def main(slug: str = Argument("main:app"), reload_include: str = str(Path.cwd()), reload_exclude: str = ".venv"):
+    if ":" not in slug:
+        secho("Invalid slug: ", fg="red", nl=False)
+        secho(slug, fg="yellow")
+        exit(1)
     module, attr = slug.split(":")
 
     fragment = Path(module.replace(".", "/"))
 
     if (path := fragment.with_suffix(".py")).is_file() or (path := fragment / "__init__.py").is_file():
         file = path.resolve()
     else:
-        raise FileNotFoundError(f"Module `{module}` not found")
+        secho("Module", fg="red", nl=False)
+        secho(f" {module} ", fg="yellow", nl=False)
+        secho("not found.", fg="red")
+        exit(1)
 
     import sys
     from atexit import register