rlmesh-spaces 0.1.0-rc.1

Internal RLMesh crate (unstable Rust API): space specifications and value model.
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 thiserror::Error;

#[derive(Error, Debug)]
#[non_exhaustive]
pub enum SpaceError {
    #[error("{path}: {msg}")]
    Invalid { path: String, msg: String },
}

impl SpaceError {
    /// Build an [`SpaceError::Invalid`] at `path` with `msg`.
    pub(crate) fn invalid(path: impl Into<String>, msg: impl Into<String>) -> Self {
        SpaceError::Invalid {
            path: path.into(),
            msg: msg.into(),
        }
    }

    /// The value path this error is anchored at (advisory; used to dedup
    /// conformance warnings per path).
    #[must_use]
    pub fn path(&self) -> &str {
        match self {
            SpaceError::Invalid { path, .. } => path,
        }
    }
}

#[derive(Error, Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub enum EnvRuntimeError {
    #[error("invalid space: {0}")]
    InvalidSpace(String),
    #[error("invalid value: {0}")]
    InvalidValue(String),
    #[error("runtime error: {0}")]
    Runtime(String),
}

macro_rules! err_space {
    // err_space!(path, msg)
    ($path:expr, $msg:expr) => {
        Err(SpaceError::Invalid {
            path: $path.into(),
            msg: $msg.into(),
        })
    };

    // err_space!(path, name, msg)
    ($path:expr, $name:expr, $msg:expr) => {
        Err(SpaceError::Invalid {
            path: $path.into(),
            msg: format!("[{}] {}", $name, $msg),
        })
    };
}
pub(crate) use err_space;