wyrd-runtime 0.3.0

Wyrd runtime singleton and cross-cutting behavior shells.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

//! OpenTelemetry wiring shell.

use wyrd_spec::trace::TraceContext;

/// Runtime telemetry install configuration.
#[derive(Debug, Clone, Default, PartialEq, Eq)]
pub struct TelemetryConfig {
    /// Optional OTLP endpoint URL.
    pub endpoint: Option<String>,
}

/// Span context prepared for future server wiring.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct SpanSeed {
    /// Optional incoming trace context.
    pub trace_context: Option<TraceContext>,
    /// Span name.
    pub name: String,
}

/// Prepare a span seed without attaching an SDK.
#[must_use]
pub fn prepare_span(name: impl Into<String>, trace_context: Option<TraceContext>) -> SpanSeed {
    SpanSeed {
        trace_context,
        name: name.into(),
    }
}

/// Install the runtime telemetry shell.
///
/// No-op today. The signature reserves the server-boundary shape so concrete
/// SDK wiring can land without churning call sites.
pub fn install(_config: TelemetryConfig) {}

/// Attach an incoming trace context to the current runtime span.
///
/// No-op today; reserved for SDK integration.
pub fn attach(_context: &TraceContext) {}