Metadata-Version: 2.4
Name: panoptes-sdk
Version: 0.1.0
Summary: Panoptes SDK — structured logs with OpenTelemetry correlation
Author-email: Pixel Wave <dev@pixel-wave.com>
License: MIT
Requires-Python: >=3.12
Requires-Dist: httpx>=0.27
Provides-Extra: all
Requires-Dist: panoptes[fastapi,otel]; extra == 'all'
Provides-Extra: fastapi
Requires-Dist: starlette>=0.37; extra == 'fastapi'
Provides-Extra: otel
Requires-Dist: opentelemetry-exporter-otlp-proto-http>=1.24; extra == 'otel'
Requires-Dist: opentelemetry-sdk>=1.24; extra == 'otel'
Description-Content-Type: text/markdown

# panoptes-sdk

Python SDK for sending structured logs and traces to [Panoptes](https://panoptes.io).

## Installation

```bash
pip install panoptes-sdk
```

## Usage

```python
from panoptes import Panoptes, Logger

panoptes = Panoptes(
    api_key="your-api-key",
    endpoint="https://collector.panoptes.io",
    asset="service/my-service",
)

logger = Logger(panoptes)
logger.info("Order created", order_id=123, user_id=456)
```

## FastAPI integration

```python
from panoptes.integrations.fastapi import PanoptesMiddleware

app.add_middleware(PanoptesMiddleware, panoptes=panoptes)
```

## OpenTelemetry

```python
# Use existing OTel setup automatically, or start one pointing to Panoptes:
panoptes.start_otel(service_name="my-service")
```
