coil-observability 0.1.1

Observability primitives for the Coil framework.
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
40
41
42
43
44
45
46
47
48
49
50
51
52

use crate::ObservabilityError;
use std::fmt;

macro_rules! token_type {
    ($name:ident, $field:literal) => {
        #[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
        pub struct $name(String);

        impl $name {
            pub fn new(value: impl Into<String>) -> Result<Self, ObservabilityError> {
                Ok(Self(validate_token($field, value.into())?))
            }

            pub fn as_str(&self) -> &str {
                &self.0
            }
        }

        impl fmt::Display for $name {
            fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
                f.write_str(&self.0)
            }
        }
    };
}

token_type!(MetricName, "metric_name");
token_type!(DimensionKey, "dimension_key");
token_type!(FeatureFlagId, "feature_flag_id");
token_type!(CustomerAppId, "customer_app_id");
token_type!(SiteId, "site_id");
token_type!(BrandId, "brand_id");
token_type!(CohortId, "cohort_id");

pub fn validate_token(field: &'static str, value: String) -> Result<String, ObservabilityError> {
    let trimmed = value.trim();
    if trimmed.is_empty() {
        return Err(ObservabilityError::EmptyField { field });
    }

    if trimmed
        .chars()
        .all(|ch| ch.is_ascii_alphanumeric() || matches!(ch, '-' | '_' | '.' | ':'))
    {
        Ok(trimmed.to_string())
    } else {
        Err(ObservabilityError::InvalidToken {
            field,
            value: trimmed.to_string(),
        })
    }
}