disposition_model_common 0.2.0

SVG diagram generator common data model types.
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

use std::borrow::Cow;

use serde::{Deserialize, Serialize};

/// Unique identifier for any entity in the diagram, `Cow<'s, str>`
/// newtype.
///
/// Must begin with a letter or underscore, and contain only letters, numbers,
/// and underscores.
///
/// # Examples
///
/// ```rust
/// use disposition_model_common::{id, Id};
///
/// let id_compile_time_checked = id!("example_id");
/// let id_runtime_checked = Id::new("example_id").unwrap();
///
/// assert_eq!(id_compile_time_checked, id_runtime_checked);
/// assert_eq!(id_runtime_checked.as_str(), "example_id");
/// ```
#[cfg_attr(
    all(feature = "schemars", not(feature = "test")),
    derive(schemars::JsonSchema)
)]
#[derive(Clone, Debug, Hash, PartialEq, Eq, Deserialize, Serialize)]
pub struct Id<'s>(Cow<'s, str>);

id_newtype::id_newtype!(Id, IdInvalidFmt, id, 's);

impl<'s> AsRef<Id<'s>> for Id<'s> {
    fn as_ref(&self) -> &Id<'s> {
        self
    }
}