boost/test

mirror of https://github.com/boostorg/test.git synced 2026-01-24 18:32:30 +00:00

Go to file

Raffi Enficiaud 65892881d7 Merge branch 'develop'

* develop:
  Change log
  Use BOOST_OVERRIDE to fix GCC -Wsuggest-override and Clang-tidy modernize-use-override warnings. Also fix misspellings in comments.
  Change log
  Printf check attribute factorization
  Inline friend function definitions for exported/imported classes
  Add Embarcadero to conforming implementation
  Change __BORLANDC__ to BOOST_BORLANDC,
  Change log
  Adding LLDB as debugger
  Change log
  Fixing deprecated inclusions to boost/bind
  Fixing cast issue when logging wchar_t
  Make under_debugger work on apple (iOS/macOS)
  Change log
  Use macOS API only on macOS

2020-05-17 12:02:41 +02:00

build

CMakeLists.txt improvements

2020-04-04 22:57:56 +02:00

doc

Merge branch 'topic/GH-264-GCC-override-warnings-suggestions' into next-internal

2020-05-09 19:27:46 +02:00

example

Fixing deprecated inclusions to boost/bind

2020-05-09 14:44:34 +02:00

include/boost/test

Merge branch 'topic/GH-264-GCC-override-warnings-suggestions' into next-internal

2020-05-09 19:27:46 +02:00

README.md

What is Boost.Test?

Boost.Test is a C++03/11/14/17 unit testing library, available on a wide range of platforms and compilers.

The library is part of Boost. The latest release of the library is available from the boost web site.

Full instructions for use of this library can be accessed from http://www.boost.org/doc/libs/release/libs/test/

Key features

Easy to get started with:

download and deflate the latest boost archive

create a test module with this (header version):

#define BOOST_TEST_MODULE your_test_module
#include <boost/test/included/unit_test.hpp>

Write your first test case:

BOOST_AUTO_TEST_CASE( your_test_case ) {
    std::vector<int> a{1, 2};
    std::vector<int> b{1, 2};
    BOOST_TEST( a == b );
}

build and run
done

powerful and unique test assertion macro BOOST_TEST, that understands floating points, collections, strings... and uses appropriate comparison paradigm
self-registering test cases, organize cases in test suites, apply fixtures on test cases, suites or globally
provide assertion context for advanced diagnostic on failure
powerful and extensible dataset tests
add decoration to test cases and suites for advanced description, group/label, and dependencies
powerful command line options and test case filters
extensible logging, XML and JUNIT outputs for third-party tools (eg. cont. integration)
various usage (shared/static library/header only) for faster integration and/or compilation/build cycles, smaller binaries

Copyright and license

Distributed under the Boost Software License, Version 1.0.
(Get a copy at www.boost.org/LICENSE_1_0.txt)

Contribute

Please read this document to get started.

Build Status

Branch	Travis	Appveyor	codecov.io	Deps	Docs	Tests
`master`
`develop`