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 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137
//! Fragment string. use std::convert::TryFrom; #[cfg(feature = "serde")] use serde::Serialize; use validated_slice::{OwnedSliceSpec, SliceSpec}; use crate::{ types::IriCreationError, validate::iri::{fragment, Error}, }; /// A borrowed slice of an IRI. /// /// This corresponds to `ifragment` rule in [RFC 3987]. /// This is `*( ipchar / "/" / "?" )`. /// /// [RFC 3987]: https://tools.ietf.org/html/rfc3987 #[derive(Debug, PartialEq, Eq, PartialOrd, Ord, Hash)] #[repr(transparent)] #[allow(clippy::derive_hash_xor_eq)] #[cfg_attr(feature = "serde", derive(Serialize))] #[cfg_attr(feature = "serde", serde(transparent))] pub struct IriFragmentStr(str); impl IriFragmentStr { /// Creates a new `&IriFragmentStr`. /// /// # Examples /// /// ``` /// # use iri_string::types::IriFragmentStr; /// assert!(IriFragmentStr::new("").is_ok()); /// assert!(IriFragmentStr::new("foo").is_ok()); /// assert!(IriFragmentStr::new("foo/bar").is_ok()); /// assert!(IriFragmentStr::new("/foo/bar").is_ok()); /// assert!(IriFragmentStr::new("//foo/bar").is_ok()); /// assert!(IriFragmentStr::new("https://user:pass@example.com:8080").is_ok()); /// assert!(IriFragmentStr::new("https://example.com/").is_ok()); /// /// // `<` and `>` cannot directly appear in an IRI. /// assert!(IriFragmentStr::new("<not allowed>").is_err()); /// ``` pub fn new(s: &str) -> Result<&Self, Error> { TryFrom::try_from(s) } /// Creates a new `&IriFragmentStr` from the fragment part prefixed by `#`. /// /// # Examples /// /// ``` /// # use iri_string::types::IriFragmentStr; /// assert!(IriFragmentStr::from_prefixed("#").is_ok()); /// assert!(IriFragmentStr::from_prefixed("#foo").is_ok()); /// assert!(IriFragmentStr::from_prefixed("#foo/bar").is_ok()); /// assert!(IriFragmentStr::from_prefixed("#/foo/bar").is_ok()); /// assert!(IriFragmentStr::from_prefixed("#//foo/bar").is_ok()); /// assert!(IriFragmentStr::from_prefixed("#https://user:pass@example.com:8080").is_ok()); /// assert!(IriFragmentStr::from_prefixed("#https://example.com/").is_ok()); /// /// // `<` and `>` cannot directly appear in an IRI. /// assert!(IriFragmentStr::from_prefixed("#<not allowed>").is_err()); /// // `#` prefix is expected. /// assert!(IriFragmentStr::from_prefixed("").is_err()); /// assert!(IriFragmentStr::from_prefixed("foo").is_err()); /// ``` pub fn from_prefixed(s: &str) -> Result<&Self, Error> { if s.as_bytes().get(0) != Some(&b'#') { return Err(Error::new()); } TryFrom::try_from(&s[1..]) } /// Creates a new `IriFragmentStr` maybe without validation. /// /// This does validation on debug build. pub(crate) unsafe fn new_unchecked(s: &str) -> &Self { debug_assert_eq!(StrSpec::validate(s), Ok(())); StrSpec::from_inner_unchecked(s) } /// Returns `&str`. pub fn as_str(&self) -> &str { self.as_ref() } } /// An owned string of an IRI fragment. /// /// This corresponds to `ifragment` rule in [RFC 3987]. /// This is `*( ipchar / "/" / "?" )`. /// /// See documentation for [`IriFragmentStr`]. /// /// [RFC 3987]: https://tools.ietf.org/html/rfc3987 /// [`IriFragmentStr`]: struct.IriFragmentStr.html #[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)] #[cfg_attr(feature = "serde", derive(Serialize))] #[cfg_attr(feature = "serde", serde(transparent))] pub struct IriFragmentString(String); impl IriFragmentString { /// Creates a new `IriFragmentString` maybe without validation. /// /// This does validation on debug build. pub(crate) unsafe fn new_unchecked(s: String) -> Self { debug_assert_eq!(StrSpec::validate(&s), Ok(())); StringSpec::from_inner_unchecked(s) } /// Shrinks the capacity of the inner buffer to match its length. pub fn shrink_to_fit(&mut self) { self.0.shrink_to_fit() } } impl_basics! { Slice { spec: StrSpec, custom: IriFragmentStr, validator: fragment, error: Error, }, Owned { spec: StringSpec, custom: IriFragmentString, error: IriCreationError<String>, }, } impl_serde! { expecting: "an IRI fragment", slice: IriFragmentStr, owned: IriFragmentString, }