Metadata-Version: 2.4
Name: progressdb
Version: 0.1.3
Summary: ProgressDB backend Python SDK
Author: ProgressDB
License: MIT
Requires-Python: >=3.8
Description-Content-Type: text/markdown

# ProgressDB Python SDK (backend)

Lightweight Python SDK for backend callers of ProgressDB. Designed for server-side use (holds backend/admin API keys).

Install (when published):

  pip install progressdb

Quickstart

```py
from progressdb import ProgressDBClient

client = ProgressDBClient(base_url='https://api.example.com', api_key='ADMIN_KEY')

# Sign a user id (backend-only)
sig = client.sign_user('user-123')

# Create a thread
thread = client.create_thread({'title': 'General'})

# Create a message
msg = client.create_message({'thread': thread['id'], 'body': {'text': 'hello'}})
```

Features

- `sign_user(user_id)` — calls `POST /v1/_sign` (backend-only)
- `admin_health()`, `admin_stats()` — admin endpoints
-- Thread and message helpers: `list_threads(author=None, title=None, slug=None)`, `create_thread`, `create_message`, `delete_thread`, etc.

Note: `list_threads` accepts optional query filters `author`, `title`, and `slug`.
Backend callers should provide `author` (either via this parameter or the
`X-User-ID` header) when using backend/admin keys because the server requires an
author to be resolved for this endpoint.
