rdfx 0.24.0

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

use iri_rs::Iri;
use std::convert::TryFrom;

/// Iri index.
#[derive(Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord, Debug)]
pub struct IriIndex(usize);

impl From<usize> for IriIndex {
    fn from(i: usize) -> Self {
        Self(i)
    }
}

impl From<IriIndex> for usize {
    fn from(value: IriIndex) -> Self {
        value.0
    }
}

impl IndexedIri for IriIndex {
    fn index(&self) -> IriOrIndex<Iri<&str>> {
        IriOrIndex::Index(self.0)
    }
}

impl<'a> TryFrom<Iri<&'a str>> for IriIndex {
    type Error = ();

    fn try_from(_value: Iri<&'a str>) -> Result<Self, Self::Error> {
        Err(())
    }
}

#[cfg(feature = "contextual")]
impl<V: crate::vocabulary::IriVocabulary<Iri = Self>> contextual::DisplayWithContext<V> for IriIndex {
    fn fmt_with(&self, vocabulary: &V, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        std::fmt::Display::fmt(&vocabulary.iri(self).unwrap(), f)
    }
}

#[cfg(feature = "contextual")]
impl<V: crate::vocabulary::IriVocabulary<Iri = Self>> crate::RdfDisplayWithContext<V> for IriIndex {
    fn rdf_fmt_with(&self, vocabulary: &V, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        std::fmt::Display::fmt(&vocabulary.iri(self).unwrap(), f)
    }
}

/// Partly indexed IRI identifier type.
pub trait IndexedIri: From<usize> + for<'a> TryFrom<Iri<&'a str>> {
    fn index(&self) -> IriOrIndex<Iri<&str>>;
}

/// IRI or index.
///
/// This can be used as an IRI identifier that mixes IRIs that are statically
/// known (of type `I`) and IRIs added at run time with a dynamic index.
#[derive(Clone, Copy, PartialEq, Eq, Hash, PartialOrd, Ord, Debug)]
pub enum IriOrIndex<I> {
    /// Index of the IRI in the vocabulary.
    Index(usize),

    /// Non indexed IRI.
    Iri(I),
}

impl<I> From<usize> for IriOrIndex<I> {
    fn from(i: usize) -> Self {
        Self::Index(i)
    }
}

impl<'a, I: TryFrom<Iri<&'a str>>> TryFrom<Iri<&'a str>> for IriOrIndex<I> {
    type Error = I::Error;

    fn try_from(value: Iri<&'a str>) -> Result<Self, Self::Error> {
        Ok(Self::Iri(I::try_from(value)?))
    }
}