Metadata-Version: 2.4
Name: tigrbl_engine_bigquery
Version: 0.1.1.dev9
Summary: Tigrbl engine plugin for Google BigQuery.
Author-email: Jacob Stewart <jacob@swarmauri.com>
License: Apache-2.0
Keywords: tigrbl,engine,plugin,bigquery,google-cloud,analytics
Classifier: Development Status :: 1 - Planning
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Environment :: Plugins
Classifier: Intended Audience :: Developers
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries
Requires-Python: <3.13,>=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: tigrbl>=0.1.0
Requires-Dist: google-cloud-bigquery>=3.25
Dynamic: license-file

# tigrbl_engine_bigquery

A BigQuery engine plugin for **tigrbl**. This package registers a new engine kind
`"bigquery"` that tigrbl auto-discovers via the `tigrbl.engine` entry-point group.

## Installation

```bash
pip install tigrbl_engine_bigquery
```

## Usage

Once installed, just refer to `kind="bigquery"` in your engine spec:

```python
from tigrbl.engine.engine_spec import EngineSpec

spec = EngineSpec(kind="bigquery", mapping={"project": "my-gcp-project", "default_dataset": "analytics"})
provider = spec.to_provider()
engine, make_session = provider.ensure()   # triggers external plugin registration
session = make_session()                   # returns a BigQuerySession

# Optionally run SQL via the session (see session.query method stub)
```

This package exposes:
- `BigQueryEngine` (engine handle/config)
- `BigQuerySession` (simple session wrapper)
- `bigquery_engine` (builder used by tigrbl)
- `register()` (called by tigrbl’s plugin loader)
