rmv-bevy-testing-tools 0.10.2

Write simple tests for bevy systems, using rstest, insta, and speculoos.
Documentation 
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

#![cfg_attr(docsrs, feature(doc_cfg))]
#![cfg_attr(coverage_nightly, feature(coverage_attribute))]

// TODO: setup tags for different versions of bevy

#[allow(dead_code)]
mod deprecated {
    use konst::{iter, result, string};
    use static_assertions::const_assert_eq;
    const VERSION_STR: [&str; 1] = iter::collect_const!(&str =>
        string::split(env!("CARGO_PKG_VERSION"), "-"),take(1));
    const VERSION: [u32; 3] = iter::collect_const!(u32 =>
        string::split(VERSION_STR[0], "."),
        map(|s| result::unwrap!(u32::from_str_radix(s, 10))));
    const MAJOR: u32 = VERSION[0];
    const MINOR: u32 = VERSION[1];
    const PATCH: u32 = VERSION[2];
    const_assert_eq!(MAJOR, 0);
}

#[cfg(feature = "speculoos")]
pub(crate) mod assertions;
#[cfg(any(test, feature = "minimal"))]
pub(crate) mod fixtures;
#[cfg(any(all(test, feature = "rstest"), feature = "trait_collect_messages"))]
pub(crate) mod messages;
#[allow(unused_imports)] // Silence warning about name starting with `test_`
pub(crate) mod test_app;
pub(crate) mod traits;

#[cfg(feature = "insta")]
#[macro_export]
macro_rules! set_snapshot_suffix {
    ($($expr:expr),*) => {
        let mut settings = insta::Settings::clone_current();
        settings.set_snapshot_suffix(format!($($expr,)*));
        let _guard = settings.bind_to_scope();
    }
}

pub mod prelude {
    #[cfg(feature = "speculoos")]
    pub use super::assertions::*;
    #[cfg(any(test, feature = "rstest"))]
    pub use super::fixtures::*;
    #[cfg(feature = "trait_collect_messages")]
    pub use super::messages::*;
    #[cfg(feature = "insta")]
    pub use super::set_snapshot_suffix;
    pub use super::test_app::*;
    #[allow(unused_imports)]
    pub use super::traits::*;
}

#[doc = include_str!("../Readme.md")]
#[cfg(doctest)]
pub struct ReadmeDoctests;

#[cfg(test)]
#[cfg_attr(coverage_nightly, coverage(off))]
mod tests {
    #[allow(unused_imports)]
    use rstest::rstest;

    #[cfg(all(feature = "rstest", feature = "trait_collect_messages"))]
    #[rstest]
    #[async_std::test]
    async fn with_rstest_fixtures() {
        // if it compiles, it's fine
        if skip_feature_test_body() {
            return;
        }

        use bevy_app::AppExit;

        use crate::prelude::*;
        let mut app = default_test_app((), minimal_test_app(()));
        app.collect_messages::<AppExit>()
            .write_message_default::<AppExit>();
    }

    #[cfg(feature = "insta")]
    #[rstest]
    fn can_access_insta_macro() {
        // if it compiles, it's fine
        if skip_feature_test_body() {
            return;
        }

        set_snapshot_suffix!("works");
    }

    #[cfg(feature = "speculoos")]
    #[rstest]
    fn can_access_assertions() {
        // if it compiles, it's fine
        if skip_feature_test_body() {
            return;
        }

        use speculoos::assert_that;

        use crate::prelude::*;

        let items = vec![1, 2, 3];
        assert_that!(1).is_contained_in(&items);
    }

    #[allow(dead_code)]
    fn skip_feature_test_body() -> bool {
        // basically return true always but don't let the compiler know
        // so it checks code that we don't want to run anyway
        std::env::var("_SKIP_FEATURE_TESTS_")
            .map(|s| matches!(s.as_str(), "true" | "1"))
            .unwrap_or(true)
    }
}