2
0
mirror of https://github.com/boostorg/gil.git synced 2026-02-20 02:42:11 +00:00
Files
gil/test/channel/channel_test_fixture.cpp
Mateusz Loskot 73ec99e606 Refactor single-program channel test to Boost.Test suites and cases
Motivation:
- state clearly what is covered with tests without reading non-trivial code
- avoid cleverness - tests should be no-brainer
- get closer to one test case targets one feature/beaviour with one check
- replace obscure `throw std::exception` with diagnostics that are actually
  useful to pin-point failure cause and location - makes CI logs useful.
- allow to select and run specific tests
- make tests maintenance easy, quick and fun

Propose new structure of tests that reflects the previous tests hierarchy,
but organizes channel tests in test/channel directory with test programs
each covering specific library feature (or set of closely related features).

The refactored tests cover 100% of checks from the old `channel.cpp`,
plus it refines or adds a bunch more.
NOTE: old test/channel.cpp has not been removed yet.

Common definitions from the single test/channel.cpp moved to
channel_test_fixtures.hpp and namespace boost::gil::test::fixture:
Classes and typedefs:
- `do_test` as `fixture::channel`
- `value_core` as `fixture::channel_value`
- `reference_core` as `fixture::channel_reference`
- `packed_reference_core` as `fixture::packed_channel_reference`
- `packed_dynamic_reference_core` as `fixture::packed_dynamic_channel_reference`
- `channel_archetype` and relatives to `channel_concepts.cpp` which is compile
   test in Jamfile
- `test_packed_channel_reference()` parts as `fixture::packed_channels565`
- `test_packed_dynamic_channel_reference()` parts as `fixture::packed_dynamic_channels565`
Test case functions called from `do_test<T>::test_all`:
- `test_channel_invert()` to `algorithm_channel_invert.cpp` suite
- `test_channel_convert()` to `algorithm_channel_convert.cpp` suite
- `test_channel_multiply()` to `algorithm_channel_multiply.cpp` suite
- `test_channel_math()` split to `algorithm_channel_relation.cpp`
   and `algorithm_channel_arithmetic.cpp`

Add test cases for each channel value type T as used to run from
`test_channel_value_impl<T>`, `test_packed_channel_reference<T>` and
`test_packed_dynamic_channel_reference<T>`.

Add list of possible T-s defined as type-lists `fixture::channel_byte_types`,
`fixture::channel_integer_types`, `channel_float_types` and
`channel_bitfield_types` which used with `BOOST_AUTO_TEST_CASE_TEMPLATE`
generate all possible combination of inputs.

Add new `channel_test_fixture.cpp` is a self-test suite verifying the fixtures.
2018-06-27 00:02:27 -04:00

70 lines
2.4 KiB
C++

//
// Copyright 2018 Mateusz Loskot <mateusz at loskot dot net>
//
// Distributed under the Boost Software License, Version 1.0
// See accompanying file LICENSE_1_0.txt or copy at
// http://www.boost.org/LICENSE_1_0.txt
//
#define BOOST_TEST_MODULE test_channel_test_fixture
#include <gil_test_common.hpp>
#include "channel_test_fixture.hpp"
namespace fixture = boost::gil::test::fixture;
BOOST_AUTO_TEST_CASE_TEMPLATE(channel_minmax_value, Channel, fixture::channel_byte_types)
{
fixture::channel_minmax_value<Channel> fix;
fixture::channel_minmax_value<Channel> exp;
BOOST_TEST(fix.min_v_ == exp.min_v_);
BOOST_TEST(fix.max_v_ == exp.max_v_);
}
BOOST_AUTO_TEST_CASE_TEMPLATE(channel_value, Channel, fixture::channel_byte_types)
{
fixture::channel_value<Channel> fix;
fixture::channel_minmax_value<Channel> exp;
BOOST_TEST(fix.min_v_ == exp.min_v_);
BOOST_TEST(fix.max_v_ == exp.max_v_);
}
BOOST_AUTO_TEST_CASE_TEMPLATE(channel_reference, Channel, fixture::channel_byte_types)
{
fixture::channel_reference<Channel&> fix;
fixture::channel_minmax_value<Channel> exp;
BOOST_TEST(fix.min_v_ == exp.min_v_);
BOOST_TEST(fix.max_v_ == exp.max_v_);
}
BOOST_AUTO_TEST_CASE_TEMPLATE(
channel_reference_const, Channel, fixture::channel_byte_types)
{
fixture::channel_reference<Channel const&> fix;
fixture::channel_minmax_value<Channel> exp;
BOOST_TEST(fix.min_v_ == exp.min_v_);
BOOST_TEST(fix.max_v_ == exp.max_v_);
}
BOOST_AUTO_TEST_CASE_TEMPLATE(
packed_channels565, BitField, fixture::channel_bitfield_types)
{
static_assert(std::is_integral<BitField>::value, "bitfield is not integral type");
// Regardless of BitField buffer bit-size, the fixture is initialized
// with max value that fits into 5+6+5 bit integer
fixture::packed_channels565<BitField> fix;
fixture::channel_minmax_value<std::uint16_t> exp;
BOOST_TEST(fix.data_ == exp.max_v_);
}
BOOST_AUTO_TEST_CASE_TEMPLATE(
packed_dynamic_channels565, BitField, fixture::channel_bitfield_types)
{
static_assert(std::is_integral<BitField>::value, "bitfield is not integral type");
// Regardless of BitField buffer bit-size, the fixture is initialized
// with max value that fits into 5+6+5 bit integer
fixture::packed_dynamic_channels565<BitField> fix;
fixture::channel_minmax_value<std::uint16_t> exp;
BOOST_TEST(fix.data_ == exp.max_v_);
}