fix: add bind_key parameter support to all adapter configurations (#89)

Fixes the missing `bind_key` parameter support across all database adapter configurations

### Backward Compatibility
✅ **Existing code continues to work unchanged**:
```python
# Existing code (no bind_key) - defaults to None
config = AiosqliteConfig(pool_config={"database": ":memory:"})
assert config.bind_key is None

# New CLI code (explicit bind_key)
config = AiosqliteConfig(
    pool_config={"database": ":memory:"}, 
    bind_key="my_database"
)
assert config.bind_key == "my_database"
```

Fixes CLI configuration loading and ensures consistent `bind_key` support across all database adapters as part of the configuration protocol.

Author: cofin

pyproject.toml

@@ -91,6 +91,7 @@ extras = [
   "adbc_driver_postgresql",
   "adbc_driver_flightsql",
   "adbc_driver_bigquery",
+  "dishka ; python_version >= \"3.10\"",
 ]
 lint = [
   "mypy>=1.13.0",
@@ -162,11 +163,11 @@ include = [
   "sqlspec/loader.py",    # Loader module
 
   # === ADAPTER TYPE CONVERTERS ===
-  "sqlspec/adapters/adbc/type_converter.py",      # ADBC type converter
-  "sqlspec/adapters/bigquery/type_converter.py",  # BigQuery type converter
-  "sqlspec/adapters/duckdb/type_converter.py",    # DuckDB type converter
-  "sqlspec/adapters/oracledb/type_converter.py",  # Oracle type converter
-  "sqlspec/adapters/psqlpy/type_converter.py",    # Psqlpy type converter
+  "sqlspec/adapters/adbc/type_converter.py",     # ADBC type converter
+  "sqlspec/adapters/bigquery/type_converter.py", # BigQuery type converter
+  "sqlspec/adapters/duckdb/type_converter.py",   # DuckDB type converter
+  "sqlspec/adapters/oracledb/type_converter.py", # Oracle type converter
+  "sqlspec/adapters/psqlpy/type_converter.py",   # Psqlpy type converter
 
   # === UTILITY MODULES ===
   "sqlspec/utils/text.py",                # Text utilities

sqlspec/adapters/adbc/config.py

@@ -77,6 +77,7 @@ def __init__(
         migration_config: Optional[dict[str, Any]] = None,
         statement_config: Optional[StatementConfig] = None,
         driver_features: Optional[dict[str, Any]] = None,
+        bind_key: Optional[str] = None,
     ) -> None:
         """Initialize configuration.
 
@@ -85,6 +86,7 @@ def __init__(
             migration_config: Migration configuration
             statement_config: Default SQL statement configuration
             driver_features: Driver feature configuration
+            bind_key: Optional unique identifier for this configuration
         """
         if connection_config is None:
             connection_config = {}
@@ -104,6 +106,7 @@ def __init__(
             migration_config=migration_config,
             statement_config=statement_config,
             driver_features=driver_features or {},
+            bind_key=bind_key,
         )
 
     def _resolve_driver_name(self) -> str:

sqlspec/adapters/aiosqlite/config.py

@@ -62,6 +62,7 @@ def __init__(
         migration_config: "Optional[dict[str, Any]]" = None,
         statement_config: "Optional[StatementConfig]" = None,
         driver_features: "Optional[dict[str, Any]]" = None,
+        bind_key: "Optional[str]" = None,
     ) -> None:
         """Initialize AioSQLite configuration.
 
@@ -71,6 +72,7 @@ def __init__(
             migration_config: Optional migration configuration.
             statement_config: Optional statement configuration.
             driver_features: Optional driver feature configuration.
+            bind_key: Optional unique identifier for this configuration.
         """
         config_dict = dict(pool_config) if pool_config else {}
 
@@ -84,6 +86,7 @@ def __init__(
             migration_config=migration_config,
             statement_config=statement_config or aiosqlite_statement_config,
             driver_features=driver_features or {},
+            bind_key=bind_key,
         )
 
     def _get_pool_config_dict(self) -> "dict[str, Any]":

sqlspec/adapters/asyncmy/config.py

@@ -71,6 +71,7 @@ def __init__(
         migration_config: Optional[dict[str, Any]] = None,
         statement_config: "Optional[StatementConfig]" = None,
         driver_features: "Optional[dict[str, Any]]" = None,
+        bind_key: "Optional[str]" = None,
     ) -> None:
         """Initialize Asyncmy configuration.
 
@@ -80,6 +81,7 @@ def __init__(
             migration_config: Migration configuration
             statement_config: Statement configuration override
             driver_features: Driver feature configuration
+            bind_key: Optional unique identifier for this configuration
         """
         processed_pool_config: dict[str, Any] = dict(pool_config) if pool_config else {}
         if "extra" in processed_pool_config:
@@ -100,6 +102,7 @@ def __init__(
             migration_config=migration_config,
             statement_config=statement_config,
             driver_features=driver_features or {},
+            bind_key=bind_key,
         )
 
     async def _create_pool(self) -> "AsyncmyPool":  # pyright: ignore

sqlspec/adapters/asyncmy/driver.py

@@ -8,8 +8,8 @@
 from typing import TYPE_CHECKING, Any, Optional, Union
 
 import asyncmy
-import asyncmy.errors
-from asyncmy.cursors import Cursor, DictCursor
+import asyncmy.errors  # pyright: ignore
+from asyncmy.cursors import Cursor, DictCursor  # pyright: ignore
 
 from sqlspec.core.cache import get_cache_config
 from sqlspec.core.parameters import ParameterStyle, ParameterStyleConfig

sqlspec/adapters/asyncpg/config.py

@@ -84,6 +84,7 @@ def __init__(
         migration_config: "Optional[dict[str, Any]]" = None,
         statement_config: "Optional[StatementConfig]" = None,
         driver_features: "Optional[Union[AsyncpgDriverFeatures, dict[str, Any]]]" = None,
+        bind_key: "Optional[str]" = None,
     ) -> None:
         """Initialize AsyncPG configuration.
 
@@ -93,6 +94,7 @@ def __init__(
             migration_config: Migration configuration
             statement_config: Statement configuration override
             driver_features: Driver features configuration (TypedDict or dict)
+            bind_key: Optional unique identifier for this configuration
         """
         features_dict: dict[str, Any] = dict(driver_features) if driver_features else {}
 
@@ -106,6 +108,7 @@ def __init__(
             migration_config=migration_config,
             statement_config=statement_config or asyncpg_statement_config,
             driver_features=features_dict,
+            bind_key=bind_key,
         )
 
     def _get_pool_config_dict(self) -> "dict[str, Any]":

sqlspec/adapters/bigquery/config.py

@@ -94,6 +94,7 @@ def __init__(
         migration_config: Optional[dict[str, Any]] = None,
         statement_config: "Optional[StatementConfig]" = None,
         driver_features: "Optional[Union[BigQueryDriverFeatures, dict[str, Any]]]" = None,
+        bind_key: "Optional[str]" = None,
     ) -> None:
         """Initialize BigQuery configuration.
 
@@ -102,6 +103,7 @@ def __init__(
             migration_config: Migration configuration
             statement_config: Statement configuration override
             driver_features: BigQuery-specific driver features
+            bind_key: Optional unique identifier for this configuration
         """
 
         self.connection_config: dict[str, Any] = dict(connection_config) if connection_config else {}
@@ -124,6 +126,7 @@ def __init__(
             migration_config=migration_config,
             statement_config=statement_config,
             driver_features=self.driver_features,
+            bind_key=bind_key,
         )
 
     def _setup_default_job_config(self) -> None:

sqlspec/adapters/duckdb/config.py

@@ -149,6 +149,7 @@ def __init__(
         migration_config: Optional[dict[str, Any]] = None,
         statement_config: "Optional[StatementConfig]" = None,
         driver_features: "Optional[Union[DuckDBDriverFeatures, dict[str, Any]]]" = None,
+        bind_key: "Optional[str]" = None,
     ) -> None:
         """Initialize DuckDB configuration."""
         if pool_config is None:
@@ -160,6 +161,7 @@ def __init__(
             pool_config["database"] = ":memory:shared_db"
 
         super().__init__(
+            bind_key=bind_key,
             pool_config=dict(pool_config),
             pool_instance=pool_instance,
             migration_config=migration_config,

sqlspec/adapters/oracledb/config.py

@@ -94,6 +94,7 @@ def __init__(
         migration_config: Optional[dict[str, Any]] = None,
         statement_config: "Optional[StatementConfig]" = None,
         driver_features: "Optional[dict[str, Any]]" = None,
+        bind_key: "Optional[str]" = None,
     ) -> None:
         """Initialize Oracle synchronous configuration.
 
@@ -103,6 +104,7 @@ def __init__(
             migration_config: Migration configuration
             statement_config: Default SQL statement configuration
             driver_features: Optional driver feature configuration
+            bind_key: Optional unique identifier for this configuration
         """
 
         processed_pool_config: dict[str, Any] = dict(pool_config) if pool_config else {}
@@ -116,6 +118,7 @@ def __init__(
             migration_config=migration_config,
             statement_config=statement_config,
             driver_features=driver_features or {},
+            bind_key=bind_key,
         )
 
     def _create_pool(self) -> "OracleSyncConnectionPool":
@@ -220,6 +223,7 @@ def __init__(
         migration_config: Optional[dict[str, Any]] = None,
         statement_config: "Optional[StatementConfig]" = None,
         driver_features: "Optional[dict[str, Any]]" = None,
+        bind_key: "Optional[str]" = None,
     ) -> None:
         """Initialize Oracle asynchronous configuration.
 
@@ -229,6 +233,7 @@ def __init__(
             migration_config: Migration configuration
             statement_config: Default SQL statement configuration
             driver_features: Optional driver feature configuration
+            bind_key: Optional unique identifier for this configuration
         """
 
         processed_pool_config: dict[str, Any] = dict(pool_config) if pool_config else {}
@@ -242,6 +247,7 @@ def __init__(
             migration_config=migration_config,
             statement_config=statement_config or oracledb_statement_config,
             driver_features=driver_features or {},
+            bind_key=bind_key,
         )
 
     async def _create_pool(self) -> "OracleAsyncConnectionPool":

sqlspec/adapters/psqlpy/config.py

@@ -90,6 +90,7 @@ def __init__(
         migration_config: Optional[dict[str, Any]] = None,
         statement_config: Optional[StatementConfig] = None,
         driver_features: Optional[dict[str, Any]] = None,
+        bind_key: Optional[str] = None,
     ) -> None:
         """Initialize Psqlpy configuration.
 
@@ -99,6 +100,7 @@ def __init__(
             migration_config: Migration configuration
             statement_config: SQL statement configuration
             driver_features: Driver feature configuration
+            bind_key: Optional unique identifier for this configuration
         """
         processed_pool_config: dict[str, Any] = dict(pool_config) if pool_config else {}
         if "extra" in processed_pool_config:
@@ -110,6 +112,7 @@ def __init__(
             migration_config=migration_config,
             statement_config=statement_config or psqlpy_statement_config,
             driver_features=driver_features or {},
+            bind_key=bind_key,
         )
 
     def _get_pool_config_dict(self) -> dict[str, Any]: