iri_s 0.2.9

RDF data shapes implementation 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

mod iri_or_string;
mod iris;
#[cfg(not(target_family = "wasm"))]
mod test;
mod visitor;
#[cfg(target_family = "wasm")]
mod wasm_stubs;

pub use iri_or_string::Iri;
pub use iris::IriS;

/// Generates an [`IriS`] from a string literal.
/// ```
///
/// #[macro_use]
/// # use iri_s::{IriS, iri};
///
/// let iri = iri!("https://example.org/");
///
/// assert_eq!(iri.as_str(), "https://example.org/");
/// ```
///
/// At this moment the implementation leverages on [`oxrdf::NamedNode`](https://docs.rs/oxrdf/latest/oxrdf/struct.NamedNode.html)
///
/// Example
///
/// ```
/// # use iri_s::IriS;
/// # use std::str::FromStr;
///
/// let iri = IriS::from_str("https://example.org/").unwrap();
///
/// assert_eq!(iri.as_str(), "https://example.org/")
/// ```
///
#[macro_export]
macro_rules! iri {
    ($lit: tt) => {
        $crate::IriS::new_unchecked($lit)
    };
}

/// This macro creates a static variable that is initialized once andm can be accessed globally.
// TODO - This should be in a general utilities crate or even removed since is not used currently
#[macro_export]
macro_rules! static_once {
    ($name:ident, $type:ty, $init:expr) => {
        pub fn $name() -> &'static $type {
            static ONCE: std::sync::OnceLock<$type> = std::sync::OnceLock::new();
            ONCE.get_or_init(|| $init)
        }
    };
}

/// This macro creates a static [`IriS`] variable that is initialized once and can be accessed globally.
#[macro_export]
macro_rules! iri_once {
    ($name:ident, $str:expr) => {
        pub fn $name() -> &'static IriS {
            static ONCE: std::sync::OnceLock<IriS> = std::sync::OnceLock::new();
            ONCE.get_or_init(|| IriS::new_unchecked($str))
        }
    };
}