Method parser

alpm-types/src/name.rs:153–185

Recognizes a [`Name`] in a string slice. Consumes all of its input. # Errors Returns an error if `input` contains an invalid _alpm-package-name_.

(input: &mut &str)

    }
}

impl Name {
    /// Recognizes a [`Name`] as part of an [`InstalledPackage`](`crate::InstalledPackage`).
    ///
    /// # Warning
    ///
    /// This parser is designed **specifically** for the internal
    /// [`InstalledPackage`](`crate::InstalledPackage`) parser.
    ///
    /// [`InstalledPackage`](`crate::InstalledPackage`) is a very special use-case, as it uses
    /// dashes (`-`) as delimiter. However, dashes are also valid characters in a [`Name`].
    /// As such, the [`Name`] parser must be aware of how many dashes are expected to be inside the
    /// input string to parse.
    ///
    /// This is a necessary, albeit cursed hack due to
    /// [`InstalledPackage`](`crate::InstalledPackage`)'s dash-based delimiter design.
    ///
    /// In contrast to [`Name::parser`], this function expects the final character to be a `-`,
    /// which it **does not consume**.
    ///
    /// # Errors
    ///
    /// Returns an error if `input` does not begin with a valid [alpm-package-name].
    ///
    /// [alpm-package-name]: https://alpm.archlinux.page/specifications/alpm-package-name.7.html
    pub(crate) fn parse_name_followed_by_version<'a>(
        delimiter_count: usize,
    ) -> impl Parser<&'a str, Self, ErrMode<ContextError>> {
        let never_first_char_list = ['_', '@', '+', '.'];

        let alphanum = |c: char| c.is_ascii_alphanumeric();
        let first_char = one_of((alphanum, Self::SPECIAL_FIRST_CHARS))
            .context(StrContext::Label("first character of package name"))
            .context(StrContext::Expected(StrContextValue::Description(
                "ASCII alphanumeric character",
            )))