Switch to Litestar and add UV along the way

Signed-off-by: GitHub <[email protected]>

Author: shenanigansd

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v4.5.0
+    rev: v5.0.0
     hooks:
       - id: check-case-conflict
       - id: check-merge-conflict
@@ -12,3 +12,23 @@ repos:
       - id: mixed-line-ending
         args: [ --fix=lf ]
       - id: end-of-file-fixer
+        exclude: .devcontainer/devcontainer-lock.json
+
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.5.4
+    hooks:
+      - id: uv-lock
+      - id: uv-export
+        args:
+          - --frozen
+          - --no-emit-project
+          - --output-file=requirements.txt
+        files: pyproject.toml|uv.lock
+      - id: uv-export
+        args:
+          - --frozen
+          - --no-emit-project
+          - --all-extras
+          - --all-groups
+          - --output-file=requirements-dependabot.txt
+        files: pyproject.toml|uv.lock

Containerfile DockerfileContainerfile renamed to Dockerfile

@@ -1,4 +1,4 @@
-FROM python:3.12-slim@sha256:43a49c9cc2e614468e3d1a903aabe17a97a4c788c76cf5337b5cdc3535b07d4f
+FROM python:3.13-slim@sha256:751d8bece269ba9e672b3f2226050e7e6fb3f3da3408b5dcb5d415a054fcb061
 
 # Define Git SHA build argument for sentry
 ARG git_sha="development"

docs/source/conf.py

@@ -60,9 +60,9 @@ def linkcode_resolve(domain: str, info: dict) -> str:
     if not info["module"]:
         return None
 
-    import importlib  # noqa: PLC0415
-    import inspect  # noqa: PLC0415
-    import types  # noqa: PLC0415
+    import importlib
+    import inspect
+    import types
 
     mod = importlib.import_module(info["module"])
 

make.ps1

@@ -0,0 +1,52 @@
+"""Noxfile."""
+
+import shutil
+from pathlib import Path
+
+import nox
+
+nox.options.default_venv_backend = "none"
+nox.options.sessions = ["lints"]
+
+
+CLEANABLE_TARGETS = [
+    "./dist",
+    "./build",
+    "./.nox",
+    "./.coverage",
+    "./.coverage.*",
+    "./coverage.json",
+    "./**/.mypy_cache",
+    "./**/.pytest_cache",
+    "./**/__pycache__",
+    "./**/*.pyc",
+    "./**/*.pyo",
+]
+
+
+@nox.session
+def tests(session: nox.Session) -> None:
+    """Run tests."""
+    session.run("pytest")
+
+
+@nox.session
+def lints(session: nox.Session) -> None:
+    """Run lints."""
+    session.run("pre-commit", "run", "--all-files")
+    session.run("ruff", "format", ".")
+    session.run("ruff", "check", "--fix", ".")
+    session.run("mypy", "--strict", "src/")
+
+
+@nox.session
+def clean(_: nox.Session) -> None:
+    """Clean cache, .pyc, .pyo, and test/build artifact files from project."""
+    count = 0
+    for searchpath in CLEANABLE_TARGETS:
+        for filepath in Path().glob(searchpath):
+            if filepath.is_dir():
+                shutil.rmtree(filepath)
+            else:
+                filepath.unlink()
+            count += 1

noxfile.py

@@ -1,52 +1,75 @@
 [project]
 name = "api.letsbuilda.dev"
 description = "Public API for our projects"
-authors = [
-    { name = "Bradley Reynolds", email = "[email protected]" },
-]
+authors = [{ name = "Bradley Reynolds", email = "[email protected]" }]
 license = { text = "MIT" }
 readme = "README.md"
-requires-python = ">=3.11,<3.13"
-dynamic = ["version", "dependencies", "optional-dependencies"]
+requires-python = ">=3.12"
+dynamic = ["version"]
+dependencies = [
+    # Core
+    ## Metrics
+    "sentry-sdk>=2.10.0",
+    ## Settings and configuration
+    "pydantic>=2.10.1",
+    "pydantic-settings>=2.6.1",
+    ## Web
+    "gunicorn>=23.0.0",
+    "uvicorn-worker>=0.2.0",
+    "uvicorn[standard]>=0.30.3",
+    "litestar[brotli]>=2.10.0",
+    "imsosorry>=1.2.1",
+]
 
 [project.urls]
 repository = "https://github.com/letsbuilda/api.letsbuilda.dev/"
 documentation = "https://docs.letsbuilda.dev/api.letsbuilda.dev/"
 
+[project.optional-dependencies]
+docs = [
+    "sphinx>=7.4.4",
+    "furo>=2024.5.6",
+    "sphinx-autoapi>=3.1.2",
+    "releases>=2.1.1",
+]
+
+[dependency-groups]
+dev = [
+    # DX
+    "nox>=2024.4.15",
+    "pre-commit>=3.7.1",
+    # Linters
+    "ruff>=0.5.2",
+    "mypy>=1.10.1",
+]
+tests = ["pytest>=8.2.2", "pytest-randomly>=3.15.0", "coverage>=7.6.1"]
+
 [build-system]
 requires = ["setuptools", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [tool.setuptools.dynamic.version]
 attr = "api.__version__"
 
-[tool.setuptools.dynamic.dependencies]
-file = ["requirements/requirements.txt"]
-
-[tool.setuptools.dynamic.optional-dependencies]
-dev = { file = ["requirements/requirements-dev.txt"] }
-tests = { file = ["requirements/requirements-tests.txt"] }
-docs = { file = ["requirements/requirements-docs.txt"] }
-
 [tool.ruff]
-preview = true
-unsafe-fixes = true
-target-version = "py311"
-select = ["ALL"]
+target-version = "py313"
 line-length = 120
+
+[tool.ruff.lint]
+select = ["ALL"]
 ignore = [
     "CPY001", # (Missing copyright notice at top of file) - No license
-    "S311", # (Standard pseudo-random generators are not suitable for cryptographic purposes) - Not a crypto lib
+    "S311",   # (Standard pseudo-random generators are not suitable for cryptographic purposes) - Not a crypto lib
 ]
 
-[tool.ruff.extend-per-file-ignores]
+[tool.ruff.lint.extend-per-file-ignores]
 "docs/*" = [
     "INP001", # (File `tests/*.py` is part of an implicit namespace package. Add an `__init__.py`.) - Docs are not modules
 ]
 "tests/*" = [
     "INP001", # (File `tests/*.py` is part of an implicit namespace package. Add an `__init__.py`.) - Tests are not modules
-    "S101", # (Use of `assert` detected) - Yes, that's the point
+    "S101",   # (Use of `assert` detected) - Yes, that's the point
 ]
 
-[tool.ruff.pydocstyle]
+[tool.ruff.lint.pydocstyle]
 convention = "numpy"