sqlspec 0.11.1__py3-none-any.whl → 0.12.0__py3-none-any.whl

sqlspec/utils/text.py

@@ -6,25 +6,20 @@ from functools import lru_cache
 from typing import Optional
 
 # Compiled regex for slugify
-_SLUGIFY_REMOVE_INVALID_CHARS_RE = re.compile(r"[^\w\s-]")
-_SLUGIFY_COLLAPSE_SEPARATORS_RE = re.compile(r"[-\s]+")
+_SLUGIFY_REMOVE_NON_ALPHANUMERIC = re.compile(r"[^\w]+", re.UNICODE)
+_SLUGIFY_HYPHEN_COLLAPSE = re.compile(r"-+")
 
 # Compiled regex for snake_case
-# Handles sequences like "HTTPRequest" -> "HTTP_Request" or "SSLError" -> "SSL_Error"
-_SNAKE_CASE_RE_ACRONYM_SEQUENCE = re.compile(r"([A-Z\d]+)([A-Z][a-z])")
-# Handles transitions like "camelCase" -> "camel_Case" or "PascalCase" -> "Pascal_Case" (partially)
-_SNAKE_CASE_RE_LOWER_UPPER_TRANSITION = re.compile(r"([a-z\d])([A-Z])")
-# Replaces hyphens, spaces, and dots with a single underscore
-_SNAKE_CASE_RE_REPLACE_SEP = re.compile(r"[-\s.]+")
-# Cleans up multiple consecutive underscores
-_SNAKE_CASE_RE_CLEAN_MULTIPLE_UNDERSCORE = re.compile(r"__+")
-
-__all__ = (
-    "camelize",
-    "check_email",
-    "slugify",
-    "snake_case",
-)
+# Insert underscore between lowercase/digit and uppercase letter
+_SNAKE_CASE_LOWER_OR_DIGIT_TO_UPPER = re.compile(r"(?<=[a-z0-9])(?=[A-Z])", re.UNICODE)
+# Insert underscore between uppercase letter and uppercase followed by lowercase
+_SNAKE_CASE_UPPER_TO_UPPER_LOWER = re.compile(r"(?<=[A-Z])(?=[A-Z][a-z])", re.UNICODE)
+# Replace hyphens, spaces, dots, and @ symbols with underscores for snake_case
+_SNAKE_CASE_HYPHEN_SPACE = re.compile(r"[.\s@-]+", re.UNICODE)
+# Collapse multiple underscores
+_SNAKE_CASE_MULTIPLE_UNDERSCORES = re.compile(r"__+", re.UNICODE)
+
+__all__ = ("camelize", "check_email", "slugify", "snake_case")
 
 
 def check_email(email: str) -> str:
