snafu 0.8.9

An ergonomic error handling library
Documentation
use snafu::prelude::*;

mod basics {
    use super::*;
    use std::sync::atomic::{AtomicUsize, Ordering};

    static COUNTER: AtomicUsize = AtomicUsize::new(0);

    #[derive(Debug)]
    struct OccurrenceCount(usize);

    impl snafu::GenerateImplicitData for OccurrenceCount {
        fn generate() -> Self {
            OccurrenceCount(COUNTER.fetch_add(1, Ordering::SeqCst))
        }
    }

    #[derive(Debug, Snafu)]
    enum ErrorOne {
        Alpha {
            #[snafu(implicit)]
            occurrence: OccurrenceCount,
        },
    }

    #[test]
    fn implicit_fields_are_constructed() {
        let ErrorOne::Alpha {
            occurrence: OccurrenceCount(o1),
        } = AlphaSnafu.build();
        let ErrorOne::Alpha {
            occurrence: OccurrenceCount(o2),
        } = AlphaSnafu.build();

        assert_eq!(o1, 0);
        assert_eq!(o2, 1);
    }
}

mod multiple_fields {
    use super::*;

    #[derive(Debug, PartialEq)]
    struct ImplicitData;

    impl snafu::GenerateImplicitData for ImplicitData {
        fn generate() -> Self {
            ImplicitData
        }
    }

    #[derive(Debug, Snafu)]
    struct Error {
        #[snafu(implicit)]
        one: ImplicitData,
        #[snafu(implicit)]
        two: ImplicitData,
    }

    #[test]
    fn multiple_implicit_fields_are_constructed() {
        let Error { one, two } = Snafu.build();

        assert_eq!(one, two);
    }
}

mod with_and_without_source {
    use snafu::{prelude::*, FromString, IntoError};

    #[derive(Debug, PartialEq)]
    enum ItWas {
        Generate,
        GenerateWithSource,
    }

    #[derive(Debug)]
    struct ImplicitData(ItWas);

    impl snafu::GenerateImplicitData for ImplicitData {
        fn generate() -> Self {
            Self(ItWas::Generate)
        }

        fn generate_with_source(_: &dyn snafu::Error) -> Self {
            Self(ItWas::GenerateWithSource)
        }
    }

    #[derive(Debug, Snafu)]
    struct InnerError;

    #[derive(Debug, Snafu)]
    struct HasSource {
        source: InnerError,
        #[snafu(implicit)]
        data: ImplicitData,
    }

    #[derive(Debug, Snafu)]
    struct NoSource {
        #[snafu(implicit)]
        data: ImplicitData,
    }

    #[derive(Debug, Snafu)]
    #[snafu(context(false))]
    struct HasSourceNoContext {
        source: InnerError,
        #[snafu(implicit)]
        data: ImplicitData,
    }

    #[derive(Debug, Snafu)]
    #[snafu(whatever, display("{message}"))]
    struct MyOwnWhatever {
        message: String,
        #[snafu(source(from(Box<dyn std::error::Error>, Some)))]
        source: Option<Box<dyn std::error::Error>>,
        #[snafu(implicit)]
        data: ImplicitData,
    }

    #[test]
    fn calls_generate_for_no_source() {
        let e = NoSourceSnafu.build();
        assert_eq!(e.data.0, ItWas::Generate);
    }

    #[test]
    fn calls_generate_with_source_for_source() {
        let e = HasSourceSnafu.into_error(InnerError);
        assert_eq!(e.data.0, ItWas::GenerateWithSource);
    }

    #[test]
    fn calls_generate_for_none() {
        let e = NoSourceSnafu.into_error(snafu::NoneError);
        assert_eq!(e.data.0, ItWas::Generate);
    }

    #[test]
    fn calls_generate_with_source_for_no_context() {
        let e = HasSourceNoContext::from(InnerError);
        assert_eq!(e.data.0, ItWas::GenerateWithSource);
    }

    #[test]
    fn calls_generate_for_whatever_with_no_source() {
        let e = MyOwnWhatever::without_source("bang".into());
        assert_eq!(e.data.0, ItWas::Generate);
    }

    #[test]
    fn calls_generate_with_source_for_whatever_with_source() {
        let e = MyOwnWhatever::with_source(Box::new(InnerError), "bang".into());
        assert_eq!(e.data.0, ItWas::GenerateWithSource);
    }
}

mod converted_sources {
    use snafu::{prelude::*, IntoError};

    #[derive(Debug)]
    struct ImplicitData;

    impl snafu::GenerateImplicitData for ImplicitData {
        fn generate() -> Self {
            Self
        }
    }

    #[derive(Debug, Snafu)]
    struct HasSource {
        backtrace: snafu::Backtrace,

        #[snafu(implicit)]
        data: ImplicitData,

        #[snafu(source(from(String, Into::into)))]
        source: Box<dyn std::error::Error>,
    }

    #[test]
    fn receives_the_error_after_conversion() {
        let e = HasSourceSnafu.into_error(String::from("bad"));
        // Mostly testing that this compiles; assertion is bonus
        assert_eq!(e.source.to_string(), "bad");
    }
}

mod boxed {
    use snafu::prelude::*;
    use std::{rc::Rc, sync::Arc};

    #[derive(Debug, PartialEq)]
    struct ImplicitData;

    impl snafu::GenerateImplicitData for ImplicitData {
        fn generate() -> Self {
            ImplicitData
        }
    }

    #[derive(Debug, Snafu)]
    struct BoxImplicit {
        #[snafu(implicit)]
        data: Box<ImplicitData>,
    }

    #[test]
    fn box_is_implicit() {
        let e = BoxImplicitSnafu.build();
        assert_eq!(e.data, Box::new(ImplicitData))
    }

    #[derive(Debug, Snafu)]
    struct RcImplicit {
        #[snafu(implicit)]
        data: Rc<ImplicitData>,
    }

    #[test]
    fn rc_is_implicit() {
        let e = RcImplicitSnafu.build();
        assert_eq!(e.data, Rc::new(ImplicitData))
    }

    #[derive(Debug, Snafu)]
    struct ArcImplicit {
        #[snafu(implicit)]
        data: Arc<ImplicitData>,
    }

    #[test]
    fn arc_is_implicit() {
        let e = ArcImplicitSnafu.build();
        assert_eq!(e.data, Arc::new(ImplicitData))
    }
}