arch_pkg_text/desc/field/
parse.rs

1use super::{Field, RawField};
2use derive_more::{Display, Error};
3use pipe_trait::Pipe;
4
5/// Error when attempt to parse a [`Field`] with [`TryFrom`].
6#[derive(Debug, Display, Clone, Copy, Error)]
7pub enum ParseFieldError<ParseNameError> {
8    RawField(ParseRawFieldError),
9    Name(ParseNameError),
10}
11
12impl<Name> Field<Name> {
13    /// Parse a [`Field`] from [`str`].
14    /// ```
15    /// # use arch_pkg_text::desc::{FieldName, ParsedField};
16    /// # use pretty_assertions::assert_eq;
17    /// let parsed_field = ParsedField::parse("%NAME%").unwrap();
18    /// assert_eq!(parsed_field.name(), &FieldName::Name);
19    /// ```
20    pub fn parse<'a>(value: &'a str) -> Result<Self, <Self as TryFrom<&'a str>>::Error>
21    where
22        &'a str: TryInto<Name>,
23    {
24        Self::try_from(value)
25    }
26}
27
28/// Parse a [`Field`] from [`str`].
29impl<'a, Name> TryFrom<&'a str> for Field<Name>
30where
31    &'a str: TryInto<Name>,
32{
33    type Error = ParseFieldError<<&'a str as TryInto<Name>>::Error>;
34    fn try_from(value: &'a str) -> Result<Self, Self::Error> {
35        value
36            .pipe(RawField::parse_raw)
37            .map_err(ParseFieldError::RawField)?
38            .into_name()
39            .pipe(TryInto::<Name>::try_into)
40            .map_err(ParseFieldError::Name)
41            .map(Field)
42    }
43}
44
45/// Error when attempt to parse a [`RawField`] with [`RawField::parse_raw`].
46#[derive(Debug, Display, Clone, Copy, Error)]
47pub enum ParseRawFieldError {
48    #[display("Input doesn't start with '%'")]
49    IncorrectStartingCharacter,
50    #[display("Input doesn't end with '%'")]
51    IncorrectEndingCharacter,
52    #[display("Field name is empty")]
53    Empty,
54    #[display("Found invalid character {_1:?} at index {_0} which isn't ASCII uppercase")]
55    NotAsciiUppercase(usize, char),
56}
57
58impl<'a> RawField<'a> {
59    /// Parse a [`RawField`] from a [`str`].
60    ///
61    /// ```
62    /// # use arch_pkg_text::desc::RawField;
63    /// # use pretty_assertions::assert_eq;
64    /// let raw_field = RawField::parse_raw("%NAME%").unwrap();
65    /// assert_eq!(raw_field.name_str(), "NAME");
66    /// ```
67    pub fn parse_raw(input: &'a str) -> Result<Self, ParseRawFieldError> {
68        let field_name = input
69            .strip_prefix('%')
70            .ok_or(ParseRawFieldError::IncorrectStartingCharacter)?
71            .strip_suffix('%')
72            .ok_or(ParseRawFieldError::IncorrectEndingCharacter)?;
73
74        if field_name.is_empty() {
75            return Err(ParseRawFieldError::Empty);
76        }
77
78        if let Some((index, char)) = field_name
79            .char_indices()
80            .find(|(_, x)| !x.is_ascii_uppercase())
81        {
82            return Err(ParseRawFieldError::NotAsciiUppercase(index, char));
83        }
84
85        Ok(Field(field_name))
86    }
87
88    /// Try converting a [`RawField`] into a [`Field<Name>`].
89    ///
90    /// ```
91    /// # use arch_pkg_text::desc::{FieldName, ParsedField, RawField};
92    /// # use pretty_assertions::assert_eq;
93    /// let raw_field = RawField::parse_raw("%NAME%").unwrap();
94    /// let parsed_field: ParsedField = raw_field.to_parsed().unwrap();
95    /// assert_eq!(parsed_field.name(), &FieldName::Name);
96    /// ```
97    pub fn to_parsed<Name>(&self) -> Result<Field<Name>, <&'a str as TryInto<Name>>::Error>
98    where
99        &'a str: TryInto<Name>,
100    {
101        self.name_str().pipe(TryInto::<Name>::try_into).map(Field)
102    }
103}