garde-fr 0.18.1

Validation library
Documentation
#![doc = include_str!("../README.md")]

pub mod error;
pub mod rules;
pub mod validate;

pub use error::{Error, Path, Report};
#[cfg(feature = "derive")]
pub use garde_derive::{select, Validate};
pub use validate::{Unvalidated, Valid, Validate};

pub type Result = ::core::result::Result<(), Error>;

pub mod external {
    pub use {compact_str, smallvec};
}

#[doc(hidden)]
pub mod util {
    use crate::error::PathComponentKind;
    use crate::Path;

    #[inline]
    pub fn __make_nested_path<'a, C: PathComponentKind + Clone + 'a>(
        mut parent: impl FnMut() -> Path + 'a,
        component: C,
    ) -> impl FnMut() -> Path + 'a {
        let mut nested = None::<Path>;

        #[inline]
        move || MaybeJoin::maybe_join(&mut nested, &mut parent, || component.clone())
    }

    #[doc(hidden)]
    #[macro_export]
    macro_rules! __nested_path {
        ($parent:ident, $key:expr) => {
            $crate::util::__make_nested_path(&mut $parent, &$key)
        };
    }

    pub use crate::__nested_path as nested_path;

    pub trait MaybeJoin {
        fn maybe_join<C, P, CF>(&mut self, parent: P, component: CF) -> Path
        where
            C: PathComponentKind,
            P: FnMut() -> Path,
            CF: Fn() -> C;
    }

    impl MaybeJoin for Option<Path> {
        #[inline]
        fn maybe_join<C, P, CF>(&mut self, mut parent: P, component: CF) -> Path
        where
            C: PathComponentKind,
            P: FnMut() -> Path,
            CF: Fn() -> C,
        {
            match self {
                Some(path) => path.clone(),
                None => {
                    let path = parent().join(component());
                    *self = Some(path.clone());
                    path
                }
            }
        }
    }
}