Function tests

lib/tests/include/basic_queue_t/behavior.cpp:44–119

<!-- description --> @brief Used to execute the actual checks. We put the checks in this function so that we can validate the tests both at compile-time and at run-time. If a bsl::ut_check fails, the tests will either fail fast at run-time, or will produce a compile-time error. <!-- inputs/outputs --> @return Always returns bsl::exit_success.

    ///   @return Always returns bsl::exit_success.
    ///
    [[nodiscard]] constexpr auto
    tests() noexcept -> bsl::exit_code
    {
        constexpr auto queue_size{3_umx};

        bsl::ut_scenario{"initial state"} = [&]() noexcept {
            bsl::ut_given{} = [&]() noexcept {
                lib::basic_queue_t<bool, queue_size.get()> mut_queue{};
                bsl::ut_when{} = [&]() noexcept {
                    bsl::ut_then{} = [&]() noexcept {
                        bsl::ut_check(mut_queue.empty());
                        bsl::ut_check(mut_queue.size() == queue_size);
                    };
                };
            };
        };

        bsl::ut_scenario{"push until full"} = [&]() noexcept {
            bsl::ut_given{} = [&]() noexcept {
                lib::basic_queue_t<bool, queue_size.get()> mut_queue{};
                bsl::ut_when{} = [&]() noexcept {
                    bsl::ut_required_step(mut_queue.push(true));
                    bsl::ut_required_step(mut_queue.push(true));
                    bsl::ut_then{} = [&]() noexcept {
                        bsl::ut_check(!mut_queue.push(true));
                        bsl::ut_check(!mut_queue.empty());
                    };
                };
            };
        };

        bsl::ut_scenario{"pop until empty"} = [&]() noexcept {
            bsl::ut_given{} = [&]() noexcept {
                lib::basic_queue_t<bool, queue_size.get()> mut_queue{};
                bool mut_val{};
                bsl::ut_when{} = [&]() noexcept {
                    bsl::ut_required_step(mut_queue.push(true));
                    bsl::ut_required_step(mut_queue.push(true));
                    bsl::ut_then{} = [&]() noexcept {
                        mut_val = {};
                        bsl::ut_check(mut_queue.pop(mut_val));
                        bsl::ut_check(!mut_queue.empty());
                        bsl::ut_check(mut_val);

                        mut_val = {};
                        bsl::ut_check(mut_queue.pop(mut_val));
                        bsl::ut_check(mut_queue.empty());
                        bsl::ut_check(mut_val);

                        mut_val = {};
                        bsl::ut_check(!mut_queue.pop(mut_val));
                        bsl::ut_check(mut_queue.empty());
                        bsl::ut_check(!mut_val);
                    };
                };
            };
        };