Merge pull request #1 from litestar-org/ci/test-pr-1

ci: test pr-1

Author: Kumzy

plugins/advanced-alchemy.yml

@@ -15,10 +15,10 @@ maintainers:
 compatibility:
   litestar: '>=2.0.0'
 icon: advanced-alchemy.png
-stars: 647
-monthly_downloads: 68514
-latest_version: 1.6.2
-updated_at: '2025-08-29T18:41:08'
+stars: 677
+monthly_downloads: 99841
+latest_version: 1.8.0
+updated_at: '2025-10-28T21:01:30'
 created_at: '2023-09-17T17:39:42'
 python_compatibility_raw: '>=3.9'
 python_compatibility:

plugins/litestar-asyncpg.yml

@@ -15,8 +15,8 @@ maintainers:
 compatibility:
   litestar: '>=2.0.0'
 icon: litestar-asyncpg.svg
-stars: 10
-monthly_downloads: 388
+stars: 12
+monthly_downloads: 928
 latest_version: 0.5.0
 updated_at: '2025-06-24T16:45:09'
 created_at: '2023-10-01T23:31:27'

plugins/litestar-granian.yml

@@ -16,7 +16,7 @@ compatibility:
   litestar: '>=2.0.0'
 icon: litestar-granian.png
 stars: 37
-monthly_downloads: 6656
+monthly_downloads: 10349
 latest_version: 0.14.2
 updated_at: '2025-08-06T19:54:57'
 created_at: '2023-10-02T01:42:04'

plugins/litestar-htmx.yml

@@ -15,8 +15,8 @@ maintainers:
 compatibility:
   litestar: '>=2.0.0'
 icon: litestar-htmx.svg
-stars: 8
-monthly_downloads: 703443
+stars: 9
+monthly_downloads: 1009243
 latest_version: 0.5.0
 updated_at: '2025-06-11T21:19:45'
 created_at: '2024-10-20T17:49:03'

plugins/litestar-mcp.yml

@@ -15,10 +15,10 @@ maintainers:
 compatibility:
   litestar: '>=2.0.0'
 icon: _default_icon.svg
-stars: 8
-monthly_downloads: 132
-latest_version: 0.1.0
-updated_at: '2025-09-06T19:14:20'
+stars: 2
+monthly_downloads: 63
+latest_version: 0.2.2
+updated_at: '2025-09-30T12:11:18'
 created_at: '2025-09-06T19:14:18'
 python_compatibility_raw: '>=3.9'
 python_compatibility:

plugins/litestar-oracledb.yml

@@ -16,7 +16,7 @@ compatibility:
   litestar: '>=2.0.0'
 icon: litestar-oracledb.svg
 stars: 4
-monthly_downloads: 25
+monthly_downloads: 21
 latest_version: 0.2.0
 updated_at: '2024-09-04T20:30:03'
 created_at: '2024-08-29T19:33:20'

plugins/litestar-saq.yml

@@ -15,8 +15,8 @@ maintainers:
 compatibility:
   litestar: '>=2.0.0'
 icon: _default_icon.svg
-stars: 23
-monthly_downloads: 8708
+stars: 25
+monthly_downloads: 13255
 latest_version: 0.5.3
 updated_at: '2025-05-05T14:54:31'
 created_at: '2023-10-04T03:57:48'

plugins/litestar-vite.yml

@@ -16,7 +16,7 @@ compatibility:
   litestar: '>=2.0.0'
 icon: litestar-vite.svg
 stars: 25
-monthly_downloads: 6656
+monthly_downloads: 10349
 latest_version: 0.14.2
 updated_at: '2025-08-06T19:54:57'
 created_at: '2023-10-02T01:42:04'

plugins/sqlspec.yml

@@ -15,17 +15,16 @@ maintainers:
 compatibility:
   litestar: '>=2.0.0'
 icon: _default_icon.svg
-stars: 30
-monthly_downloads: 4962
-latest_version: 0.24.1
-updated_at: '2025-09-11T17:33:38'
+stars: 42
+monthly_downloads: 1791
+latest_version: 0.28.1
+updated_at: '2025-10-29T16:54:47'
 created_at: '2024-10-30T00:48:46'
-python_compatibility_raw: <4.0,>=3.9
+python_compatibility_raw: <4.0,>=3.10
 python_compatibility:
-  raw: <4.0,>=3.9
-  specifier_set: <4.0,>=3.9
+  raw: <4.0,>=3.10
+  specifier_set: <4.0,>=3.10
   compatible:
