Metadata-Version: 2.4
Name: gluondb
Version: 0.1.0
Summary: Official Python SDK for the GluonDB public API
Project-URL: Homepage, https://gluondb.com
Project-URL: Repository, https://github.com/gluonDB/gluondb_sdk
Project-URL: Documentation, https://docs.gluondb.com
Project-URL: Changelog, https://github.com/gluonDB/gluondb_sdk/blob/main/CHANGELOG.md
Project-URL: Bug Tracker, https://github.com/gluonDB/gluondb_sdk/issues
Author: GluonDB
Maintainer: GluonDB
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: api,database,gluondb,sdk,sql
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
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: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: httpx>=0.25
Provides-Extra: pandas
Requires-Dist: pandas>=1.5; extra == 'pandas'
Description-Content-Type: text/markdown

# GluonDB Python SDK

Official Python SDK for the GluonDB public API.

## Install

```bash
pip install gluondb
```

## Quick Start

```python
from gluondb import GluonDB

gluon = GluonDB(api_key="gluon_...")
pg = gluon.datasource("your-datasource-id")

result = pg.query("SELECT * FROM users LIMIT 10")
print(result.rows)
```

## Optional pandas integration

```bash
pip install "gluondb[pandas]"
```

## Configuration

- `api_key` (required): GluonDB API key.
- `base_url` (default: `https://api.gluondb.com`): API base URL.
- `api_version` (default: `v1`): API version segment.
- `timeout` (default: `30.0`): HTTP timeout in seconds.

## License

Apache-2.0
