json_ld/syntax/context/definition/
version.rs

1use std::{hash::Hash, str::FromStr};
2
3use json_syntax::{JsonNumber, JsonNumberBuf};
4
5#[derive(Debug, thiserror::Error)]
6#[error("unknown JSON-LD version `{0}`")]
7pub struct UnknownJsonLdVersion(pub String);
8
9/// Version number.
10///
11/// The only allowed value is a number with the value `1.1`.
12#[derive(Clone, Copy, PartialOrd, Ord, Debug)]
13pub enum JsonLdVersion {
14	V1_1,
15}
16
17impl JsonLdVersion {
18	pub fn into_bytes(self) -> &'static [u8] {
19		match self {
20			Self::V1_1 => b"1.1",
21		}
22	}
23
24	pub fn into_str(self) -> &'static str {
25		match self {
26			Self::V1_1 => "1.1",
27		}
28	}
29
30	pub fn into_json_number(self) -> &'static JsonNumber {
31		unsafe { JsonNumber::new_unchecked(self.into_bytes()) }
32	}
33
34	pub fn into_json_number_buf(self) -> JsonNumberBuf {
35		unsafe { JsonNumberBuf::new_unchecked(self.into_bytes().into()) }
36	}
37}
38
39impl PartialEq for JsonLdVersion {
40	fn eq(&self, _other: &Self) -> bool {
41		true
42	}
43}
44
45impl Eq for JsonLdVersion {}
46
47impl Hash for JsonLdVersion {
48	fn hash<H: std::hash::Hasher>(&self, state: &mut H) {
49		self.into_str().hash(state)
50	}
51}
52
53impl From<JsonLdVersion> for &JsonNumber {
54	fn from(v: JsonLdVersion) -> Self {
55		v.into_json_number()
56	}
57}
58
59impl From<JsonLdVersion> for JsonNumberBuf {
60	fn from(v: JsonLdVersion) -> Self {
61		v.into_json_number_buf()
62	}
63}
64
65impl TryFrom<JsonNumberBuf> for JsonLdVersion {
66	type Error = UnknownJsonLdVersion;
67
68	fn try_from(value: JsonNumberBuf) -> Result<Self, Self::Error> {
69		if value.trimmed().as_str() == "1.1" {
70			Ok(Self::V1_1)
71		} else {
72			Err(UnknownJsonLdVersion(value.to_string()))
73		}
74	}
75}
76
77impl FromStr for JsonLdVersion {
78	type Err = UnknownJsonLdVersion;
79
80	fn from_str(s: &str) -> Result<Self, Self::Err> {
81		if s == "1.1" {
82			Ok(JsonLdVersion::V1_1)
83		} else {
84			Err(UnknownJsonLdVersion(s.to_owned()))
85		}
86	}
87}
88
89impl TryFrom<f32> for JsonLdVersion {
90	type Error = UnknownJsonLdVersion;
91
92	fn try_from(value: f32) -> Result<Self, Self::Error> {
93		if value == 1.1 {
94			Ok(JsonLdVersion::V1_1)
95		} else {
96			Err(UnknownJsonLdVersion(value.to_string()))
97		}
98	}
99}
100
101impl TryFrom<f64> for JsonLdVersion {
102	type Error = UnknownJsonLdVersion;
103
104	fn try_from(value: f64) -> Result<Self, Self::Error> {
105		if value == 1.1 {
106			Ok(JsonLdVersion::V1_1)
107		} else {
108			Err(UnknownJsonLdVersion(value.to_string()))
109		}
110	}
111}
112
113#[cfg(feature = "serde")]
114impl serde::Serialize for JsonLdVersion {
115	fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
116	where
117		S: serde::Serializer,
118	{
119		self.into_json_number().serialize(serializer)
120	}
121}
122
123#[cfg(feature = "serde")]
124impl<'de> serde::Deserialize<'de> for JsonLdVersion {
125	fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
126	where
127		D: serde::Deserializer<'de>,
128	{
129		JsonNumberBuf::deserialize(deserializer)?
130			.try_into()
131			.map_err(serde::de::Error::custom)
132	}
133}
json_ld/syntax/context/definition/version.rs

json_ld/syntax/context/definition/
version.rs
