feat: initial event loop

Author: brian14708

.github/workflows/ci.yaml

@@ -12,18 +12,22 @@ permissions:
 jobs:
   python:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
     steps:
       - uses: actions/checkout@v5
       - name: "Set up Python"
         uses: actions/setup-python@v6
         with:
-          python-version-file: "pyproject.toml"
+          python-version: ${{ matrix.python-version }}
       - name: Install uv
         uses: astral-sh/setup-uv@v6
         with:
           enable-cache: true
       - name: Sync dependencies
-        run: uv sync --all-packages --all-groups
+        run: uv sync --group type-checking --group lint
       - name: Run tests
         run: uv run pytest
       - name: Run linter

.gitignore

@@ -1,4 +1,5 @@
 /dist
 /site
 /.venv
+/.nox
 __pycache__

Makefile

@@ -29,13 +29,16 @@
           devShells = {
             default = pkgs.mkShell {
               buildInputs = with pkgs; [
-                gnumake
-                (python313.withPackages (
+                (python3.withPackages (
                   p: with p; [
+                    nox
                     uv
                   ]
                 ))
               ];
+              env = {
+                UV_PYTHON = pkgs.python310.interpreter;
+              };
             };
           };
 

flake.nix

@@ -0,0 +1,41 @@
+from __future__ import annotations
+
+import nox
+
+nox.options.default_venv_backend = "uv"
+
+ALL_PYTHON = ["3.13", "3.12", "3.11", "3.10"]
+
+
+def install_deps(s: nox.Session, groups: list[str]):
+    s.env["UV_PROJECT_ENVIRONMENT"] = s.virtualenv.location
+    cmd = ["uv", "sync", "--frozen"]
+    for g in groups:
+        cmd.extend(("--group", g))
+    _ = s.run_install(*cmd)
+
+
+@nox.session(python=ALL_PYTHON)
+def test(s: nox.Session) -> None:
+    install_deps(s, [])
+    _ = s.run("pytest")
+
+
+@nox.session(python=ALL_PYTHON)
+def type_check(s: nox.Session) -> None:
+    install_deps(s, ["type-checking"])
+    _ = s.run("mypy", ".")
+    _ = s.run("basedpyright", "--venvpath", s.virtualenv.location, ".")
+
+
+@nox.session
+def lint(s: nox.Session) -> None:
+    install_deps(s, ["lint"])
+    _ = s.run("ruff", "check", ".")
+    _ = s.run("ruff", "format", "--check", ".")
+
+
+@nox.session
+def docs(s: nox.Session) -> None:
+    install_deps(s, ["docs"])
+    _ = s.run("mkdocs", "build")

main.py

@@ -6,6 +6,7 @@ readme = "README.md"
 requires-python = ">=3.10"
 dependencies = [
     "pydantic>=2.11.7",
+    "typing-extensions>=4.15.0",
 ]
 
 [build-system]
@@ -14,10 +15,15 @@ build-backend = "uv_build"
 
 [dependency-groups]
 dev = [
-    "basedmypy>=2.10.0",
-    "basedpyright>=1.31.2",
     "pytest>=7.0",
     "pytest-asyncio>=0.21",
+]
+type-checking = [
+    "basedmypy>=2.10.0",
+    "basedpyright>=1.31.2",
+    "nox>=2025.5.1",
+]
+lint = [
     "ruff>=0.12.8",
 ]
 docs = [
@@ -49,7 +55,8 @@ disable_error_code = [
 ]
 
 [tool.pyright]
-venv = ".venv"
-venvPath = "."
+venv = "."
+venvPath = ".venv"
 reportAny = false
 reportExplicitAny = false
+reportUnreachable = false