use std::cmp::Ordering; use std::hash::{Hash, Hasher}; // Currently serde itself doesn't have a spanned type, so we map our `Spanned` // to a special value in the serde data model. Namely one with these special // fields/struct names. // // In general, supported deserializers should catch this and not literally emit // these strings but rather emit `Spanned` as they're intended. #[doc(hidden)] #[cfg(feature = "serde")] pub const NAME: &str = "$__serde_spanned_private_Spanned"; #[doc(hidden)] #[cfg(feature = "serde")] pub const START_FIELD: &str = "$__serde_spanned_private_start"; #[doc(hidden)] #[cfg(feature = "serde")] pub const END_FIELD: &str = "$__serde_spanned_private_end"; #[doc(hidden)] #[cfg(feature = "serde")] pub const VALUE_FIELD: &str = "$__serde_spanned_private_value"; #[doc(hidden)] #[cfg(feature = "serde")] pub fn is_spanned(name: &'static str, fields: &'static [&'static str]) -> bool { name == NAME && fields == [START_FIELD, END_FIELD, VALUE_FIELD] } /// A spanned value, indicating the range at which it is defined in the source. #[derive(Clone, Debug)] pub struct Spanned { /// Byte range span: std::ops::Range, /// The spanned value. value: T, } impl Spanned { /// Create a spanned value encompassing the given byte range. /// /// # Example /// /// Transposing a `Spanned>` into `Enum>`: /// /// ``` /// use serde::de::{Deserialize, Deserializer}; /// use serde_untagged::UntaggedEnumVisitor; /// use toml::Spanned; /// /// pub enum Dependency { /// Simple(Spanned), /// Detailed(Spanned), /// } /// /// impl<'de> Deserialize<'de> for Dependency { /// fn deserialize(deserializer: D) -> Result /// where /// D: Deserializer<'de>, /// { /// enum DependencyKind { /// Simple(String), /// Detailed(DetailedDependency), /// } /// /// impl<'de> Deserialize<'de> for DependencyKind { /// fn deserialize(deserializer: D) -> Result /// where /// D: Deserializer<'de>, /// { /// UntaggedEnumVisitor::new() /// .expecting( /// "a version string like \"0.9.8\" or a \ /// detailed dependency like { version = \"0.9.8\" }", /// ) /// .string(|value| Ok(DependencyKind::Simple(value.to_owned()))) /// .map(|value| value.deserialize().map(DependencyKind::Detailed)) /// .deserialize(deserializer) /// } /// } /// /// let spanned: Spanned = Deserialize::deserialize(deserializer)?; /// let range = spanned.span(); /// Ok(match spanned.into_inner() { /// DependencyKind::Simple(simple) => Dependency::Simple(Spanned::new(range, simple)), /// DependencyKind::Detailed(detailed) => Dependency::Detailed(Spanned::new(range, detailed)), /// }) /// } /// } /// # /// # type DetailedDependency = std::collections::BTreeMap; /// ``` pub fn new(range: std::ops::Range, value: T) -> Self { Spanned { span: range, value } } /// Byte range pub fn span(&self) -> std::ops::Range { self.span.clone() } /// Consumes the spanned value and returns the contained value. pub fn into_inner(self) -> T { self.value } /// Returns a reference to the contained value. pub fn get_ref(&self) -> &T { &self.value } /// Returns a mutable reference to the contained value. pub fn get_mut(&mut self) -> &mut T { &mut self.value } } impl std::borrow::Borrow for Spanned { fn borrow(&self) -> &str { self.get_ref() } } impl AsRef for Spanned { fn as_ref(&self) -> &T { self.get_ref() } } impl AsMut for Spanned { fn as_mut(&mut self) -> &mut T { self.get_mut() } } impl PartialEq for Spanned { fn eq(&self, other: &Self) -> bool { self.value.eq(&other.value) } } impl Eq for Spanned {} impl Hash for Spanned { fn hash(&self, state: &mut H) { self.value.hash(state); } } impl PartialOrd for Spanned { fn partial_cmp(&self, other: &Self) -> Option { self.value.partial_cmp(&other.value) } } impl Ord for Spanned { fn cmp(&self, other: &Self) -> Ordering { self.value.cmp(&other.value) } } #[cfg(feature = "serde")] impl<'de, T> serde::de::Deserialize<'de> for Spanned where T: serde::de::Deserialize<'de>, { fn deserialize(deserializer: D) -> Result, D::Error> where D: serde::de::Deserializer<'de>, { struct SpannedVisitor(::std::marker::PhantomData); impl<'de, T> serde::de::Visitor<'de> for SpannedVisitor where T: serde::de::Deserialize<'de>, { type Value = Spanned; fn expecting(&self, formatter: &mut std::fmt::Formatter<'_>) -> std::fmt::Result { formatter.write_str("a spanned value") } fn visit_map(self, mut visitor: V) -> Result, V::Error> where V: serde::de::MapAccess<'de>, { if visitor.next_key()? != Some(START_FIELD) { return Err(serde::de::Error::custom("spanned start key not found")); } let start: usize = visitor.next_value()?; if visitor.next_key()? != Some(END_FIELD) { return Err(serde::de::Error::custom("spanned end key not found")); } let end: usize = visitor.next_value()?; if visitor.next_key()? != Some(VALUE_FIELD) { return Err(serde::de::Error::custom("spanned value key not found")); } let value: T = visitor.next_value()?; Ok(Spanned { span: start..end, value, }) } } let visitor = SpannedVisitor(::std::marker::PhantomData); static FIELDS: [&str; 3] = [START_FIELD, END_FIELD, VALUE_FIELD]; deserializer.deserialize_struct(NAME, &FIELDS, visitor) } } #[cfg(feature = "serde")] impl serde::ser::Serialize for Spanned { fn serialize(&self, serializer: S) -> Result where S: serde::ser::Serializer, { self.value.serialize(serializer) } }