Metadata-Version: 2.4
Name: adbc-driver-gizmosql
Version: 2.0.0
Summary: Python ADBC driver for GizmoSQL (native Go driver core) with OAuth/SSO support
Author-email: GizmoData <support@gizmodata.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/gizmodata/gizmosql-adbc
Project-URL: Repository, https://github.com/gizmodata/gizmosql-adbc
Project-URL: Issues, https://github.com/gizmodata/gizmosql-adbc/issues
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Database
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: adbc-driver-manager>=1.12.0
Requires-Dist: pyarrow>=14.0.0
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Requires-Dist: pytest-cov; extra == "test"
Requires-Dist: gizmosql<2,>=1.32.0; extra == "test"
Requires-Dist: cryptography>=49; extra == "test"
Provides-Extra: dev
Requires-Dist: ruff; extra == "dev"
Requires-Dist: build; extra == "dev"

# adbc-driver-gizmosql

Python [ADBC](https://arrow.apache.org/adbc/) driver for
[GizmoSQL](https://gizmodata.com/gizmosql) with OAuth/SSO support.

Version 2.0 is a thin Python binding over the native Go GizmoSQL ADBC
driver (`libadbc_driver_gizmosql`, bundled in the wheel), keeping the
1.x API byte-compatible. GizmoSQL-specific behavior — the `gizmosql://`
URI scheme, DDL/DML immediate execution under GizmoSQL's lazy-execution
model, and `RETURNING` eager materialization — lives inside the shared
library and is identical across every ADBC language.

```python
from adbc_driver_gizmosql import dbapi as gizmosql

with gizmosql.connect("gizmosql://localhost:31337",
                      username="gizmosql_user",
                      password="gizmosql_password",
                      tls_skip_verify=True) as conn:
    with conn.cursor() as cur:
        cur.execute("SELECT 1 AS value")
        print(cur.fetch_arrow_table())
```

See the [project README](https://github.com/gizmodata/gizmosql-adbc#readme)
for full documentation, including OAuth/SSO, connection profiles, and
observability.
