linked-data 0.2.0

Linked-Data dateset serialization/deserialization traits
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

use rdf_syntax::{
	GenInterpretation, IndexedBTreeDataset, Quad, Term, TryInterpretationMut,
	TryReverseInterpretation, generator::BlankIdGenerator,
};

use crate::{
	DeserializeLinkedData,
	de::{
		DatasetDeserializer, DatasetDeserializerError, DeserializeLinkedDataWith,
		ResourcesDeserializer,
	},
};

pub type QuadsDeserializationFailed = DatasetDeserializerError;

/// Deserializes an instance of `T` from the given quads.
pub fn from_rdf_quads<T>(
	quads: impl IntoIterator<Item = Quad<Term>>,
	resources: impl IntoIterator<Item = Term>,
) -> Result<T, QuadsDeserializationFailed>
where
	T: DeserializeLinkedData,
{
	from_rdf_quads_interpretation(
		quads,
		resources,
		GenInterpretation::new(BlankIdGenerator::new()),
	)
}

/// Deserializes an instance of `T` from the given quads and state.
pub fn from_rdf_quads_with<Q, T>(
	quads: impl IntoIterator<Item = Quad<Term>>,
	resources: impl IntoIterator<Item = Term>,
	state: Q,
) -> Result<T, QuadsDeserializationFailed>
where
	T: DeserializeLinkedDataWith<Q>,
{
	from_rdf_quads_interpretation_with(
		quads,
		resources,
		GenInterpretation::new(BlankIdGenerator::new()),
		state,
	)
}

/// Deserializes an instance of `T` from the given quads, using a custom RDF
/// [interpretation](rdf_syntax::TryInterpretationMut).
pub fn from_rdf_quads_interpretation<I, T>(
	quads: impl IntoIterator<Item = Quad<I::Resource>>,
	resources: impl IntoIterator<Item = I::Resource>,
	interpretation: I,
) -> Result<T, QuadsDeserializationFailed>
where
	I: TryInterpretationMut + TryReverseInterpretation,
	I::Resource: Clone + Ord,
	T: DeserializeLinkedData<I::Resource>,
{
	let dataset: IndexedBTreeDataset<I::Resource> = quads.into_iter().collect();
	T::deserialize_rdf(
		ResourcesDeserializer::new(DatasetDeserializer::new(dataset, interpretation), resources),
		None,
	)
}

/// Deserializes an instance of `T` from the given quads, state, and using a
/// custom RDF [interpretation](rdf_syntax::TryInterpretationMut).
pub fn from_rdf_quads_interpretation_with<Q, I, T>(
	quads: impl IntoIterator<Item = Quad<I::Resource>>,
	resources: impl IntoIterator<Item = I::Resource>,
	interpretation: I,
	state: Q,
) -> Result<T, QuadsDeserializationFailed>
where
	I: TryInterpretationMut + TryReverseInterpretation,
	I::Resource: Clone + Ord,
	T: DeserializeLinkedDataWith<Q, I::Resource>,
{
	let dataset: IndexedBTreeDataset<I::Resource> = quads.into_iter().collect();
	T::deserialize_rdf_with(
		state,
		ResourcesDeserializer::new(DatasetDeserializer::new(dataset, interpretation), resources),
		None,
	)
}