Enum Observed 

pub enum Observed<T> {
    Available {
        value: T,
        kind: ObservationKind,
        source: String,
    },
    Unsupported {
        reason: String,
    },
    Unavailable {
        reason: String,
    },
}

A value which remains explicit when the runtime cannot produce it.

Variants

Available

A usable value with documented provenance.

Fields

value: T

Observed value.

kind: ObservationKind

Confidence and measurement semantics.

source: String

Stable human-readable provenance.

Unsupported

The platform or artifact cannot provide this measurement.

Fields

reason: String

Reason the measurement is unsupported.

Unavailable

The measurement is meaningful but was not available.

Fields

reason: String

Reason the value could not be obtained.

Implementations

impl<T> Observed<T>

pub fn exact(value: T, source: impl Into<String>) -> Self

Creates an exact observation.

pub fn unavailable(reason: impl Into<String>) -> Self

Creates an unavailable observation without inventing a default value.

pub fn unsupported(reason: impl Into<String>) -> Self

Creates an unsupported observation without inventing a default value.

pub const fn value(&self) -> Option<&T>

Borrows the available value, returning None when no value was reported.

Trait Implementations

impl<T: Clone> Clone for Observed<T>

fn clone(&self) -> Observed<T>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<T: Debug> Debug for Observed<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for Observed<T>

where T: Deserialize<'de>,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T: Eq> Eq for Observed<T>

impl<T: PartialEq> PartialEq for Observed<T>

fn eq(&self, other: &Observed<T>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T> Serialize for Observed<T>

where T: Serialize,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<T: PartialEq> StructuralPartialEq for Observed<T>