rdfx 0.23.1

RDF 1.2 data-structures, traits and utilities: terms (incl. triple terms), triples, quads, interpretations, graphs, datasets, unstar/restar reification helpers.
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

use crate::{Literal, LiteralRef, RdfDisplay};
use iri_rs::{Iri, IriBuf};
use std::{borrow::Cow, fmt, hash::Hash};

mod r#ref;
pub use r#ref::*;

mod cow;
pub use cow::*;

mod local;
pub use local::*;

mod maybe_blank;
pub use maybe_blank::*;

mod maybe_iri;
pub use maybe_iri::*;

mod maybe_literal;
pub use maybe_literal::*;

pub mod generator;
pub use generator::{Generator, LocalGenerator};

/// Lexical representation of an RDF resource.
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[cfg_attr(feature = "serde", serde(untagged))]
pub enum Term {
    /// IRI.
    Iri(IriBuf),

    /// Literal value.
    Literal(Literal),
}

impl Term {
    pub const fn is_iri(&self) -> bool {
        matches!(self, Self::Iri(_))
    }

    pub const fn is_literal(&self) -> bool {
        matches!(self, Self::Literal(_))
    }

    pub fn as_literal(&self) -> Option<LiteralRef<'_>> {
        match self {
            Self::Literal(lit) => Some(lit.as_ref()),
            _ => None,
        }
    }

    pub fn into_literal(self) -> Option<Literal> {
        match self {
            Self::Literal(lit) => Some(lit),
            _ => None,
        }
    }

    pub fn try_into_literal(self) -> Result<Literal, IriBuf> {
        match self {
            Self::Literal(lit) => Ok(lit),
            Self::Iri(id) => Err(id),
        }
    }

    pub fn as_iri(&self) -> Option<Iri<&str>> {
        match self {
            Self::Iri(id) => Some(id.as_ref()),
            _ => None,
        }
    }

    pub fn try_into_iri(self) -> Result<IriBuf, Self> {
        match self {
            Self::Iri(iri) => Ok(iri),
            other => Err(other),
        }
    }

    pub fn into_iri(self) -> Option<IriBuf> {
        self.try_into_iri().ok()
    }

    pub fn as_ref(&self) -> TermRef<'_> {
        match self {
            Self::Iri(id) => TermRef::Iri(id.as_ref()),
            Self::Literal(l) => TermRef::Literal(l.as_ref()),
        }
    }

    pub fn as_cow(&self) -> CowTerm<'_> {
        match self {
            Self::Iri(id) => CowTerm::Iri(Cow::Borrowed(id)),
            Self::Literal(l) => CowTerm::Literal(l.as_cow()),
        }
    }

    pub fn into_cow(self) -> CowTerm<'static> {
        match self {
            Self::Iri(id) => CowTerm::Iri(Cow::Owned(id)),
            Self::Literal(l) => CowTerm::Literal(l.into_cow()),
        }
    }
}

impl From<IriBuf> for Term {
    fn from(value: IriBuf) -> Self {
        Self::Iri(value)
    }
}

impl From<Literal> for Term {
    fn from(value: Literal) -> Self {
        Self::Literal(value)
    }
}

impl Hash for Term {
    fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
        match self {
            Self::Iri(id) => {
                state.write_u8(0);
                id.hash(state);
            }
            Self::Literal(l) => {
                state.write_u8(1);
                l.hash(state);
            }
        }
    }
}

impl fmt::Display for Term {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match self {
            Self::Iri(id) => id.fmt(f),
            Self::Literal(lit) => lit.fmt(f),
        }
    }
}

impl RdfDisplay for Term {
    fn rdf_fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match self {
            Self::Iri(id) => id.rdf_fmt(f),
            Self::Literal(lit) => lit.rdf_fmt(f),
        }
    }
}