json-ld 0.22.0

JSON-LD implementation
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

use crate::{AsyncJsonLdLoader, JsonLdLoader, JsonLdWarning, ToAsyncJsonLdLoader};

mod compaction;
mod context_processing;
mod deserialization;
mod expansion;
mod flattening;
mod serialization;

pub use compaction::*;
pub use context_processing::*;
pub use deserialization::RdfSerializationOptions;
pub use expansion::*;

pub trait AsyncJsonLdEnvironment {
	type Loader: AsyncJsonLdLoader;

	fn loader(&self) -> &Self::Loader;

	fn warn(&self, w: JsonLdWarning);

	fn as_ref(&self) -> AsyncProcessingEnvironmentRef<'_, Self> {
		AsyncProcessingEnvironmentRef(self)
	}
}

impl<L: AsyncJsonLdLoader> AsyncJsonLdEnvironment for L {
	type Loader = Self;

	fn loader(&self) -> &Self::Loader {
		self
	}

	fn warn(&self, _: JsonLdWarning) {
		// Ignore.
	}
}

pub struct AsyncProcessingEnvironmentRef<'a, T: ?Sized>(pub &'a T);

impl<'a, T: ?Sized + AsyncJsonLdEnvironment> AsyncJsonLdEnvironment
	for AsyncProcessingEnvironmentRef<'a, T>
{
	type Loader = T::Loader;

	fn loader(&self) -> &Self::Loader {
		self.0.loader()
	}

	fn warn(&self, w: JsonLdWarning) {
		self.0.warn(w);
	}
}

pub trait JsonLdEnvironment {
	type Loader: JsonLdLoader;

	fn loader(&self) -> &Self::Loader;

	fn warn(&self, w: JsonLdWarning);

	fn as_async_environment(&self) -> &ToAsyncJsonLdEnvironment<Self> {
		ToAsyncJsonLdEnvironment::from_ref(self)
	}

	fn into_async_environment(self) -> ToAsyncJsonLdEnvironment<Self>
	where
		Self: Sized,
	{
		ToAsyncJsonLdEnvironment(self)
	}
}

impl<L: JsonLdLoader> JsonLdEnvironment for L {
	type Loader = Self;

	fn loader(&self) -> &Self::Loader {
		self
	}

	fn warn(&self, _: JsonLdWarning) {
		// Ignore.
	}
}

#[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)]
#[repr(transparent)]
pub struct ToAsyncJsonLdEnvironment<T: ?Sized>(pub T);

impl<T: ?Sized> ToAsyncJsonLdEnvironment<T> {
	pub fn from_ref(env: &T) -> &Self {
		unsafe {
			// SAFETY: `ToAsyncJsonLdEnvironment` uses the `transparent` repr.
			std::mem::transmute(env)
		}
	}
}

impl<T: JsonLdEnvironment> AsyncJsonLdEnvironment for ToAsyncJsonLdEnvironment<T> {
	type Loader = ToAsyncJsonLdLoader<T::Loader>;

	fn loader(&self) -> &Self::Loader {
		self.0.loader().as_async_loader()
	}

	fn warn(&self, w: JsonLdWarning) {
		self.0.warn(w);
	}
}