Struct SpanValidator 

pub struct SpanValidator { /* private fields */ }

Span validator for OTEL self-testing

Implementations

impl SpanValidator

pub fn from_span_data(spans: &[SpanData]) -> Result<Self>

Create SpanValidator from OpenTelemetry SpanData

Converts OpenTelemetry SDK span data to validator span format for runtime validation against test expectations.

Arguments

• spans - OpenTelemetry SpanData from telemetry collection

Returns

• Result<Self> - SpanValidator instance or error

pub fn from_file<P: AsRef<Path>>(path: P) -> Result<Self>

Create a new SpanValidator by loading spans from a JSON file

The file should be in the format produced by OTEL collector’s file exporter.

Arguments

• path - Path to the spans JSON file

Returns

• Result<Self> - SpanValidator instance or error

Errors

• File read errors
• JSON parsing errors

pub fn from_json(json: &str) -> Result<Self>

Create a new SpanValidator from JSON string

Arguments

• json - JSON string containing span data

Returns

• Result<Self> - SpanValidator instance or error

Errors

• JSON parsing errors

pub fn spans(&self) -> &[SpanData]

Get all spans

pub fn find_spans_by_name(&self, name: &str) -> Vec<&SpanData>

Find spans by name

pub fn find_span(&self, trace_id: &str, span_id: &str) -> Option<&SpanData>

Find span by exact trace ID and span ID

pub fn has_span(&self, name: &str) -> bool

Check if a span with the given name exists

pub fn count_spans(&self, name: &str) -> usize

Count spans with given name

pub fn validate_expectations( &self, expectations: &[SpanExpectationConfig], ) -> Result<ValidationResult>

Validate spans against PRD-style expectations with detailed error tracking

This is the primary validation method that processes SpanExpectationConfig from TOML and returns structured validation results.

Arguments

• expectations - List of span expectations from TOML [[expect.span]] blocks

Returns

• Result<ValidationResult> - Detailed validation results with failure tracking

pub fn first_failure(result: &ValidationResult) -> Option<&FailureDetails>

Get the first failure from validation results (for error reporting)

pub fn validate_assertion(&self, assertion: &SpanAssertion) -> Result<()>

Validate a single assertion

pub fn validate_assertions(&self, assertions: &[SpanAssertion]) -> Result<()>

Validate multiple assertions

pub fn get_span(&self, name: &str) -> Option<&SpanData>

Get a span by name (returns first match)

pub fn get_span_by_id(&self, span_id: &str) -> Option<&SpanData>

Get a span by span_id

pub fn all_spans(&self) -> &[SpanData]

Get all spans (for iteration)