refactor: asgimiddleware everywhere if possible

.github/workflows/ci.yml

@@ -6,7 +6,6 @@ on:
   push:
     branches:
       - main
-      - v1.51
 
 env:
   UV_LOCKED: 1
@@ -19,7 +18,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.8"
+          python-version: "3.9"
 
       - name: Install Pre-Commit
         run: python -m pip install pre-commit
@@ -41,8 +40,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.8"
-          allow-prereleases: true
+          python-version: "3.9"
 
       - name: Install uv
         uses: astral-sh/setup-uv@v5
@@ -60,8 +58,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.8"
-          allow-prereleases: true
+          python-version: "3.9"
 
       - name: Install uv
         uses: astral-sh/setup-uv@v5
@@ -79,8 +76,7 @@ jobs:
 
       - uses: actions/setup-python@v5
         with:
-          python-version: "3.8"
-          allow-prereleases: false
+          python-version: "3.9"
 
       - name: Install uv
         uses: astral-sh/setup-uv@v5
@@ -96,10 +92,10 @@ jobs:
     strategy:
       fail-fast: true
       matrix:
-        python-version: ["3.8", "3.9", "3.10", "3.11", "3.12", "3.13"]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13"]
     uses: ./.github/workflows/test.yml
     with:
-      coverage: ${{ (matrix.python-version == '3.12' || matrix.python-version == '3.8') }}
+      coverage: ${{ (matrix.python-version == '3.12' || matrix.python-version == '3.9') }}
       python-version: ${{ matrix.python-version }}
 
   # add an aggregate step here to check if any of the steps of the matrix 'test' job

Makefile

@@ -136,16 +136,16 @@ docs-clean: 										## Dump the existing built docs
 
 docs-serve: docs-clean 								## Serve the docs locally
 	@echo "=> Serving documentation"
-	uv run --python 3.12 sphinx-autobuild docs docs/_build/ -j auto --watch litestar --watch docs --watch tests --watch CONTRIBUTING.rst --open-browser --port=0
+	uv run --isolated --python 3.12 sphinx-autobuild docs docs/_build/ -j auto --watch litestar --watch docs --watch tests --watch CONTRIBUTING.rst --open-browser --port=0
 
 docs: docs-clean 									## Dump the existing built docs and rebuild them
 	@echo "=> Building documentation"
-	@uv run --python 3.12 sphinx-build -M html docs docs/_build/ -E -a -j auto -W --keep-going
+	@uv run --isolated --python 3.12 sphinx-build -M html docs docs/_build/ -E -a -j auto -W --keep-going
 
 .PHONY: docs-linkcheck
 docs-linkcheck: 									## Run the link check on the docs
-	@uv run --python 3.12 sphinx-build -b linkcheck ./docs ./docs/_build -D linkcheck_ignore='http://.*','https://.*'
+	@uv run --isolated --python 3.12 sphinx-build -b linkcheck ./docs ./docs/_build -D linkcheck_ignore='http://.*','https://.*'
 
 .PHONY: docs-linkcheck-full
 docs-linkcheck-full: 									## Run the full link check on the docs
-	@uv run --python 3.12 sphinx-build -b linkcheck ./docs ./docs/_build -D linkcheck_anchors=0
+	@uv run --isolated --python 3.12 sphinx-build -b linkcheck ./docs ./docs/_build -D linkcheck_anchors=0

docs/_static/style.css

@@ -25,9 +25,9 @@
   color: #f55353;
 }
 
-p {
-  font-size: 1.1em;
-}
+/*p {*/
+/*  font-size: 1.1em;*/
+/*}*/
 
 html[data-theme="dark"] .mermaid svg {
   background-color: white;

docs/_static/tables/framework-comparison.csv

@@ -0,0 +1,16 @@
+Feature,Litestar,FastAPI,Starlette,Sanic,Quart
+OpenAPI,:octicon:`check`,:octicon:`check`,-,-,-
+Automatic API documentation,"Swagger, ReDoc, Stoplight Elements","Swagger, ReDoc",-,-,-
+Data validation,:octicon:`check`,:octicon:`check`,-,-,-
+Dependency Injection,:octicon:`check`,:octicon:`check`,-,:octicon:`check`,-
+Class based routing,:octicon:`check`,Extension,:octicon:`check`,:octicon:`check`,:octicon:`check`
+ORM integration,"SQLAlchemy, Tortoise, Piccolo",-,-,-,Extension
+Templating,"Jinja, Mako",Jinja,Jinja,Jinja,Jinja
+MessagePack,:octicon:`check`,-,-,-,-
+CORS,:octicon:`check`,:octicon:`check`,:octicon:`check`,:octicon:`check`,Extension
+CSRF,:octicon:`check`,-,-,-,-
+Rate-limiting,:octicon:`check`,-,-,Extension,-
+JWT,:octicon:`check`,-,-,-,-
+Sessions,:octicon:`check`,Client-side,Client-side,-,Client-side
+Authentication,JWT / Session based,-,-,-,-
+Caching,:octicon:`check`,-,-,-,-

docs/_static/versioning.js

@@ -21,13 +21,15 @@ const addVersionWarning = (currentVersion, latestVersion) => {
   const container = document.createElement("div");
   container.id = "version-warning";
 
-  const warningText = document.createElement("span");
-  warningText.textContent = `You are viewing the documentation for ${
-    currentVersion === "dev" ||
-    parseInt(currentVersion) > parseInt(latestVersion)
-      ? "a preview"
-      : "an outdated"
-  } version of Litestar.`;
+  const isPreviewVersion = (version) => {
+        const previewVersions = ['dev', 'develop', 'main', '3-dev'];
+        return previewVersions.includes(version) || parseInt(version) > parseInt(latestVersion);
+    };
+
+    const warningText = document.createElement("span");
+    warningText.textContent = `You are viewing the documentation for ${
+        isPreviewVersion(currentVersion) ? "a preview" : "an outdated"
+    } version of Litestar.`;
   container.appendChild(warningText);
 
   const latestLink = document.createElement("a");