Metadata-Version: 2.4
Name: qolaig-audit
Version: 0.1.0
Summary: Qolaig immudb audit SDK — emit + capture stdout/logging
Author: Qolaig
License: MIT
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"

# qolaig-audit (Python)

SDK pour le journal d’audit Qolaig (immudb) :

- `emit()` — événements métier structurés (`POST /entries`)
- `capture_stdout()` — aspire `print` / stdout / stderr
- `capture_logging()` — aspire `logger.info` / `warning` / `error`

## Install

```bash
pip install -e /path/to/packages-qolaig/qolaig-audit-python
```

## Usage

```python
import logging
import os
from qolaig_audit import Audit

audit = Audit(
    base_url="https://audits-logs.qolaig.app",
    token=os.environ["QOLAIG_AUDIT_TOKEN"],
)
audit.capture_stdout()
audit.capture_logging()

logging.info("app started")
print("hello from stdout")

audit.emit("order.created", {"id": 42}, metadata={"source": "api"})
audit.flush()
```

Le token vient de la page **Journal d’audit** du tracking Qolaig (après « Activer le journal »).

## Notes

- Envoi en batch vers `POST /ingest/logs` (stdout / logging).
- `emit` est synchrone vers `POST /entries`.
- Ne capture que le process Python où le SDK est chargé (pas les autres containers).
