refactor(sqlalchemy): move deprecated contrib.sqlalchemy module to plugins.sqlalchemy

.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

.pre-commit-config.yaml

@@ -2,7 +2,7 @@ default_language_version:
   python: "3.12"
 repos:
   - repo: https://github.com/compilerla/conventional-pre-commit
-    rev: v3.6.0
+    rev: v4.0.0
     hooks:
       - id: conventional-pre-commit
         stages: [commit-msg]
@@ -24,13 +24,13 @@ repos:
       - id: unasyncd
         additional_dependencies: ["ruff"]
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.8.1"
+    rev: "v0.11.5"
     hooks:
       - id: ruff
         args: ["--fix"]
       - id: ruff-format
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.3.0
+    rev: v2.4.1
     hooks:
       - id: codespell
         exclude: "tests/openapi/typescript_converter/test_converter|README.md"

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/litestar-theme.js

@@ -0,0 +1,49 @@
+function initDropdowns() {
+    const dropdownToggles = document.querySelectorAll(".st-dropdown-toggle")
+
+    const dropdowns = [...dropdownToggles].map(toggleEl => ({
+        toggleEl,
+        contentEL: toggleEl.parentElement.querySelector(".st-dropdown-menu")
+    }))
+
+    const close = (dropdown) => {
+        const {toggleEl, contentEL} = dropdown
+        toggleEl.setAttribute("aria-expanded", "false")
+        contentEL.classList.toggle("hidden", true)
+    }
+
+    const closeAll = () => dropdowns.forEach(close)
+
+    const open = (dropdown) => {
+        closeAll()
+        dropdown.toggleEl.setAttribute("aria-expanded", "true")
+        dropdown.contentEL.classList.toggle("hidden", false)
+        const boundaries = [dropdown.contentEL, ...dropdownToggles]
+        const clickOutsideListener = (event) => {
+            const target = event.target
+            if (!target) return
+
+            if (!boundaries.some(b => b.contains(target))) {
+                closeAll()
+                document.removeEventListener("click", clickOutsideListener)
+            }
+
+        }
+        document.addEventListener("click", clickOutsideListener)
+    }
+
+
+    dropdowns.forEach(dropdown => {
+        dropdown.toggleEl.addEventListener("click", () => {
+            if (dropdown.toggleEl.getAttribute("aria-expanded") === "true") {
+                close(dropdown)
+            } else {
+                open(dropdown)
+            }
+        })
+    })
+}
+
+window.addEventListener("DOMContentLoaded", () => {
+    initDropdowns()
+})

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");