Metadata-Version: 2.4
Name: respan-instrumentation-ragas
Version: 0.1.0
Summary: Respan instrumentation plugin for Ragas evaluations and experiments
License: Apache 2.0
Author: Respan
Author-email: team@respan.ai
Requires-Python: >=3.11,<3.14
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Dist: langchain-community (>=0.3.0,<0.4.0)
Requires-Dist: opentelemetry-api (>=1.38.0,<2.0.0)
Requires-Dist: opentelemetry-semantic-conventions-ai (>=0.4.1)
Requires-Dist: ragas (>=0.4.3,<0.5.0)
Requires-Dist: respan-sdk (>=2.6.1)
Requires-Dist: respan-tracing (>=2.17.0,<3.0.0)
Description-Content-Type: text/markdown

# Respan instrumentation for Ragas

This package traces Ragas 0.4 evaluation and experiment surfaces as canonical
Respan task spans. It covers `evaluate`, `aevaluate`, single-turn and multi-turn
metrics, experiment runs, and each experiment row. Sync and async failures keep
their original exception while OpenTelemetry records error status and exception
details.

```python
from respan_instrumentation_ragas import RagasInstrumentor

instrumentor = RagasInstrumentor(capture_content=True)
instrumentor.activate()
```

`capture_content=False` keeps operation names and lifecycle/error metadata but
omits evaluation inputs and outputs. Activation and deactivation are idempotent,
and patches are removed only after the final active instrumentor is deactivated.

