nominal 0.5.0

Automate Nominal workflows in Rust
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use crate::core::datetime::NominalDateTimeError;
use crate::core::rid::RidConversionError;
use thiserror::Error;

pub type Result<T> = std::result::Result<T, Error>;

#[non_exhaustive]
#[derive(Debug, Error)]
pub enum Error {
    #[error("I/O error: {0}")]
    Io(#[from] std::io::Error),

    #[error("could not determine home directory")]
    HomeDirNotFound,

    #[error("YAML parse error: {0}")]
    Yaml(#[from] serde_yaml::Error),

    #[error("Conjure error: {details}")]
    Conjure {
        details: String,
        status: Option<u16>,
    },

    #[error("Workspace not provided, but there is no default workspace for the user.")]
    NoDefaultWorkspace,

    #[error("RID conversion error: invalid RID '{rid}': {reason}")]
    Rid { rid: String, reason: String },

    #[error("seconds_since_epoch out of range: {0}")]
    TimestampSecondsOutOfRange(i64),

    #[error("offset_nanoseconds out of range: {0}")]
    TimestampNanosOutOfRange(i64),

    #[error("invalid timestamp: seconds={seconds}, nanos={nanos}")]
    InvalidTimestamp { seconds: i64, nanos: i64 },

    #[error("invalid bearer token: {reason}")]
    InvalidBearerToken { reason: String },

    #[error("invalid service URL '{url}': {reason}")]
    InvalidServiceUrl { url: String, reason: String },

    #[error("profile '{name}' not found in config")]
    ProfileNotFound { name: String },

    #[error(
        "no config file found at {path}: create with `nomctl config profile add` or `nomctl config init`"
    )]
    ConfigNotFound { path: String },

    #[error("missing 'version' key in config file: {path}")]
    ConfigMissingVersion { path: String },

    #[error("unsupported config version: {version} (expected 2)")]
    ConfigUnsupportedVersion { version: u32, path: String },

    #[error("environment variable '{name}' is not set")]
    EnvVarNotSet { name: &'static str },

    #[error("resource not found: {resource}")]
    NotFound { resource: &'static str },

    #[error("channel data type missing from server response for channel '{channel}'")]
    MissingChannelDataType { channel: String },

    #[error("unsupported channel data type for metadata upsert: {data_type}")]
    UnsupportedChannelDataType { data_type: String },

    #[error("multipart upload failed: {details}")]
    Upload { details: String },

    #[error("ingest error: {details}")]
    Ingest { details: String },
}

impl From<RidConversionError> for Error {
    fn from(value: RidConversionError) -> Self {
        Self::Rid {
            rid: value.rid().to_string(),
            reason: value.reason().to_string(),
        }
    }
}

impl From<NominalDateTimeError> for Error {
    fn from(value: NominalDateTimeError) -> Self {
        match value {
            NominalDateTimeError::SecondsOutOfRange(v) => Self::TimestampSecondsOutOfRange(v),
            NominalDateTimeError::NanosOutOfRange(v) => Self::TimestampNanosOutOfRange(v),
            NominalDateTimeError::InvalidTimestamp { seconds, nanos } => {
                Self::InvalidTimestamp { seconds, nanos }
            }
        }
    }
}

impl From<conjure_error::Error> for Error {
    fn from(value: conjure_error::Error) -> Self {
        let status = value
            .cause()
            .downcast_ref::<conjure_runtime::errors::RemoteError>()
            .map(|remote| remote.status().as_u16());
        Self::Conjure {
            details: format!("{value:?}"),
            status,
        }
    }
}

impl Error {
    pub fn http_status(&self) -> Option<u16> {
        match self {
            Self::Conjure { status, .. } => *status,
            _ => None,
        }
    }
}