Features

Previously, Approvals wouldn't register as an assertion, giving misleading messages and reporting, and sometimes causing a test framework to complain that there were no assertions.

v.10.5.0

Support for selecting Reporter at run-time

See How to Select a Reporter with an Environment Variable.

v.10.4.0

Support for CppUTest framework

See Using Approval Tests With CppUTest.

v.10.3.0

Approvals::verifyAll and std::initializer_list

Added std::initializer_list support to Approvals::verifyAll().

For example:

ApprovalTests::Approvals::verifyAll({10, 20, 30});

^{snippet source | anchor}

v.10.2.0

DateUtils

See DateUtils

v.10.1.1

Improved Compilation Speeds

Compilation Times: v.10.1.0: 2.7 secs vs v.10.1.1: 1.2 secs

v.10.0.0

Removed Deprecated Code

See Why We Are Converting To Options for easy ways to update your code.

Specifically, the following have been removed:

Methods
- Approvals::verify(..., Reporter)
- Approvals::verifyAll(..., Reporter)
- Approvals::verifyExistingFile(..., Reporter)
- Approvals::verifyExceptionMessage(..., Reporter)
- Approvals::verifyWithExtension(...)
- CombinationApprovals::verifyAllCombinations(Reporter, ...)
Macros
- APPROVAL_TESTS_HIDE_DEPRECATED_CODE
- APPROVALTESTS_VERSION
- APPROVALTESTS_VERSION_MAJOR
- APPROVALTESTS_VERSION_MINOR
- APPROVALTESTS_VERSION_PATCH
- APPROVALTESTS_VERSION_STR
- APPROVALS_CATCH_DISABLE_FILE_MACRO_CHECK

v.8.9.0

Regex-based Scrubbing

See Scrubbing using Regular Expressions (regex).

v.8.8.0

FmtApprovals

See How to Use the Fmt Library To Print Objects.

v.8.7.0

Options

See Options.

Scrubbers

See How to Scrub Non-Deterministic Output.

StringMaker and TApprovals

This is in internal change, which will provide future flexibility, and does not change any existing code.

In this release, we:

templatized the Approvals class, renaming it to TApprovals
changed the CombinationApprovals namespace to a template class called TCombinationApprovals
introduced the StringMaker class as an additional customization point for the above two classes

To learn about the extra string-formatting options for your objects, see To String.

Consistent macro names

All our Macros now start with APPROVAL_TESTS_.

We have kept the old macros, redirecting to the new ones, for backwards compatibility.

Old	New
`APPROVALTESTS_VERSION`	`APPROVAL_TESTS_VERSION`
`APPROVALTESTS_VERSION_MAJOR`	`APPROVAL_TESTS_VERSION_MAJOR`
`APPROVALTESTS_VERSION_MINOR`	`APPROVAL_TESTS_VERSION_MINOR`
`APPROVALTESTS_VERSION_PATCH`	`APPROVAL_TESTS_VERSION_PATCH`
`APPROVALTESTS_VERSION_STR`	`APPROVAL_TESTS_VERSION_STR`
`APPROVALS_CATCH_DISABLE_FILE_MACRO_CHECK`	`APPROVAL_TESTS_DISABLE_FILE_MACRO_CHECK`

v.8.6.0

Support for Boost.Test framework

See Using Approval Tests With Boost.Test

v.8.5.0

Support for Sublime Merge

Added support for Sublime Merge on Linux, macOS, and Windows (See #103)

Support for Beyond Compare on Linux

Added support for Beyond Compare on Linux (See #114).

v.8.3.0

Flexibility for adding custom merge tools

CustomReporter::create() adds flexibility for adding custom merge tools: see How to Use A Custom Reporter.

Supporting new merge tools.

See How to Submit a New Reporter to ApprovalTests.

v.8.2.0

Conan Integration documented

See Conan Integration.

v.8.1.0

Version detection

ApprovalTests provides the following macros to detect the release version, with a set of example values shown in italics:

APPROVAL_TESTS_VERSION_MAJOR: 8
APPROVAL_TESTS_VERSION_MINOR: 1
APPROVAL_TESTS_VERSION_PATCH: 2
APPROVAL_TESTS_VERSION_STR: 8.1.2
APPROVAL_TESTS_VERSION: 80102

TEST_CASE("Only run this test on John's machine")
{
    auto blocker = ApprovalTests::MachineBlocker::onMachinesNotNamed("JOHNS_MACHINE");
    if (blocker.isBlockingOnThisMachine())
    {
        return;
    }
    // Write tests here that depend on John's environment.
    REQUIRE(ApprovalTests::SystemUtils::getMachineName() == "JOHNS_MACHINE");
}

^{snippet source | anchor}

Front Loaded Reporters

See Front Loaded Reporters

Using sub-directories for approved files

See Using sub-directories for approved files

Back to User Guide