@@ -68,10 +63,22 @@ def slugify(value: str, allow_unicode: bool = False, separator: Optional[str] =
         value = unicodedata.normalize("NFKC", value)
     else:
         value = unicodedata.normalize("NFKD", value).encode("ascii", "ignore").decode("ascii")
-    value = _SLUGIFY_REMOVE_INVALID_CHARS_RE.sub("", value.lower())
-    if separator is not None:
-        return _SLUGIFY_COLLAPSE_SEPARATORS_RE.sub("-", value).strip("-_").replace("-", separator)
-    return _SLUGIFY_COLLAPSE_SEPARATORS_RE.sub("-", value).strip("-_")
+    value = value.lower().strip()
+    sep = separator if separator is not None else "-"
+    if not sep:
+        # Remove all non-alphanumeric characters and return
+        return _SLUGIFY_REMOVE_NON_ALPHANUMERIC.sub("", value)
+    # Replace all runs of non-alphanumeric chars with the separator
+    value = _SLUGIFY_REMOVE_NON_ALPHANUMERIC.sub(sep, value)
+    # Remove leading/trailing separators and collapse multiple separators
+    # For dynamic separators, we need to use re.sub with escaped separator
+    if sep == "-":
+        # Use pre-compiled regex for common case
+        value = value.strip("-")
+        return _SLUGIFY_HYPHEN_COLLAPSE.sub("-", value)
+    # For other separators, use dynamic regex
+    value = re.sub(rf"^{re.escape(sep)}+|{re.escape(sep)}+$", "", value)
+    return re.sub(rf"{re.escape(sep)}+", sep, value)
 
 
 @lru_cache(maxsize=100)
@@ -94,6 +101,7 @@ def snake_case(string: str) -> str:
     Handles CamelCase, PascalCase, strings with spaces, hyphens, or dots
     as separators, and ensures single underscores. It also correctly
     handles acronyms (e.g., "HTTPRequest" becomes "http_request").
+    Handles Unicode letters and numbers.
 
     Args:
         string: The string to convert.
@@ -101,8 +109,32 @@ def snake_case(string: str) -> str:
     Returns:
         The snake_case version of the string.
     """
-    s = _SNAKE_CASE_RE_ACRONYM_SEQUENCE.sub(r"\1_\2", string)
-    s = _SNAKE_CASE_RE_LOWER_UPPER_TRANSITION.sub(r"\1_\2", s)
-    s = _SNAKE_CASE_RE_REPLACE_SEP.sub("_", s).lower()
-    s = _SNAKE_CASE_RE_CLEAN_MULTIPLE_UNDERSCORE.sub("_", s)
-    return s.strip("_")
+    if not string:
+        return ""
+    # 1. Replace hyphens and spaces with underscores
+    s = _SNAKE_CASE_HYPHEN_SPACE.sub("_", string)
+
+    # 2. Remove all non-alphanumeric characters except underscores
+    # TODO: move to a compiled regex at the top of the file
+    s = re.sub(r"[^\w]+", "", s, flags=re.UNICODE)
+
+    # 3. Insert an underscore between a lowercase/digit and an uppercase letter.
+    #    e.g., "helloWorld" -> "hello_World"
+    #    e.g., "Python3IsGreat" -> "Python3_IsGreat"
+    #    Uses a positive lookbehind `(?<=[...])` and a positive lookahead `(?=[...])`
+    s = _SNAKE_CASE_LOWER_OR_DIGIT_TO_UPPER.sub("_", s)
+
+    # 4. Insert an underscore between an uppercase letter and another
+    #    uppercase letter followed by a lowercase letter.
+    #    e.g., "HTTPRequest" -> "HTTP_Request"
+    #    This handles acronyms gracefully.
+    s = _SNAKE_CASE_UPPER_TO_UPPER_LOWER.sub("_", s)
+
+    # 5. Convert the entire string to lowercase.
+    s = s.lower()
+
+    # 6. Remove any leading or trailing underscores that might have been created.
+    s = s.strip("_")
+
+    # 7. Collapse multiple consecutive underscores into a single one.
+    return _SNAKE_CASE_MULTIPLE_UNDERSCORES.sub("_", s)

{sqlspec-0.11.1.dist-info → sqlspec-0.12.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sqlspec
-Version: 0.11.1
+Version: 0.12.0
 Summary: SQL Experiments in Python
 Project-URL: Discord, https://discord.gg/litestar
 Project-URL: Issue, https://github.com/litestar-org/sqlspec/issues/
@@ -11,14 +11,17 @@ License-Expression: MIT
 License-File: LICENSE
 License-File: NOTICE
 Requires-Python: <4.0,>=3.9
+Requires-Dist: click
 Requires-Dist: eval-type-backport; python_version < '3.10'
-Requires-Dist: sqlglot
+Requires-Dist: sqlglot>=19.9.0
 Requires-Dist: typing-extensions
 Provides-Extra: adbc
 Requires-Dist: adbc-driver-manager; extra == 'adbc'
 Requires-Dist: pyarrow; extra == 'adbc'
 Provides-Extra: aioodbc
 Requires-Dist: aioodbc; extra == 'aioodbc'
+Provides-Extra: aiosql
+Requires-Dist: aiosql; extra == 'aiosql'
 Provides-Extra: aiosqlite
 Requires-Dist: aiosqlite; extra == 'aiosqlite'
 Provides-Extra: asyncmy
@@ -27,28 +30,41 @@ Provides-Extra: asyncpg
 Requires-Dist: asyncpg; extra == 'asyncpg'
 Provides-Extra: bigquery
 Requires-Dist: google-cloud-bigquery; extra == 'bigquery'
+Provides-Extra: cli
+Requires-Dist: rich-click; extra == 'cli'
 Provides-Extra: duckdb
 Requires-Dist: duckdb; extra == 'duckdb'
 Provides-Extra: fastapi
 Requires-Dist: fastapi; extra == 'fastapi'
 Provides-Extra: flask
 Requires-Dist: flask; extra == 'flask'
+Provides-Extra: fsspec
+Requires-Dist: fsspec; extra == 'fsspec'
 Provides-Extra: litestar
 Requires-Dist: litestar; extra == 'litestar'
 Provides-Extra: msgspec
 Requires-Dist: msgspec; extra == 'msgspec'
 Provides-Extra: nanoid
 Requires-Dist: fastnanoid>=0.4.1; extra == 'nanoid'
+Provides-Extra: obstore
+Requires-Dist: obstore; extra == 'obstore'
+Provides-Extra: opentelemetry
+Requires-Dist: opentelemetry-instrumentation; extra == 'opentelemetry'
 Provides-Extra: oracledb
 Requires-Dist: oracledb; extra == 'oracledb'
 Provides-Extra: orjson
 Requires-Dist: orjson; extra == 'orjson'
+Provides-Extra: pandas
+Requires-Dist: pandas; extra == 'pandas'
+Requires-Dist: pyarrow; extra == 'pandas'
 Provides-Extra: performance
 Requires-Dist: msgspec; extra == 'performance'
 Requires-Dist: sqlglot[rs]; extra == 'performance'
 Provides-Extra: polars
 Requires-Dist: polars; extra == 'polars'
 Requires-Dist: pyarrow; extra == 'polars'
+Provides-Extra: prometheus
+Requires-Dist: prometheus-client; extra == 'prometheus'
 Provides-Extra: psqlpy
 Requires-Dist: psqlpy; extra == 'psqlpy'
 Provides-Extra: psycopg
@@ -63,7 +79,7 @@ Requires-Dist: pymysql; extra == 'pymysql'
 Provides-Extra: spanner
 Requires-Dist: google-cloud-spanner; extra == 'spanner'
 Provides-Extra: uuid
-Requires-Dist: uuid-utils>=0.6.1; extra == 'uuid'
+Requires-Dist: uuid-utils; extra == 'uuid'
 Description-Content-Type: text/markdown
 
 # SQLSpec
@@ -72,18 +88,26 @@ Description-Content-Type: text/markdown
 
 SQLSpec is an experimental Python library designed to streamline and modernize your SQL interactions across a variety of database systems. While still in its early stages, SQLSpec aims to provide a flexible, typed, and extensible interface for working with SQL in Python.
 
-**Note**: SQLSpec is currently under active development and the API is subject to change.  It is not yet ready for production use.  Contributions are welcome!
+**Note**: SQLSpec is currently under active development and the API is subject to change. It is not yet ready for production use. Contributions are welcome!
 
-## Core Features (Planned but subject to change, removal or redesign)
+## Core Features (Current and Planned)
+
+### Currently Implemented
 
 - **Consistent Database Session Interface**: Provides a consistent connectivity interface for interacting with one or more database systems, including SQLite, Postgres, DuckDB, MySQL, Oracle, SQL Server, Spanner, BigQuery, and more.
-- **Emphasis on RAW SQL and Minimal Abstractions and Performance**: SQLSpec is a library for working with SQL in Python.  It's goals are to offer minimal abstractions between the user and the database.  It does not aim to be an ORM library.
+- **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 it's own or with other libraries such as `litestar`, `fastapi`, `flask` and more.  (Contributions welcome!)
-- **Dynamic Query Manipulation**: Easily apply filters to pre-defined queries with a fluent, Pythonic API. Safely manipulate queries without the risk of SQL injection.
-- **Dialect Validation and Conversion**: Use `sqlglot` to validate your SQL against specific dialects and seamlessly convert between them.
+- **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!)
 - **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)
+
+- **SQL Builder API**: Type-safe query builder with method chaining (experimental and subject to significant changes)
+- **Dynamic Query Manipulation**: Apply filters to pre-defined queries with a fluent API. Safely manipulate queries without SQL injection risk.
+- **Dialect Validation and Conversion**: Use `sqlglot` to validate your SQL against specific dialects and seamlessly convert between them.
+- **Storage Operations**: Direct export to Parquet, CSV, JSON with Arrow integration
+- **Instrumentation**: OpenTelemetry and Prometheus metrics support
 - **Basic Migration Management**: A mechanism to generate empty migration files where you can add your own SQL and intelligently track which migrations have been applied.
 
 ## What SQLSpec Is Not (Yet)
@@ -94,16 +118,60 @@ SQLSpec is a work in progress. While it offers a solid foundation for modern SQL
 
 We've talked about what SQLSpec is not, so let's look at what it can do.
 
-These are just a few of the examples that demonstrate SQLSpec's flexibility and each of the bundled adapters offer the same config and driver interfaces.
+These are just a few examples that demonstrate SQLSpec's flexibility. Each of the bundled adapters offers the same config and driver interfaces.
+
+### Basic Usage
+
+```python
+from sqlspec import SQLSpec
+from sqlspec.adapters.sqlite import SqliteConfig
+from pydantic import BaseModel
+# Create SQLSpec instance and configure database
+sql = SQLSpec()
+config = sql.add_config(SqliteConfig(database=":memory:"))
+
+# Execute queries with automatic result mapping
+with sql.provide_session(config) as session:
+    # Simple query
+    result = session.execute("SELECT 'Hello, SQLSpec!' as message")
+    print(result.get_first())  # {'message': 'Hello, SQLSpec!'}
+```
+
+### SQL Builder Example (Experimental)
+
+**Warning**: The SQL Builder API is highly experimental and will change significantly.
+
+```python
+from sqlspec import sql
+
+# Build a simple query
+query = sql.select("id", "name", "email").from_("users").where("active = ?", True)
+print(query.build().sql)  # SELECT id, name, email FROM users WHERE active = ?
+
+# More complex example with joins
+query = (
+    sql.select("u.name", "COUNT(o.id) as order_count")
+    .from_("users u")
+    .left_join("orders o", "u.id = o.user_id")
+    .where("u.created_at > ?", "2024-01-01")
+    .group_by("u.name")
+    .having("COUNT(o.id) > ?", 5)
+    .order_by("order_count", desc=True)
+)
+
+# Execute the built query
+with sql.provide_session(config) as session:
+    results = session.execute(query.build())
+```
 
 ### DuckDB LLM
 
-This is a quick implementation using some of the built in Secret and Extension management features of SQLSpec's DuckDB integration.
+This is a quick implementation using some of the built-in Secret and Extension management features of SQLSpec's DuckDB integration.
 
-It allows you to communicate with any compatible OpenAPI conversations endpoint (such as Ollama).  This examples:
+It allows you to communicate with any compatible OpenAPI conversations endpoint (such as Ollama). This example:
 
 - auto installs the `open_prompt` DuckDB extensions
-- automatically creates the correct `open_prompt` comptaible secret required to use the extension
+- automatically creates the correct `open_prompt` compatible secret required to use the extension
 
 ```py
 # /// script
@@ -148,12 +216,12 @@ with sql.provide_session(etl_config) as session:
 
 ### DuckDB Gemini Embeddings
 
-In this example, we are again using DuckDB.  However, we are going to use the built in to call the Google Gemini embeddings service directly from the database.
+In this example, we are again using DuckDB. However, we are going to use the built-in to call the Google Gemini embeddings service directly from the database.
 
-This example will
+This example will:
 
 - auto installs the `http_client` and `vss` (vector similarity search) DuckDB extensions
-- when a connection is created, it ensures that the `generate_embeddings` macro exists in the DuckDB database.
+- when a connection is created, it ensures that the `generate_embeddings` macro exists in the DuckDB database
 - Execute a simple query to call the Google API
 
 ```py
@@ -199,8 +267,8 @@ etl_config = sql.add_config(
     )
 )
 with sql.provide_session(etl_config) as session:
-    result = session.select_one("SELECT generate_embedding('example text')")
-    print(result) # result is a dictionary when `schema_type` is omitted.
+    result = session.execute("SELECT generate_embedding('example text')")
+    print(result.get_first()) # result is a dictionary when `schema_type` is omitted.
 ```
 
 ### Basic Litestar Integration
@@ -215,11 +283,10 @@ In this example we are going to demonstrate how to create a basic configuration
 # ]
 # ///
 
-from aiosqlite import Connection
 from litestar import Litestar, get
 
 from sqlspec.adapters.aiosqlite import AiosqliteConfig, AiosqliteDriver
-from sqlspec.extensions.litestar import SQLSpec
+from sqlspec.extensions.litestar import DatabaseConfig, SQLSpec
 
 
 @get("/")
@@ -227,15 +294,18 @@ 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(), commit_mode="autocommit")],
+sqlspec = SQLSpec(
+    config=DatabaseConfig(
+        config=AiosqliteConfig(),
+        commit_mode="autocommit"
+    )
 )
 app = Litestar(route_handlers=[simple_sqlite], plugins=[sqlspec])
 ```
 
 ## Inspiration and Future Direction
 
-SQLSpec originally drew inspiration from features found in the `aiosql` library.  This is a great library for working with and executed SQL stored in files.  It's unclear how much of an overlap there will be between the two libraries, but it's possible that some features will be contributed back to `aiosql` where appropriate.
+SQLSpec originally drew inspiration from features found in the `aiosql` library. This is a great library for working with and executing SQL stored in files. It's unclear how much of an overlap there will be between the two libraries, but it's possible that some features will be contributed back to `aiosql` where appropriate.
 
 ## Current Focus: Universal Connectivity
 
@@ -275,9 +345,10 @@ This list is not final. If you have a driver you'd like to see added, please ope
         - `litestar/`: Litestar framework integration ✅
         - `fastapi/`: Future home of `fastapi` integration.
         - `flask/`: Future home of `flask` integration.
-        - `*/`: Future home of your favorite framework integration 🔌 ✨
+        - `*/`: Future home of your favorite framework integration
     - `base.py`: Contains base protocols for database configurations.
-    - `filters.py`: Contains the `Filter` class which is used to apply filters to pre-defined SQL queries.
+    - `statement/`: Contains the SQL statement system with builders, validation, and transformation.
+    - `storage/`: Contains unified storage operations for data import/export.
     - `utils/`: Contains utility functions used throughout the project.
     - `exceptions.py`: Contains custom exceptions for SQLSpec.
     - `typing.py`: Contains type hints, type guards and several facades for optional libraries that are not required for the core functionality of SQLSpec.

sqlspec-0.12.0.dist-info/RECORD

@@ -0,0 +1,145 @@
+sqlspec/__init__.py,sha256=hyVFQsYsgDWOZ2EPnW1LnATQVxGcYu3liBvSOvk4EQk,705
+sqlspec/__metadata__.py,sha256=hNP3wXvtk8fQVPKGjRLpZ9mP-gaPJqzrmgm3UqpDIXQ,460
+sqlspec/_serialization.py,sha256=7zox4G9zIps-DCdIEwYs4gwALfEOy1g_sWS4r5kpzO8,2604
+sqlspec/_sql.py,sha256=VvSttObOgEDN_qECiOZu07_c3pgC1f9cdOORn-xWc88,42463
+sqlspec/_typing.py,sha256=Vn1CTCfedAHZV3pKZP-l_mPw9pTxesCzRKVRypzNY_k,17903
+sqlspec/base.py,sha256=a7adbCUzohf1MU-iP0TxazGsk9fsJhJmxuFKNWkgC6o,18355
+sqlspec/config.py,sha256=a5VZj3UvK_St2XSchUw7NL3YBDpYp_FlaoVM8OkaI8I,13144
+sqlspec/exceptions.py,sha256=Qdfd1k9Q4rTDH15zja2UzCOYAbR7idN3xGutDYGg3eg,13934
+sqlspec/loader.py,sha256=1htipEcioTGrORu4sEYbK5w-zMnpWIZ4xSQlN-pJSf0,18336
+sqlspec/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlspec/typing.py,sha256=Wxc-ctN0hJ41U-qDzOaBA_HwTwAaQ7pN1nu0FpCNruA,20792
+sqlspec/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlspec/adapters/adbc/__init__.py,sha256=v9bs7501PgEyzR1XIsEpE2Wdrj9DOYkZ4grysw72UXk,218
+sqlspec/adapters/adbc/config.py,sha256=-wkuxXj-cqTFeIA7_mnPD37oZCHrnVjkOYKIwTZkD1Y,20159
+sqlspec/adapters/adbc/driver.py,sha256=22P16Pz6Bk399TSjoODLK1ZRcXxTHMGmjp_3KuCSUzM,16462
+sqlspec/adapters/aiosqlite/__init__.py,sha256=7wPmhXQeu4jRi-LZzPxAPTdgRmgmyqCn9U-4wnCWoLM,258
+sqlspec/adapters/aiosqlite/config.py,sha256=K8vPiGSDeSCTFIm4XgCEGbXG8uIAX6JjYHv2890RbTw,7174
+sqlspec/adapters/aiosqlite/driver.py,sha256=DelxxH9_TKHmqYDG3HbXEs4ypk8r-FUdBnGZOBNvHek,12398
+sqlspec/adapters/asyncmy/__init__.py,sha256=zYpebEt_PrNCifLcqXiCcWVm0Zl-LvWbFDromWwSTw8,270
+sqlspec/adapters/asyncmy/config.py,sha256=ZCwg63zsa-SEiHjJjCZYvnu-hl5cdw-o8j3u01_r7W4,10402
+sqlspec/adapters/asyncmy/driver.py,sha256=Q3dVCcm24z-Cvd2GcHaZKfP95cb5uk7u1-b8zuMQJpo,9982
+sqlspec/adapters/asyncpg/__init__.py,sha256=svnbKlOin8jRL88AdAqflBEU-WEAzp0Thc2y50QsxIo,310
+sqlspec/adapters/asyncpg/config.py,sha256=IHovVNGryGsu_ulYBY9TJrXaz_mPpqIgnh4c-juIglA,13033
+sqlspec/adapters/asyncpg/driver.py,sha256=U32J4W4RXvW5iQfqBI6_uhVqc4Kyaj2IpUe9BRJS8r4,19105
+sqlspec/adapters/bigquery/__init__.py,sha256=fWRH-BoCNX4rYwhU2DK64cXWpfkYpWIExddJAti0bxM,250
+sqlspec/adapters/bigquery/config.py,sha256=bTmos8OcJcy7kPmBds-0EPLe5XyREnwOR0YYd5fkZjg,16971
+sqlspec/adapters/bigquery/driver.py,sha256=46m5D-03mFnKM0rLwuvmeGAkRotbwm_qh6X0Re88H1I,28412
+sqlspec/adapters/duckdb/__init__.py,sha256=I1f6szfpKKrq6WhyDoUXD3i3NN4yjsh94_fhP1URI5M,351
+sqlspec/adapters/duckdb/config.py,sha256=az9WFJXyw1M0yiNw2tqf7GYM-9tblHj_0BHLYzFytXk,20413
+sqlspec/adapters/duckdb/driver.py,sha256=Vnr6xYJtqBKHAf76xy9o18GYly_oexkEfAd25Jd_CZ4,17676
+sqlspec/adapters/oracledb/__init__.py,sha256=nn3whn0UyBThoXnE1-5_byVuc9PJjvB2P896p7LpNZI,474
+sqlspec/adapters/oracledb/config.py,sha256=HQpgGMf0oMSWr2k4q3uPEF4LWR7QPnzZE6lxLDq723U,22737
+sqlspec/adapters/oracledb/driver.py,sha256=YQnudVnP1EizI4eN3_llITdJ7TjpbLNxFkYlkSJVaQs,25463
+sqlspec/adapters/psqlpy/__init__.py,sha256=dp0-96V4SAbNEvOqlJ8PWEyJMYzZGElVoyneZqJ-fbQ,297
+sqlspec/adapters/psqlpy/config.py,sha256=NKlHHDjKr5dF4LQprYA5ivJsNy2UXkvYg8B-kXOvvjE,16342
+sqlspec/adapters/psqlpy/driver.py,sha256=xI89mFdkQulcntbH4ALTOOHn5b6_skCgSbjYDUfvyG4,8650
+sqlspec/adapters/psycopg/__init__.py,sha256=ukkCUPrJPyAG78v4rOqcK4WZDs26PeB9Ra9qkFrGJ3E,484
+sqlspec/adapters/psycopg/config.py,sha256=pNgh0FAB_5dpRHBY9zKEs9uofDtUod2IV4pjCY_jWK8,27723
+sqlspec/adapters/psycopg/driver.py,sha256=oTdhj5OXx1gtnA0ZIS0Fdvqu8erXhItn1fl0-lRxatI,33474
+sqlspec/adapters/sqlite/__init__.py,sha256=1lYrJ-DojUAOvXMoZRUJNEVyMmYhO41hMJnDWCEeXlw,234
+sqlspec/adapters/sqlite/config.py,sha256=7yHe1eeVGFZvmTdxUPF2XcIiEcgZFUdncuGf_6qG8Xc,6153
+sqlspec/adapters/sqlite/driver.py,sha256=aQ7JOWyC6pfSq2cRz3OrjQ67NChhU0UercgvgomU0Ec,10703
+sqlspec/driver/__init__.py,sha256=0udRS5IlJ17HzOCvzapG8c_88yAwTQri1XLD_3fZxZU,671
+sqlspec/driver/_async.py,sha256=JYn-8E_IQHBCpAPfZ3g0IpNc_0yCwYu98lKgcHxWdPU,10130
+sqlspec/driver/_common.py,sha256=ceAvzvI9zV3xBotEAMCuJeEbCHaeV82UJyfYYNnrspk,14680
+sqlspec/driver/_sync.py,sha256=8jyP-TInSM3iLNhyOMNthvoE6vNwPp2wV8oAQhObuqc,10255
+sqlspec/driver/mixins/__init__.py,sha256=-FSWLYq644NftRsmjmXMA9Q7_l7tIFAIh1ZyK0yrba8,652
+sqlspec/driver/mixins/_pipeline.py,sha256=XCr4PTUvvzvte2Yw1g-hqje5dg3bgrsi46kj8kdy8Hw,20083
+sqlspec/driver/mixins/_result_utils.py,sha256=j6BrFCC9E6xbnn-mH0sd2JBlxZFjA30LWKrYZh8gjXM,4882
+sqlspec/driver/mixins/_sql_translator.py,sha256=p_PR4KBg9NKNpRpiEqA0hcUIttpdillHpnLUVJEcxuE,1519
+sqlspec/driver/mixins/_storage.py,sha256=yosmC_nJI-3dg4aVy6iloy4V-d9DBDoC_8G2RLTsenI,43106
+sqlspec/driver/mixins/_type_coercion.py,sha256=17HC2Vsd70tRlUawO0CkUeoJUd2jG5R5Yb1A6Jr-1Tc,4716
+sqlspec/extensions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlspec/extensions/aiosql/__init__.py,sha256=-9cefc9pYPf9vCgALoB-y1DtmcgRjKe2azfl6RIarAA,414
+sqlspec/extensions/aiosql/adapter.py,sha256=EcMzTQ2-EzH-C2G1nJ6dw5O09rUzdAclmgbFb9wkJ8E,16993
+sqlspec/extensions/litestar/__init__.py,sha256=aXF2g4-U86pdJHoOA6RCvZgnyHVBbjRhlWqcSuRX2gg,243
+sqlspec/extensions/litestar/_utils.py,sha256=o-FuUj1_WkDrLxQxiP6hXDak66XfyRP3QLyEVKrIRjI,1954
+sqlspec/extensions/litestar/config.py,sha256=vLXM425tCV3IbJiNO1ZG90ctjBTb9oQCuLsqCaUYmo8,4685
+sqlspec/extensions/litestar/handlers.py,sha256=q-peGdWgvEI_s9rWt0SRIQvuhON_ItrjiVxIF2Pwm1U,10546
+sqlspec/extensions/litestar/plugin.py,sha256=itsduzXN-YzDm1wVqUcJQLcYGp3ogF9Aw2IU3i46iqk,5596
+sqlspec/extensions/litestar/providers.py,sha256=9wAr3c09ObOJmej1hQ3YizrK3YMN3S2xfBh23r-KSzE,21749
+sqlspec/service/__init__.py,sha256=EfyTy8X8GXxV0drxaBMJ0aRRqg3ZnwD6iu5oCTAQc1k,79
+sqlspec/service/base.py,sha256=vbJFO0EywWUgGr8WHHYxUCP-7sGF1Rxfi7ov51LWg50,521
+sqlspec/service/pagination.py,sha256=ndLQwsvswoISWEE_3IG9nmdHt42OZkVMJvr-2HTWsLw,619
+sqlspec/statement/__init__.py,sha256=NDvdrpr1EqAZXp4HmhTVaRnWVscahPSHpmSO8DHSoMY,536
+sqlspec/statement/filters.py,sha256=SPDupr8mJK1Ua3z2sXvE8dWAkamDAhE2MHn6yEM_6uU,21850
+sqlspec/statement/parameters.py,sha256=HjKg6Y-1ImBiigNlodGxsVOMPma1pBoJRISrQu_iqfM,31183
+sqlspec/statement/result.py,sha256=rEShBX-NGK3-0K6q1XwB0zQvPEygVVB_-rXodiUMbSo,18307
+sqlspec/statement/splitter.py,sha256=Y1eubbNSn3IRhvQhAZVzBB-oDZ5K5uoJYOGti1ds_5E,24850
+sqlspec/statement/sql.py,sha256=7H2LOwQ8H2pONFPF7RcK6WkF7g_J-FUeuoiSXD05AUs,51033
+sqlspec/statement/builder/__init__.py,sha256=7mITd7RG_Sc4RBgQJoAAosLAV9WdF4-E-CzvUA-hT0A,1584
+sqlspec/statement/builder/_ddl_utils.py,sha256=or0DpLIUupCIxs3u6kMJQgmfj_P21TxMDHbM0rdSNnY,4745
+sqlspec/statement/builder/_parsing_utils.py,sha256=OKOB-V1UhOCUNVoJHDArUl0WKIMVPshCFFrJcjKvs9Y,5613
+sqlspec/statement/builder/base.py,sha256=swpCj0Oga3HyLKKmriwsu046puvkTxTZ528SPa9v_kk,12771
+sqlspec/statement/builder/ddl.py,sha256=0GjjPc8u3FP_5kFza-J2kw0B0PBlibgjAu7kCgDMwXI,50394
+sqlspec/statement/builder/delete.py,sha256=yv78i2vWpRZ0NbQCkJz1JAYekius2MOZ_zmiVaP4fcw,2423
+sqlspec/statement/builder/insert.py,sha256=EduHjewraoauM4mH3r4OyrBc31FbCAad93B8vg9WpYc,9922
+sqlspec/statement/builder/merge.py,sha256=tNV81MiDUmQJ9KiInP8rEGvxQ50JAD2Itmdbr5921vI,2811
+sqlspec/statement/builder/protocols.py,sha256=ihy6uNv6lGdj1UHu-qWn08YhIn_YfjPup0qsBnaB1zU,575
+sqlspec/statement/builder/select.py,sha256=13dNa7XXHjGlSeRsjWTrOCZX0uK61mMbiRzk1gTq8is,8436
+sqlspec/statement/builder/update.py,sha256=K2DxlZM9e0DoO4T5MbeVNL9BCkhov7z8c6L9zuvjttc,5950
+sqlspec/statement/builder/mixins/__init__.py,sha256=B5GhsdySb_-DN3SvBlA2oimmymAJX3Rf4A7Xnz3uNN4,2887
+sqlspec/statement/builder/mixins/_aggregate_functions.py,sha256=RU91GKzwKABod-nHxhrT2nCoYFAf-kSE4VHmF23n__Y,6109
+sqlspec/statement/builder/mixins/_case_builder.py,sha256=fGdevoEZxmoJjsDV9Wwfom8vu3lmgF9B_o5HXCf25Kg,3047
+sqlspec/statement/builder/mixins/_common_table_expr.py,sha256=1e8KKoQjuMGKuutjZ4KFWhsH7mbRMhXsANqLLJ71SzA,3741
+sqlspec/statement/builder/mixins/_delete_from.py,sha256=GtuTYfG7N9RPAbyXIGKCoirRTg_gcHyoGI6pAFhUkEY,1026
+sqlspec/statement/builder/mixins/_from.py,sha256=YOYG-Bvpis9Wt2RI4byr_eRef35OXS6rBuigGsEOGW0,2618
+sqlspec/statement/builder/mixins/_group_by.py,sha256=qefERqljQY58PmJ3Q0nF8NNSO31fa2XDbevIpjiPzJs,4190
+sqlspec/statement/builder/mixins/_having.py,sha256=X8-hdwEeJg4RYxyjhaYLvlkpzE0AwIPl6t8SPGz5gi0,1112
+sqlspec/statement/builder/mixins/_insert_from_select.py,sha256=XBahvM2VA-qwzx3PLTRaqT21fFaRYwHACOADQ6mZwUE,1851
+sqlspec/statement/builder/mixins/_insert_into.py,sha256=7979JCYqKM_NRTHwkrJJY6l9lS2AQ-evZYRU8fs3yw0,1049
+sqlspec/statement/builder/mixins/_insert_values.py,sha256=RE2ApSc6OwVqToXTVwy1bhRFomfNOmrnSte8fVjEINg,2923
+sqlspec/statement/builder/mixins/_join.py,sha256=g3OxKMEiyNSGZRiBgdPT1Lvcr-h3u_3O0msN59B1Itg,5128
+sqlspec/statement/builder/mixins/_limit_offset.py,sha256=nyeajD1cYj0Wvki1GLYJbsfQzfaH5tyMkeGVU9fGWL0,1762
+sqlspec/statement/builder/mixins/_merge_clauses.py,sha256=3w22HImSoQvDMMTa9xJAHw4cx0-KrteLumFpQvg2o0I,16868
+sqlspec/statement/builder/mixins/_order_by.py,sha256=pcqEQIkpJ-KgLNLIqXFQQgdzGypXw0Umndn-X8TgKis,1729
+sqlspec/statement/builder/mixins/_pivot.py,sha256=GyLEFkhRlG_fxeRfzGRTVd5wZVtuA5HkNrvmOi7PF3Q,3442
+sqlspec/statement/builder/mixins/_returning.py,sha256=O39j2MEIcqiiUhFFGnyGwIXhLS7KrGigfZ9kPxFjjtI,1349
+sqlspec/statement/builder/mixins/_select_columns.py,sha256=6UXpHHDmka8NbrtbR-G-Xd1ux4DUazEonZndAXecWJI,2302
+sqlspec/statement/builder/mixins/_set_ops.py,sha256=uWV32ZAi2tojbS9b6Q0ZDIn1Rhbx4cCE42jhbVdm90I,5291
+sqlspec/statement/builder/mixins/_unpivot.py,sha256=dXdYk4UdFbDf7yNFRPrX3G5XtOgfw_BzaEI9au3ltKw,3296
+sqlspec/statement/builder/mixins/_update_from.py,sha256=r8-_iy5Kdp79eo34oNmNVLSnWsy3WUvwETODnKzBgZY,2461
+sqlspec/statement/builder/mixins/_update_set.py,sha256=tSnZ6cLKfta-OKHYAkoInQScMbxp9rxtFj0SBGnpGZ0,4041
+sqlspec/statement/builder/mixins/_update_table.py,sha256=FX3KezuHdu7YLQI4i5iniHWk1Lbzph8MzLcOM6iTd70,936
+sqlspec/statement/builder/mixins/_where.py,sha256=KZhOykAWrDYaD6p_W-nbVkh3-9ZS9paw77L3JttoeT8,19452
+sqlspec/statement/builder/mixins/_window_functions.py,sha256=8ldy06gK6jOlGg31oa1dCrG7IkfCVYvVr_f-lx0YcgU,3745
+sqlspec/statement/pipelines/__init__.py,sha256=vmFxkD7vnpyfMbuDsOF67B3DWDeCz183326pg1G0-5k,2206
+sqlspec/statement/pipelines/base.py,sha256=ylXSyab6P4v9PY0tDPlcHeCEkdFPECDq0Jjooi3E2ek,13019
+sqlspec/statement/pipelines/context.py,sha256=fhEKicpUcHXbyhgBpJnYnYPd4vWpkFoVuLWydsSB2dE,4371
+sqlspec/statement/pipelines/result_types.py,sha256=G34HofWjcK0SFMTyqVBFv-t17jkWKP9cCugA4Rds4qk,1046
+sqlspec/statement/pipelines/analyzers/__init__.py,sha256=RY7W0AiWG-8qdrTmRSGlEofjrPPJCJUnNK-LRukKt5Q,330
+sqlspec/statement/pipelines/analyzers/_analyzer.py,sha256=8Cfxr4gZZlfmn4v3tatyqF4i10s6L9lFXRYwcVB_zn4,27741
+sqlspec/statement/pipelines/transformers/__init__.py,sha256=wwhAWQQCCoL2WhVZQ7ptt9mn4B_AY8pK9M2SUjj5DtU,550
+sqlspec/statement/pipelines/transformers/_expression_simplifier.py,sha256=90u62-WMG0l1_2S_u-93Oo3rVnAjvlTJkPf1IzgaP2E,11630
+sqlspec/statement/pipelines/transformers/_literal_parameterizer.py,sha256=NMzSYZ6HfqoujOm_M5pS95oxOhF3_kWrQZjWln4UGEI,26624
+sqlspec/statement/pipelines/transformers/_remove_comments.py,sha256=PW1q7B2D-E_x2V1mTEUw_Uijj9W5-B6OteWE96aH7i8,2781
+sqlspec/statement/pipelines/transformers/_remove_hints.py,sha256=D13MDx9vG3n_y5VV6swTNx2z1zHnTAuRwOiKp0VYg2k,3334
+sqlspec/statement/pipelines/validators/__init__.py,sha256=cdlwdLhOT2OwTbueIsA7bfRG2b6y-j7dw9pMzl5AP0M,747
+sqlspec/statement/pipelines/validators/_dml_safety.py,sha256=FUfF7iWUc0tgmg-OwDgpYA3ZRy3z01PfGadDcaqENTM,10078
+sqlspec/statement/pipelines/validators/_parameter_style.py,sha256=I6tTeYBQFeg2uPlQWDyy7sMRidm_tt7ItTzhauhNrWA,13583
+sqlspec/statement/pipelines/validators/_performance.py,sha256=sSIknorC-VJghFJAATqfnnNUyUnQ0bN_GpXmmGZkkkA,25800
+sqlspec/statement/pipelines/validators/_security.py,sha256=62k5F4RCz1O_bb1rIPjm2BjHyp3YDObq2hjv74zY8Ac,43589
+sqlspec/statement/pipelines/validators/base.py,sha256=6xd0FCPOTpS77cn-abT1auubxASs5HPY2fgjhX1WZZQ,2166
+sqlspec/storage/__init__.py,sha256=dS1Qt2cTJpIBOKnw3ih3Z7FPFePFPPSazhkEbkV5DxU,516
+sqlspec/storage/protocol.py,sha256=4hiGGmWtMZFkwCaNYXHt416j-i281xha0Hj7-EynVBs,6430
+sqlspec/storage/registry.py,sha256=it3S-jxf-rXcYwgquydiSo0AeXXqnBEhAVQ2Gk11GNU,11724
+sqlspec/storage/backends/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlspec/storage/backends/base.py,sha256=34XYQuz1tQ-q_ZZwOz-Kimgvl088SR3VUYJoA-STslc,6350
+sqlspec/storage/backends/fsspec.py,sha256=bCaNkubANlcb3UlUC0EchHn44XJRS3Z-99fnZMgW-yc,12527
+sqlspec/storage/backends/obstore.py,sha256=HdnEGQOPvQY9q7xEsjdy7JIqj-tWNBLkmEmllbDgAWA,20659
+sqlspec/utils/__init__.py,sha256=_Ya8IZuc2cZIstXr_xjgnSfxICXHXvu5mfWsi2USDrw,183
+sqlspec/utils/correlation.py,sha256=qzqw3CnhasS14hv0uHKh9DehbOX3dEHuB_NNz6Kg6QQ,4457
+sqlspec/utils/deprecation.py,sha256=zrmb_eKRlLWVA6dWrjUbN3Vz6D3_-Z_15Ixk4H-sDRk,3850
+sqlspec/utils/fixtures.py,sha256=q_Pghpmw2VgJ9P0TfkyjSF5PvdaD5Y2Laha0Bj4IDrA,1838
+sqlspec/utils/logging.py,sha256=g8lZXfbr79Ayu0YnnoOcwzGGeg9HUg_JyFpAbbUCd_0,4064
+sqlspec/utils/module_loader.py,sha256=9LcmEhy4T0jgkCaDVkxX47PSgJOMeJ8IV67yXEWBp-U,3074
+sqlspec/utils/serializers.py,sha256=TKsRryRcYMnb8Z8MGkYGClIxcYvC8CW7MsrPQTJqEcY,154
+sqlspec/utils/singleton.py,sha256=KZ7481tlDAxq6gcAlpULVqPLNc9P0XkHOEp7hfWIHcI,1096
+sqlspec/utils/sync_tools.py,sha256=9ZL_7wJks896ZsRGVB4mS8DgIwK3tKmZClvLblEx8q4,8954
+sqlspec/utils/text.py,sha256=Bit0I0nBgETvfumzguOQFiqrqwplqaoTeEfGdLzgPOk,5083
+sqlspec-0.12.0.dist-info/METADATA,sha256=fUqPZZSl8key5koLqohfDZ2IUlyJ1Z1qbokEcLYdSS8,16663
+sqlspec-0.12.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+sqlspec-0.12.0.dist-info/licenses/LICENSE,sha256=MdujfZ6l5HuLz4mElxlu049itenOR3gnhN1_Nd3nVcM,1078
+sqlspec-0.12.0.dist-info/licenses/NOTICE,sha256=Lyir8ozXWov7CyYS4huVaOCNrtgL17P-bNV-5daLntQ,1634
+sqlspec-0.12.0.dist-info/RECORD,,

sqlspec/adapters/bigquery/config/__init__.py

@@ -1,3 +0,0 @@
-from sqlspec.adapters.bigquery.config._sync import BigQueryConfig, BigQueryConnectionConfig
-
-__all__ = ("BigQueryConfig", "BigQueryConnectionConfig")

sqlspec/adapters/bigquery/config/_common.py

@@ -1,40 +0,0 @@
-from dataclasses import dataclass, field
-from typing import TYPE_CHECKING, Optional
-
-from google.cloud.bigquery import LoadJobConfig, QueryJobConfig
-
-if TYPE_CHECKING:
-    from google.api_core.client_info import ClientInfo
-    from google.api_core.client_options import ClientOptions
-    from google.auth.credentials import Credentials
-
-__all__ = ("BigQueryConnectionConfigCommon",)
-
-
-@dataclass
-class BigQueryConnectionConfigCommon:
-    """Common configuration options for BigQuery."""
-
-    project: "Optional[str]" = field(default=None)
-    """Google Cloud project ID."""
-    location: "Optional[str]" = field(default=None)
-    """Default geographic location for jobs and datasets."""
-    credentials: "Optional[Credentials]" = field(default=None, hash=False)
-    """Credentials to use for authentication."""
-    dataset_id: "Optional[str]" = field(default=None)
-    """Default dataset ID to use if not specified in queries."""
-    credentials_path: "Optional[str]" = field(default=None)
-    """Path to Google Cloud service account key file (JSON). If None, attempts default authentication."""
-    client_options: "Optional[ClientOptions]" = field(default=None, hash=False)
-    """Client options used to set user options on the client (e.g., api_endpoint)."""
-    default_query_job_config: "Optional[QueryJobConfig]" = field(default=None, hash=False)
-    """Default QueryJobConfig settings."""
-    default_load_job_config: "Optional[LoadJobConfig]" = field(default=None, hash=False)
-    """Default LoadJobConfig settings."""
-    client_info: "Optional[ClientInfo]" = field(default=None, hash=False)
-    """Client info used to send a user-agent string along with API requests."""
-
-    def __post_init__(self) -> None:
-        """Post-initialization hook."""
-        if self.default_query_job_config is None:
-            self.default_query_job_config = QueryJobConfig(default_dataset=self.dataset_id)

sqlspec/adapters/bigquery/config/_sync.py

@@ -1,87 +0,0 @@
-import contextlib
-from dataclasses import dataclass, field
-from typing import TYPE_CHECKING, Any, Optional
-
-from sqlspec.adapters.bigquery.config._common import BigQueryConnectionConfigCommon
-from sqlspec.adapters.bigquery.driver import BigQueryConnection, BigQueryDriver
-from sqlspec.base import NoPoolSyncConfig
-from sqlspec.typing import dataclass_to_dict
-
-if TYPE_CHECKING:
-    from collections.abc import Iterator
-
-__all__ = ("BigQueryConfig", "BigQueryConnectionConfig")
-
-
-class BigQueryConnectionConfig(BigQueryConnectionConfigCommon):
-    """BigQuery Connection Configuration."""
-
-
-@dataclass
-class BigQueryConfig(NoPoolSyncConfig["BigQueryConnection", "BigQueryDriver"]):
-    """BigQuery Synchronous Driver Configuration."""
-
-    connection_config: "BigQueryConnectionConfig" = field(default_factory=BigQueryConnectionConfig)
-    """BigQuery Connection Configuration."""
-    driver_type: "type[BigQueryDriver]" = field(init=False, repr=False, default=BigQueryDriver)
-    """BigQuery Driver Type."""
-    connection_type: "type[BigQueryConnection]" = field(init=False, repr=False, default=BigQueryConnection)
-    """BigQuery Connection Type."""
-    pool_instance: "None" = field(init=False, repr=False, default=None, hash=False)
-    """This is set to have a init=False since BigQuery does not support pooling."""
-    connection_instance: "Optional[BigQueryConnection]" = field(init=False, repr=False, default=None, hash=False)
-    """BigQuery Connection Instance."""
-
-    @property
-    def connection_config_dict(self) -> "dict[str, Any]":
-        """Return the connection configuration as a dict.
-
-        Returns:
-            A string keyed dict of config kwargs for the BigQueryConnection constructor.
-        """
-        return dataclass_to_dict(
-            self.connection_config,
-            exclude_empty=True,
-            exclude_none=True,
-            exclude={"dataset_id", "credentials_path"},
-        )
-
-    def create_connection(self) -> "BigQueryConnection":
-        """Create a BigQuery Client instance.
-
-        Returns:
-            A BigQuery Client instance.
-        """
-        if self.connection_instance is not None:
-            return self.connection_instance
-
-        self.connection_instance = self.connection_type(**self.connection_config_dict)
-        return self.connection_instance
-
-    @contextlib.contextmanager
-    def provide_connection(self, *args: Any, **kwargs: Any) -> "Iterator[BigQueryConnection]":
-        """Provide a BigQuery client within a context manager.
-
-        Args:
-            *args: Additional arguments to pass to the connection.
-            **kwargs: Additional keyword arguments to pass to the connection.
-
-        Yields:
-            An iterator of BigQuery Client instances.
-        """
-        conn = self.create_connection()
-        yield conn
-
-    @contextlib.contextmanager
-    def provide_session(self, *args: Any, **kwargs: Any) -> "Iterator[BigQueryDriver]":
-        """Provide a BigQuery driver session within a context manager.
-
-        Args:
-            *args: Additional arguments to pass to the driver.
-            **kwargs: Additional keyword arguments to pass to the driver.
-
-        Yields:
-            An iterator of BigQueryDriver instances.
-        """
-        conn = self.create_connection()
-        yield self.driver_type(connection=conn)