galvanic-assert 0.8.7

A comprehensive set of matcher-based assertions and expectations for easier testing. Supports checking properties of numbers, objects, enum variants, collections, panics, and more. Stuctural matching enables you to integrate matchers into struct decompositions for less code repetition. It's easy to write your own matchers for assertions too. This crate will be part of the galvanic test framework (in development). You can also use the assertions in another test framework of your choice. Works on: stable, beta, and nightly
Documentation
/* Copyright 2017 Christopher Bacher
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#[macro_use]
extern crate galvanic_assert;

use galvanic_assert::matchers::*;

mod get_expectation_for {
    use super::*;

    mod use_expression {
        use super::*;

        #[test]
        fn should_get_an_expectation_asserting_an_expression_to_be_true() {
            #[allow(unused_variables)]
            let e = get_expectation_for!(1 == 1);
        }

        #[test]
        fn should_get_an_expectation_asserting_an_expression_to_be_true_and_verify_manually() {
            let e = get_expectation_for!(1 == 1);
            e.verify()
        }

        #[test]
        fn should_get_multiple_expectations_asserting_an_expression_to_be_true() {
            #[allow(unused_variables)]
            let e1 = get_expectation_for!(1 == 1);
            #[allow(unused_variables)]
            let e2 = get_expectation_for!(1 == 1, otherwise "failed");
        }

        #[test]
        #[should_panic]
        fn should_get_an_expectation_failing_to_assert_an_expression_to_be_true() {
            #[allow(unused_variables)]
            let e = get_expectation_for!(1 != 1);
        }

        #[test]
        #[should_panic]
        fn should_get_an_expectation_failing_to_assert_an_expression_to_be_true_and_verify_manually() {
            let e = get_expectation_for!(1 != 1);
            e.verify()
        }

        #[test]
        fn should_get_multiple_expectations_failing_to_assert_an_expression_to_be_true() {
            let e1 = get_expectation_for!(1 != 1);
            let e2 = get_expectation_for!(1 != 1, otherwise "failed");
            assert_that!(e1.verify(), panics);
            assert_that!(e2.verify(), panics);
        }

        #[test]
        fn should_get_multiple_expectations_some_failing_to_assert_an_expression_to_be_true() {
            let e1 = get_expectation_for!(1 != 1);
            let e2 = get_expectation_for!(1 == 1);
            assert_that!(e1.verify(), panics);
            assert_that!(e2.verify(), does not panic);
        }
    }

    mod use_panic {
        use super::*;

        #[test]
        fn should_get_an_expectation_asserting_an_expression_to_panic() {
            #[allow(unused_variables)]
            let e = get_expectation_for!(panic!("panic"), panics);
        }

        #[test]
        #[should_panic]
        fn should_get_an_expectation_failing_to_assert_an_expression_to_panic() {
            #[allow(unused_variables)]
            let e = get_expectation_for!(1 == 1, panics);
        }
    }

    mod use_no_panic {
        use super::*;

        #[test]
        fn should_get_an_expectation_asserting_an_expression_to_not_panic() {
            #[allow(unused_variables)]
            let e = get_expectation_for!(1 == 1, does not panic);
        }

        #[test]
        #[should_panic]
        fn should_get_an_expectation_failing_to_assert_an_expression_to_panic() {
            #[allow(unused_variables)]
            let e = get_expectation_for!(panic!("panic"), does not panic);
        }
    }

    mod use_matcher {
        use super::*;

        #[test]
        fn should_get_an_expectation_asserting_a_matcher_to_succeed() {
            #[allow(unused_variables)]
            let e = get_expectation_for!(&1, assertion_always_succeeds());
        }

        #[test]
        #[should_panic]
        fn should_get_an_expectation_asserting_a_matcher_to_fail() {
            #[allow(unused_variables)]
            let e = get_expectation_for!(&1, assertion_always_fails());
        }
    }
}

mod expect_that {
    use super::*;

    mod use_expression {
        #[test]
        fn should_expect_an_expression_to_be_true() {
            expect_that!(1 == 1);
        }

        #[test]
        fn should_get_multiple_expectations_asserting_an_expression_to_be_true() {
            expect_that!(1 == 1);
            expect_that!(1 == 1, otherwise "failed");
        }

        #[test]
        #[should_panic]
        fn should_be_failing_to_expect_an_expression_to_be_true() {
            #[allow(unused_variables)]
            expect_that!(1 != 1);
        }

        #[test]
        #[should_panic]
        fn should_get_multiple_expectations_failing_to_assert_an_expression_to_be_true() {
            expect_that!(1 != 1);
            expect_that!(1 != 1, otherwise "failed");
        }

        #[test]
        #[should_panic]
        fn should_get_multiple_expectations_some_failing_to_assert_an_expression_to_be_true() {
            expect_that!(1 != 1);
            expect_that!(1 == 1);
        }
    }

    mod use_panic {
        use super::*;

        #[test]
        fn should_expect_an_expression_to_panic() {
            expect_that!(panic!("panic"), panics);
        }

        #[test]
        #[should_panic]
        fn should_be_failing_to_expect_an_expression_to_panic() {
            expect_that!(1 == 1, panics);
        }
    }

    mod use_no_panic {
        use super::*;

        #[test]
        fn should_expect_an_expression_to_not_panic() {
            expect_that!(1 == 1, does not panic);
        }

        #[test]
        #[should_panic]
        fn should_be_failing_to_expect_an_expression_to_panic() {
            expect_that!(panic!("panic"), does not panic);
        }
    }

    mod use_matcher {
        use super::*;

        #[test]
        fn should_expect_a_matcher_to_succeed() {
            expect_that!(&1, assertion_always_succeeds());
        }

        #[test]
        #[should_panic]
        fn should_expect_a_matcher_to_fail() {
            expect_that!(&1, assertion_always_fails());
        }
    }
}