eggress-pproxy-compat 1.0.2

pproxy-compatible CLI and URI translation layer for Eggress
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
53
54
55
56
57

use crate::diagnostics::DiagnosticCode;

/// Errors from pproxy compatibility translation.
///
/// Each variant maps to a stable [`DiagnosticCode`] via [`CompatError::code()`].
#[derive(Debug, thiserror::Error)]
pub enum CompatError {
    /// Maps to [`DiagnosticCode::UnsupportedProtocol`].
    #[error("unsupported protocol: {0}")]
    UnsupportedProtocol(String),

    /// Maps to a code determined by the feature name (see [`DiagnosticCode`] docs).
    #[error("unsupported feature: {feature}")]
    UnsupportedFeature {
        feature: &'static str,
        detail: String,
    },

    /// Maps to [`DiagnosticCode::InvalidUriSyntax`].
    #[error("invalid URI: {message}")]
    InvalidUri { message: String },

    /// Maps to [`DiagnosticCode::InvalidUriSyntax`].
    #[error("invalid pproxy arguments: {message}")]
    InvalidArgs { message: String },

    /// Maps to [`DiagnosticCode::InvalidChainComposition`].
    #[error("config validation failed: {message}")]
    ConfigValidation { message: String },

    /// Maps to [`DiagnosticCode::MissingTarget`].
    #[error("missing required argument: {0}")]
    MissingArgument(String),
}

impl CompatError {
    pub fn unsupported(feature: &'static str, detail: impl Into<String>) -> Self {
        Self::UnsupportedFeature {
            feature,
            detail: detail.into(),
        }
    }

    /// Return the stable [`DiagnosticCode`] that classifies this error.
    pub fn code(&self) -> DiagnosticCode {
        match self {
            Self::UnsupportedProtocol(_) => DiagnosticCode::UnsupportedProtocol,
            Self::UnsupportedFeature { feature, .. } => {
                crate::diagnostics::classify_unsupported_feature_code(feature)
            }
            Self::InvalidUri { .. } => DiagnosticCode::InvalidUriSyntax,
            Self::InvalidArgs { .. } => DiagnosticCode::InvalidUriSyntax,
            Self::ConfigValidation { .. } => DiagnosticCode::InvalidChainComposition,
            Self::MissingArgument(_) => DiagnosticCode::MissingTarget,
        }
    }
}