Metadata-Version: 2.4
Name: dorc-client
Version: 0.0.1
Summary: Python SDK for dorc-engine HTTP API
Project-URL: Repository, https://github.com/dorc-io/dorc-clients
Project-URL: Issues, https://github.com/dorc-io/dorc-clients/issues
Author: DORC
License: Apache-2.0
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 :: Only
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: Typing :: Typed
Requires-Python: >=3.9
Requires-Dist: httpx>=0.25.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: tenacity>=8.2.0
Provides-Extra: dev
Requires-Dist: build>=1.2.0; extra == 'dev'
Requires-Dist: pytest-httpx>=0.27.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Requires-Dist: twine>=5.0.0; extra == 'dev'
Description-Content-Type: text/markdown

## dorc-client (Python)

Minimal Python SDK for the `dorc-engine` HTTP API.

### Install

```bash
pip install dorc-client
```

### Environment variables

- **`DORC_BASE_URL`**: base URL of dorc-engine (example: `https://dorc-engine-xxxxx.us-east1.run.app`)
- **`DORC_TENANT_SLUG`**: required tenant slug
- **`DORC_API_KEY`**: optional (sent as `X-API-Key`)

### Usage

```python
import os
from dorc_client import DorcClient

os.environ["DORC_BASE_URL"] = "https://your-engine-url.run.app"
os.environ["DORC_TENANT_SLUG"] = "my-tenant"

with DorcClient() as c:
    if not c.health():
        raise SystemExit("engine not healthy")

    r = c.validate(content="# Example\n\nHello.", candidate_id="example-001")
    print(r.run_id, r.pipeline_status)
```


