//! Matrix room version identifiers. use std::{ borrow::Cow, convert::TryFrom, fmt::{self, Display, Formatter}, }; #[cfg(feature = "diesel")] use diesel::sql_types::Text; #[cfg(feature = "serde")] use serde::{Deserialize, Deserializer, Serialize, Serializer}; use crate::error::Error; /// Room version identifiers cannot be more than 32 code points. const MAX_CODE_POINTS: usize = 32; /// A Matrix room version ID. /// /// A `RoomVersionId` can be or converted or deserialized from a string slice, and can be converted /// or serialized back into a string as needed. /// /// ``` /// # use std::convert::TryFrom; /// # use ruma_identifiers::RoomVersionId; /// assert_eq!(RoomVersionId::try_from("1").unwrap().as_ref(), "1"); /// ``` #[derive(Clone, Debug, Eq, Hash, PartialEq)] #[cfg_attr(feature = "diesel", derive(FromSqlRow, QueryId, AsExpression, SqlType))] #[cfg_attr(feature = "diesel", sql_type = "Text")] pub struct RoomVersionId(InnerRoomVersionId); /// Possibile values for room version, distinguishing between official Matrix versions and custom /// versions. #[derive(Clone, Debug, PartialEq, Eq, PartialOrd, Ord, Hash)] enum InnerRoomVersionId { /// A version 1 room. Version1, /// A version 2 room. Version2, /// A version 3 room. Version3, /// A version 4 room. Version4, /// A version 5 room. Version5, /// A custom room version. Custom(Box), } impl RoomVersionId { /// Creates a version 1 room ID. pub fn version_1() -> Self { Self(InnerRoomVersionId::Version1) } /// Creates a version 2 room ID. pub fn version_2() -> Self { Self(InnerRoomVersionId::Version2) } /// Creates a version 3 room ID. pub fn version_3() -> Self { Self(InnerRoomVersionId::Version3) } /// Creates a version 4 room ID. pub fn version_4() -> Self { Self(InnerRoomVersionId::Version4) } /// Creates a version 5 room ID. pub fn version_5() -> Self { Self(InnerRoomVersionId::Version5) } /// Creates a custom room version ID from the given string slice. pub fn custom(id: String) -> Self { Self(InnerRoomVersionId::Custom(id.into())) } /// Whether or not this room version is an official one specified by the Matrix protocol. pub fn is_official(&self) -> bool { !self.is_custom() } /// Whether or not this is a custom room version. pub fn is_custom(&self) -> bool { match self.0 { InnerRoomVersionId::Custom(_) => true, _ => false, } } /// Whether or not this is a version 1 room. pub fn is_version_1(&self) -> bool { self.0 == InnerRoomVersionId::Version1 } /// Whether or not this is a version 2 room. pub fn is_version_2(&self) -> bool { self.0 == InnerRoomVersionId::Version2 } /// Whether or not this is a version 3 room. pub fn is_version_3(&self) -> bool { self.0 == InnerRoomVersionId::Version3 } /// Whether or not this is a version 4 room. pub fn is_version_4(&self) -> bool { self.0 == InnerRoomVersionId::Version4 } /// Whether or not this is a version 5 room. pub fn is_version_5(&self) -> bool { self.0 == InnerRoomVersionId::Version5 } } impl From for String { fn from(id: RoomVersionId) -> Self { match id.0 { InnerRoomVersionId::Version1 => "1".to_owned(), InnerRoomVersionId::Version2 => "2".to_owned(), InnerRoomVersionId::Version3 => "3".to_owned(), InnerRoomVersionId::Version4 => "4".to_owned(), InnerRoomVersionId::Version5 => "5".to_owned(), InnerRoomVersionId::Custom(version) => version.into(), } } } impl AsRef for RoomVersionId { fn as_ref(&self) -> &str { match &self.0 { InnerRoomVersionId::Version1 => "1", InnerRoomVersionId::Version2 => "2", InnerRoomVersionId::Version3 => "3", InnerRoomVersionId::Version4 => "4", InnerRoomVersionId::Version5 => "5", InnerRoomVersionId::Custom(version) => version, } } } impl Display for RoomVersionId { fn fmt(&self, f: &mut Formatter<'_>) -> fmt::Result { write!(f, "{}", self.as_ref()) } } #[cfg(feature = "serde")] impl Serialize for RoomVersionId { fn serialize(&self, serializer: S) -> Result where S: Serializer, { serializer.serialize_str(self.as_ref()) } } #[cfg(feature = "serde")] impl<'de> Deserialize<'de> for RoomVersionId { fn deserialize(deserializer: D) -> Result where D: Deserializer<'de>, { crate::deserialize_id(deserializer, "a Matrix room version ID as a string") } } impl TryFrom> for RoomVersionId { type Error = Error; /// Attempts to create a new Matrix room version ID from a string representation. fn try_from(room_version_id: Cow<'_, str>) -> Result { let version = match &room_version_id as &str { "1" => Self(InnerRoomVersionId::Version1), "2" => Self(InnerRoomVersionId::Version2), "3" => Self(InnerRoomVersionId::Version3), "4" => Self(InnerRoomVersionId::Version4), "5" => Self(InnerRoomVersionId::Version5), custom => { if custom.is_empty() { return Err(Error::MinimumLengthNotSatisfied); } else if custom.chars().count() > MAX_CODE_POINTS { return Err(Error::MaximumLengthExceeded); } else { Self(InnerRoomVersionId::Custom( room_version_id.into_owned().into(), )) } } }; Ok(version) } } impl TryFrom<&str> for RoomVersionId { type Error = crate::error::Error; fn try_from(s: &str) -> Result { Self::try_from(Cow::Borrowed(s)) } } impl TryFrom for RoomVersionId { type Error = crate::error::Error; fn try_from(s: String) -> Result { Self::try_from(Cow::Owned(s)) } } impl PartialEq<&str> for RoomVersionId { fn eq(&self, other: &&str) -> bool { self.as_ref() == *other } } impl PartialEq for &str { fn eq(&self, other: &RoomVersionId) -> bool { *self == other.as_ref() } } impl PartialEq for RoomVersionId { fn eq(&self, other: &String) -> bool { self.as_ref() == other } } impl PartialEq for String { fn eq(&self, other: &RoomVersionId) -> bool { self == other.as_ref() } } #[cfg(test)] mod tests { use std::convert::TryFrom; #[cfg(feature = "serde")] use serde_json::{from_str, to_string}; use super::RoomVersionId; use crate::error::Error; #[test] fn valid_version_1_room_version_id() { assert_eq!( RoomVersionId::try_from("1") .expect("Failed to create RoomVersionId.") .as_ref(), "1" ); } #[test] fn valid_version_2_room_version_id() { assert_eq!( RoomVersionId::try_from("2") .expect("Failed to create RoomVersionId.") .as_ref(), "2" ); } #[test] fn valid_version_3_room_version_id() { assert_eq!( RoomVersionId::try_from("3") .expect("Failed to create RoomVersionId.") .as_ref(), "3" ); } #[test] fn valid_version_4_room_version_id() { assert_eq!( RoomVersionId::try_from("4") .expect("Failed to create RoomVersionId.") .as_ref(), "4" ); } #[test] fn valid_version_5_room_version_id() { assert_eq!( RoomVersionId::try_from("5") .expect("Failed to create RoomVersionId.") .as_ref(), "5" ); } #[test] fn valid_custom_room_version_id() { assert_eq!( RoomVersionId::try_from("io.ruma.1") .expect("Failed to create RoomVersionId.") .as_ref(), "io.ruma.1" ); } #[test] fn empty_room_version_id() { assert_eq!( RoomVersionId::try_from(""), Err(Error::MinimumLengthNotSatisfied) ); } #[test] fn over_max_code_point_room_version_id() { assert_eq!( RoomVersionId::try_from("0123456789012345678901234567890123456789"), Err(Error::MaximumLengthExceeded) ); } #[cfg(feature = "serde")] #[test] fn serialize_official_room_id() { assert_eq!( to_string(&RoomVersionId::try_from("1").expect("Failed to create RoomVersionId.")) .expect("Failed to convert RoomVersionId to JSON."), r#""1""# ); } #[cfg(feature = "serde")] #[test] fn deserialize_official_room_id() { let deserialized = from_str::(r#""1""#).expect("Failed to convert RoomVersionId to JSON."); assert!(deserialized.is_version_1()); assert!(deserialized.is_official()); assert_eq!( deserialized, RoomVersionId::try_from("1").expect("Failed to create RoomVersionId.") ); } #[cfg(feature = "serde")] #[test] fn serialize_custom_room_id() { assert_eq!( to_string( &RoomVersionId::try_from("io.ruma.1").expect("Failed to create RoomVersionId.") ) .expect("Failed to convert RoomVersionId to JSON."), r#""io.ruma.1""# ); } #[cfg(feature = "serde")] #[test] fn deserialize_custom_room_id() { let deserialized = from_str::(r#""io.ruma.1""#) .expect("Failed to convert RoomVersionId to JSON."); assert!(deserialized.is_custom()); assert_eq!( deserialized, RoomVersionId::try_from("io.ruma.1").expect("Failed to create RoomVersionId.") ); } #[test] fn constructors() { assert!(RoomVersionId::version_1().is_version_1()); assert!(RoomVersionId::version_2().is_version_2()); assert!(RoomVersionId::version_3().is_version_3()); assert!(RoomVersionId::version_4().is_version_4()); assert!(RoomVersionId::version_5().is_version_5()); assert!(RoomVersionId::custom("foo".into()).is_custom()); } #[test] #[allow(clippy::cognitive_complexity)] fn predicate_methods() { let version_1 = RoomVersionId::try_from("1").expect("Failed to create RoomVersionId."); let version_2 = RoomVersionId::try_from("2").expect("Failed to create RoomVersionId."); let version_3 = RoomVersionId::try_from("3").expect("Failed to create RoomVersionId."); let version_4 = RoomVersionId::try_from("4").expect("Failed to create RoomVersionId."); let version_5 = RoomVersionId::try_from("5").expect("Failed to create RoomVersionId."); let custom = RoomVersionId::try_from("io.ruma.1").expect("Failed to create RoomVersionId."); assert!(version_1.is_version_1()); assert!(version_2.is_version_2()); assert!(version_3.is_version_3()); assert!(version_4.is_version_4()); assert!(version_5.is_version_5()); assert!(!version_1.is_version_2()); assert!(!version_1.is_version_3()); assert!(!version_1.is_version_4()); assert!(!version_1.is_version_5()); assert!(version_1.is_official()); assert!(version_2.is_official()); assert!(version_3.is_official()); assert!(version_4.is_official()); assert!(version_5.is_official()); assert!(!version_1.is_custom()); assert!(!version_2.is_custom()); assert!(!version_3.is_custom()); assert!(!version_4.is_custom()); assert!(!version_5.is_custom()); assert!(custom.is_custom()); assert!(!custom.is_official()); assert!(!custom.is_version_1()); assert!(!custom.is_version_2()); assert!(!custom.is_version_3()); assert!(!custom.is_version_4()); assert!(!custom.is_version_5()); } }