-  - '3.9'
   - '3.10'
   - '3.11'
   - '3.12'

readmes/sqlspec.md

@@ -14,7 +14,7 @@ SQLSpec is an experimental Python library designed to streamline and modernize y
 - **Emphasis on RAW SQL and Minimal Abstractions**: SQLSpec is a library for working with SQL in Python. Its goals are to offer minimal abstractions between the user and the database. It does not aim to be an ORM library.
 - **Type-Safe Queries**: Quickly map SQL queries to typed objects using libraries such as Pydantic, Msgspec, Attrs, etc.
 - **Extensible Design**: Easily add support for new database dialects or extend existing functionality to meet your specific needs. Easily add support for async and sync database drivers.
-- **Minimal Dependencies**: SQLSpec is designed to be lightweight and can run on its own or with other libraries such as `litestar`, `fastapi`, `flask` and more. (Contributions welcome!)
+- **Framework Extensions**: First-class integrations for Litestar, Starlette, and FastAPI with automatic transaction handling and lifecycle management
 - **Support for Async and Sync Database Drivers**: SQLSpec supports both async and sync database drivers, allowing you to choose the style that best fits your application.
 
 ### Experimental Features (API will change rapidly)
@@ -303,27 +303,51 @@ SQLSpec includes a built-in migration system for managing schema changes. After
 
 ```bash
 # Initialize migration directory
-sqlspec db init migrations
+sqlspec --config myapp.config init
 
 # Generate new migration file
-sqlspec db make-migrations "Add user table"
+sqlspec --config myapp.config create-migration -m "Add user table"
 
 # Apply all pending migrations
-sqlspec db upgrade
+sqlspec --config myapp.config upgrade
 
 # Show current migration status
-sqlspec db show-current-revision
+sqlspec --config myapp.config show-current-revision
 ```
 
 For Litestar applications, replace `sqlspec` with your application command:
 
 ```bash
 # Using Litestar CLI integration
-litestar db make-migrations "Add user table"
-litestar db upgrade
-litestar db show-current-revision
+litestar database create-migration -m "Add user table"
+litestar database upgrade
+litestar database show-current-revision
 ```
 
+### Shell Completion
+
+SQLSpec CLI supports tab completion for bash, zsh, and fish shells. Enable it with:
+
+```bash
+# Bash - add to ~/.bashrc
+eval "$(_SQLSPEC_COMPLETE=bash_source sqlspec)"
+
+# Zsh - add to ~/.zshrc
+eval "$(_SQLSPEC_COMPLETE=zsh_source sqlspec)"
+
+# Fish - add to ~/.config/fish/completions/sqlspec.fish
+eval (env _SQLSPEC_COMPLETE=fish_source sqlspec)
+```
+
+After setup, you can tab-complete commands and options:
+
+```bash
+sqlspec <TAB>         # Shows: create-migration, downgrade, init, ...
+sqlspec upgrade --<TAB>  # Shows: --bind-key, --help, --no-prompt, ...
+```
+
+See the [CLI documentation](https://sqlspec.litestar.dev/usage/cli.html) for complete setup instructions.
+
 ### Basic Litestar Integration
 
 In this example we demonstrate how to create a basic configuration that integrates into Litestar:
@@ -337,23 +361,18 @@ In this example we demonstrate how to create a basic configuration that integrat
 # ///
 
 from litestar import Litestar, get
-
+from sqlspec import SQLSpec
 from sqlspec.adapters.aiosqlite import AiosqliteConfig, AiosqliteDriver
-from sqlspec.extensions.litestar import DatabaseConfig, SQLSpec
-
+from sqlspec.extensions.litestar import SQLSpecPlugin
 
 @get("/")
 async def simple_sqlite(db_session: AiosqliteDriver) -> dict[str, str]:
     return await db_session.select_one("SELECT 'Hello, world!' AS greeting")
 
 
-sqlspec = SQLSpec(
-    config=DatabaseConfig(
-        config=AiosqliteConfig(pool_config={"database": ":memory:"}), # built in local pooling
-        commit_mode="autocommit"
-    )
-)
-app = Litestar(route_handlers=[simple_sqlite], plugins=[sqlspec])
+sqlspec = SQLSpec()
+sqlspec.add_config(AiosqliteConfig(pool_config={"database": ":memory:"}))
+app = Litestar(route_handlers=[simple_sqlite], plugins=[SQLSpecPlugin(sqlspec)])
 ```
 
 ## Inspiration and Future Direction