Metadata-Version: 2.4
Name: agentic-coop-db
Version: 0.3.1
Summary: Auth gateway client for shared PostgreSQL — sends parameterised SQL over HTTPS.
Project-URL: Homepage, https://github.com/fheinfling/agentic-coop-db
Project-URL: Source, https://github.com/fheinfling/agentic-coop-db
Project-URL: Issues, https://github.com/fheinfling/agentic-coop-db/issues
Author: Franz Heinfling
License: Apache-2.0
Keywords: auth,gateway,pgvector,postgres,postgresql,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: platformdirs>=4.2
Requires-Dist: requests>=2.32
Requires-Dist: typer>=0.12
Provides-Extra: dev
Requires-Dist: mypy>=1.10; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8; extra == 'dev'
Requires-Dist: ruff>=0.5; extra == 'dev'
Requires-Dist: types-requests; extra == 'dev'
Description-Content-Type: text/markdown

# agentcoopdb (Python client)

A thin Python client for [Agentic Coop DB](https://github.com/fheinfling/agentic-coop-db), the
auth gateway for shared PostgreSQL.

```python
from agentcoopdb import connect

db = connect("https://db.example.com", api_key="acd_live_...")
db.execute(
    "INSERT INTO notes(id, body) VALUES ($1, $2)",
    ["b9c3...", "hi"],
)
rows = db.select("SELECT * FROM notes WHERE owner = $1", ["alice"])
```

## Install

```bash
pip install agentic-coop-db
```

Or install directly from GitHub (the Python client lives in a subdirectory):

```bash
pip install "agentic-coop-db @ git+https://github.com/fheinfling/agentic-coop-db.git#subdirectory=clients/python"
```

## CLI

```bash
agentic-coop-db init                  # interactive onboarding wizard
agentic-coop-db me
agentic-coop-db sql "SELECT 1"
agentic-coop-db queue flush
agentic-coop-db doctor
```

See the [main repo](https://github.com/fheinfling/agentic-coop-db) for the full docs.
