Metadata-Version: 2.4
Name: rivera
Version: 0.0.1
Summary: Python client for the Rivera service
Author: Rivera
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.31

# Rivera Python Client

Python SDK for talking to a Rivera service.

## Install

```
pip install rivera
```

## Quick start

```python
from rivera import RiveraClient

# Create the base client with backend credentials
client = RiveraClient(
    base_url="https://demo.rivera.app",
    api_key="backend-api-key",
)

# Manage collections via the backend namespace
client.backend.collections.create({"name": "orders"})

# Sign a tenant and derive a frontend-scoped client
signed = client.backend.sign("tenant-123")
tenant_client = client.with_identity(signed)

# Frontend operations require the signed identity
tenant_client.frontend.records.create("orders", {"id": "o1", "status": "pending"})
records = tenant_client.frontend.records.list("orders")
```

## Developing

```
python -m venv .venv
source .venv/bin/activate
pip install -e .[dev]
pytest
```

## License

MIT
