Metadata-Version: 2.4
Name: finanfut-watchtower-sdk
Version: 0.1.0
Summary: Python SDK for FinanFut Watchtower.
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.8
Provides-Extra: fastapi
Requires-Dist: fastapi>=0.115; extra == "fastapi"
Provides-Extra: dev
Requires-Dist: pytest>=8.3; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"

# FinanFut Watchtower SDK

Python SDK for sending application errors to FinanFut Watchtower.

Install the published package with FastAPI support:

```bash
pip install "finanfut-watchtower-sdk[fastapi]==0.1.0"
```

Until `0.1.0` is published, use the temporary Git dependency:

```text
finanfut-watchtower-sdk[fastapi] @ git+https://github.com/erovirafinanfut/FinanFut_WatchTower.git@main#subdirectory=packages/finanfut-watchtower-sdk
```

```python
import finanfut_watchtower as watchtower

watchtower.configure_from_env(
    service="billing-api",
    environment="development",
)

try:
    raise RuntimeError("boom")
except RuntimeError as exc:
    watchtower.capture_exception(exc, event="example_failed")
```

Recommended environment:

```bash
WATCHTOWER_SDK_ENDPOINT=http://localhost:8000
WATCHTOWER_SDK_PROJECT_KEY=pk_dev_watchtower
WATCHTOWER_SDK_SECRET_KEY=sk_dev_watchtower_change_me
WATCHTOWER_SDK_SERVICE=finanfut-billing-api
WATCHTOWER_SDK_ENVIRONMENT=development
```

Integrations:

- `finanfut_watchtower.integrations.fastapi.WatchtowerMiddleware`
- `finanfut_watchtower.integrations.logging.WatchtowerLoggingHandler`
- `finanfut_watchtower.monitor_job`
