Metadata-Version: 2.4
Name: 3tears-observe
Version: 0.14.0
Summary: Structured logging, tracing, and OpenTelemetry setup for 3tears applications
Project-URL: Repository, https://github.com/pacepace/3tears
Author: pace
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System :: Logging
Classifier: Topic :: System :: Monitoring
Classifier: Typing :: Typed
Requires-Python: >=3.14
Provides-Extra: asgi
Requires-Dist: uuid-utils; extra == 'asgi'
Provides-Extra: otel
Requires-Dist: opentelemetry-api>=1.28; extra == 'otel'
Requires-Dist: opentelemetry-exporter-otlp>=1.28; extra == 'otel'
Requires-Dist: opentelemetry-sdk>=1.28; extra == 'otel'
Description-Content-Type: text/markdown

# 3tears-observe

Structured logging, tracing, and OpenTelemetry setup for 3tears applications.

## Modules

- `threetears.observe.logging` -- Structured logging with context correlation and automatic call-site capture.
- `threetears.observe.tracing` -- `@traced` decorator (zero-cost without OpenTelemetry).
- `threetears.observe.setup` -- OpenTelemetry SDK bootstrap (TracerProvider, LoggerProvider, OTLP exporters).

## Installation

```bash
pip install 3tears-observe

# With OpenTelemetry SDK support:
pip install 3tears-observe[otel]
```
