Metadata-Version: 2.4
Name: asiri-sdk
Version: 0.1.0
Summary: Asiri API Python SDK
Author: ASIRI Compliance Ltd.
License-Expression: LicenseRef-Proprietary
Project-URL: Homepage, https://asiri.ng
Project-URL: Documentation, https://docs.asiri.ng
Keywords: asiri,privacy,compliance,api,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# asiri-sdk

Official Python SDK for the Asiri API.

## Install

```bash
pip install asiri-sdk
```

## Quickstart

```python
from asiri import AsiriClient, AsiriError

asiri = AsiriClient(
    api_key="sk_live_...",
)

try:
    overview = asiri.get("/v1/reports/overview")
except AsiriError as exc:
    print(exc.code, exc.status, exc.request_id)
else:
    print(overview)
```

## Mutating requests

Pass an idempotency key on `POST`, `PUT`, `PATCH`, and `DELETE` requests so retries are safe:

```python
asiri.post(
    "/v1/reports/build",
    json_body={"type": "audit_summary", "format": "json"},
    idempotency_key="retry-safe-key",
)
```

`AsiriClient` defaults to `https://api.asiri.ng`, sends `Accept: application/json`, and
adds `User-Agent: asiri-sdk/<version>` unless you override those headers.

## Development

```bash
PYTHONPATH=packages/sdk-python/src python3 -m unittest discover packages/sdk-python/tests
python3 -m pip wheel packages/sdk-python --no-deps --wheel-dir /tmp/asiri-sdk-wheel
```
