Metadata-Version: 2.4
Name: tigrbl_engine_duckdb
Version: 0.1.1.dev20
Summary: DuckDB engine extension for Tigrbl (optional plugin).
Project-URL: Homepage, https://github.com/swarmauri/swarmauri-sdk
Project-URL: Repository, https://github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/experimental/tigrbl_engine_duckdb
Author-email: Jacob Stewart <jacob@swarmauri.com>
License:                                  Apache License
                                   Version 2.0, January 2004
                                http://www.apache.org/licenses/
        
           TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
        
           1. Definitions.
           ...
        END OF TERMS AND CONDITIONS
License-File: LICENSE
Keywords: experimental,tigrbl,tigrbl_engine_duckdb
Classifier: Development Status :: 1 - Planning
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: <3.13,>=3.10
Requires-Dist: duckdb>=1.0.0
Requires-Dist: tigrbl>=0.3.0.dev4
Description-Content-Type: text/markdown

# tigrbl_engine_duckdb

DuckDB engine extension for **Tigrbl**. This package registers the `duckdb`
engine kind with Tigrbl’s engine registry via entry points.

## Install

```bash
pip install tigrbl_engine_duckdb
```

## Use

After installing, you can bind DuckDB using `engine_ctx`:

```python
from tigrbl.engine.decorators import engine_ctx
from tigrbl.session.decorators import session_ctx

@engine_ctx({"kind": "duckdb", "path": "./data/app.duckdb",
             "pragmas": {"memory_limit": "2GB"}})
@session_ctx({"isolation": "repeatable_read"})
class AnalyticsAPI:
    pass
```

No import of this package is required in your app; Tigrbl auto-loads the
plugin via entry points on import.
