externals: Update catch2 to v3.5.0
Merge commit 'ba06a404d1437c73ed3ba100d04a217fa69545b8'
This commit is contained in:
commit
b372dc6157
272 changed files with 22238 additions and 7949 deletions
41
externals/catch/.clang-format
vendored
41
externals/catch/.clang-format
vendored
|
@ -4,41 +4,42 @@ Standard: c++14
|
||||||
|
|
||||||
# Note that we cannot use IncludeIsMainRegex functionality, because it
|
# Note that we cannot use IncludeIsMainRegex functionality, because it
|
||||||
# does not support includes in angle brackets (<>)
|
# does not support includes in angle brackets (<>)
|
||||||
SortIncludes: True
|
SortIncludes: true
|
||||||
IncludeBlocks: Regroup
|
IncludeBlocks: Regroup
|
||||||
IncludeCategories:
|
IncludeCategories:
|
||||||
- Regex: '<catch2/.*\.hpp>'
|
- Regex: <catch2/.*\.hpp>
|
||||||
Priority: 1
|
Priority: 1
|
||||||
- Regex: '<.*/.*\.hpp>'
|
- Regex: <.*/.*\.hpp>
|
||||||
Priority: 2
|
Priority: 2
|
||||||
- Regex: '<.*>'
|
- Regex: <.*>
|
||||||
Priority: 3
|
Priority: 3
|
||||||
|
|
||||||
|
|
||||||
AllowShortBlocksOnASingleLine: Always
|
AllowShortBlocksOnASingleLine: Always
|
||||||
AllowShortEnumsOnASingleLine: false
|
AllowShortEnumsOnASingleLine: false
|
||||||
AllowShortFunctionsOnASingleLine: All
|
AllowShortFunctionsOnASingleLine: All
|
||||||
AllowShortIfStatementsOnASingleLine: WithoutElse
|
AllowShortIfStatementsOnASingleLine: WithoutElse
|
||||||
AllowShortLambdasOnASingleLine: Inline
|
AllowShortLambdasOnASingleLine: Inline
|
||||||
|
|
||||||
AccessModifierOffset: '-4'
|
AccessModifierOffset: "-4"
|
||||||
AlignEscapedNewlines: Left
|
AlignEscapedNewlines: Left
|
||||||
AllowAllConstructorInitializersOnNextLine: 'true'
|
AllowAllConstructorInitializersOnNextLine: "true"
|
||||||
BinPackArguments: 'false'
|
BinPackArguments: "false"
|
||||||
BinPackParameters: 'false'
|
BinPackParameters: "false"
|
||||||
BreakConstructorInitializers: AfterColon
|
BreakConstructorInitializers: AfterColon
|
||||||
ConstructorInitializerAllOnOneLineOrOnePerLine: 'true'
|
ConstructorInitializerAllOnOneLineOrOnePerLine: "true"
|
||||||
DerivePointerAlignment: 'false'
|
DerivePointerAlignment: "false"
|
||||||
FixNamespaceComments: 'true'
|
FixNamespaceComments: "true"
|
||||||
IndentCaseLabels: 'false'
|
IndentCaseLabels: "false"
|
||||||
IndentPPDirectives: AfterHash
|
IndentPPDirectives: AfterHash
|
||||||
IndentWidth: '4'
|
IndentWidth: "4"
|
||||||
NamespaceIndentation: All
|
NamespaceIndentation: All
|
||||||
PointerAlignment: Left
|
PointerAlignment: Left
|
||||||
SpaceBeforeCtorInitializerColon: 'false'
|
SpaceBeforeCtorInitializerColon: "false"
|
||||||
SpaceInEmptyParentheses: 'false'
|
SpaceInEmptyParentheses: "false"
|
||||||
SpacesInParentheses: 'true'
|
SpacesInParentheses: "true"
|
||||||
TabWidth: '4'
|
TabWidth: "4"
|
||||||
UseTab: Never
|
UseTab: Never
|
||||||
|
AlwaysBreakTemplateDeclarations: Yes
|
||||||
...
|
SpaceAfterTemplateKeyword: true
|
||||||
|
SortUsingDeclarations: true
|
||||||
|
ReflowComments: true
|
||||||
|
|
|
@ -11,7 +11,7 @@ jobs:
|
||||||
compilation_mode: [fastbuild, dbg, opt]
|
compilation_mode: [fastbuild, dbg, opt]
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v3
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
- name: Mount bazel cache
|
- name: Mount bazel cache
|
||||||
uses: actions/cache@v3
|
uses: actions/cache@v3
|
||||||
|
|
|
@ -18,10 +18,12 @@ jobs:
|
||||||
other_pkgs: clang-11
|
other_pkgs: clang-11
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
- name: Prepare environment
|
- name: Prepare environment
|
||||||
run: sudo apt-get install -y meson ninja-build ${{matrix.other_pkgs}}
|
run: |
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y meson ninja-build ${{matrix.other_pkgs}}
|
||||||
|
|
||||||
- name: Configure build
|
- name: Configure build
|
||||||
env:
|
env:
|
||||||
|
|
|
@ -29,13 +29,13 @@ jobs:
|
||||||
build_type: Debug
|
build_type: Debug
|
||||||
std: 14
|
std: 14
|
||||||
other_pkgs: g++-7
|
other_pkgs: g++-7
|
||||||
cmake_configurations: -DCATCH_BUILD_EXTRA_TESTS=ON -DCATCH_BUILD_EXAMPLES=ON
|
cmake_configurations: -DCATCH_BUILD_EXTRA_TESTS=ON -DCATCH_BUILD_EXAMPLES=ON -DCATCH_ENABLE_CMAKE_HELPER_TESTS=ON
|
||||||
- cxx: g++-7
|
- cxx: g++-7
|
||||||
build_description: Extras + Examples
|
build_description: Extras + Examples
|
||||||
build_type: Release
|
build_type: Release
|
||||||
std: 14
|
std: 14
|
||||||
other_pkgs: g++-7
|
other_pkgs: g++-7
|
||||||
cmake_configurations: -DCATCH_BUILD_EXTRA_TESTS=ON -DCATCH_BUILD_EXAMPLES=ON
|
cmake_configurations: -DCATCH_BUILD_EXTRA_TESTS=ON -DCATCH_BUILD_EXAMPLES=ON -DCATCH_ENABLE_CMAKE_HELPER_TESTS=ON
|
||||||
|
|
||||||
# Extras and examples with Clang-10
|
# Extras and examples with Clang-10
|
||||||
- cxx: clang++-10
|
- cxx: clang++-10
|
||||||
|
@ -43,13 +43,13 @@ jobs:
|
||||||
build_type: Debug
|
build_type: Debug
|
||||||
std: 17
|
std: 17
|
||||||
other_pkgs: clang-10
|
other_pkgs: clang-10
|
||||||
cmake_configurations: -DCATCH_BUILD_EXTRA_TESTS=ON -DCATCH_BUILD_EXAMPLES=ON
|
cmake_configurations: -DCATCH_BUILD_EXTRA_TESTS=ON -DCATCH_BUILD_EXAMPLES=ON -DCATCH_ENABLE_CMAKE_HELPER_TESTS=ON
|
||||||
- cxx: clang++-10
|
- cxx: clang++-10
|
||||||
build_description: Extras + Examples
|
build_description: Extras + Examples
|
||||||
build_type: Release
|
build_type: Release
|
||||||
std: 17
|
std: 17
|
||||||
other_pkgs: clang-10
|
other_pkgs: clang-10
|
||||||
cmake_configurations: -DCATCH_BUILD_EXTRA_TESTS=ON -DCATCH_BUILD_EXAMPLES=ON
|
cmake_configurations: -DCATCH_BUILD_EXTRA_TESTS=ON -DCATCH_BUILD_EXAMPLES=ON -DCATCH_ENABLE_CMAKE_HELPER_TESTS=ON
|
||||||
|
|
||||||
# Configure tests with Clang-10
|
# Configure tests with Clang-10
|
||||||
- cxx: clang++-10
|
- cxx: clang++-10
|
||||||
|
@ -70,10 +70,12 @@ jobs:
|
||||||
|
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
- name: Prepare environment
|
- name: Prepare environment
|
||||||
run: sudo apt-get install -y ninja-build ${{matrix.other_pkgs}}
|
run: |
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y ninja-build ${{matrix.other_pkgs}}
|
||||||
|
|
||||||
- name: Configure build
|
- name: Configure build
|
||||||
working-directory: ${{runner.workspace}}
|
working-directory: ${{runner.workspace}}
|
||||||
|
|
|
@ -83,7 +83,7 @@ jobs:
|
||||||
other_pkgs: g++-10
|
other_pkgs: g++-10
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
- name: Add repositories for older GCC
|
- name: Add repositories for older GCC
|
||||||
run: |
|
run: |
|
||||||
|
@ -92,7 +92,9 @@ jobs:
|
||||||
if: ${{ matrix.cxx == 'g++-5' || matrix.cxx == 'g++-6' }}
|
if: ${{ matrix.cxx == 'g++-5' || matrix.cxx == 'g++-6' }}
|
||||||
|
|
||||||
- name: Prepare environment
|
- name: Prepare environment
|
||||||
run: sudo apt-get install -y ninja-build ${{matrix.other_pkgs}}
|
run: |
|
||||||
|
sudo apt-get update
|
||||||
|
sudo apt-get install -y ninja-build ${{matrix.other_pkgs}}
|
||||||
|
|
||||||
- name: Configure build
|
- name: Configure build
|
||||||
working-directory: ${{runner.workspace}}
|
working-directory: ${{runner.workspace}}
|
||||||
|
|
|
@ -22,7 +22,7 @@ jobs:
|
||||||
extra_tests: ON
|
extra_tests: ON
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v2
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
- name: Configure build
|
- name: Configure build
|
||||||
working-directory: ${{runner.workspace}}
|
working-directory: ${{runner.workspace}}
|
||||||
|
@ -42,11 +42,10 @@ jobs:
|
||||||
|
|
||||||
- name: Build tests + lib
|
- name: Build tests + lib
|
||||||
working-directory: ${{runner.workspace}}/build
|
working-directory: ${{runner.workspace}}/build
|
||||||
run: make -j 2
|
run: make -j `sysctl -n hw.ncpu`
|
||||||
|
|
||||||
- name: Run tests
|
- name: Run tests
|
||||||
env:
|
env:
|
||||||
CTEST_OUTPUT_ON_FAILURE: 1
|
CTEST_OUTPUT_ON_FAILURE: 1
|
||||||
working-directory: ${{runner.workspace}}/build
|
working-directory: ${{runner.workspace}}/build
|
||||||
# Hardcode 2 cores we know are there
|
run: ctest -C ${{matrix.build_type}} -j `sysctl -n hw.ncpu`
|
||||||
run: ctest -C ${{matrix.build_type}} -j 2
|
|
||||||
|
|
|
@ -9,7 +9,7 @@ jobs:
|
||||||
steps:
|
steps:
|
||||||
|
|
||||||
- name: Checkout source code
|
- name: Checkout source code
|
||||||
uses: actions/checkout@v2
|
uses: actions/checkout@v4
|
||||||
|
|
||||||
- name: Setup Dependencies
|
- name: Setup Dependencies
|
||||||
uses: actions/setup-python@v2
|
uses: actions/setup-python@v2
|
||||||
|
|
37
externals/catch/.github/workflows/windows-simple-builds.yml
vendored
Normal file
37
externals/catch/.github/workflows/windows-simple-builds.yml
vendored
Normal file
|
@ -0,0 +1,37 @@
|
||||||
|
name: Windows builds (basic)
|
||||||
|
|
||||||
|
on: [push, pull_request]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
build:
|
||||||
|
name: ${{matrix.os}}, ${{matrix.std}}, ${{matrix.build_type}}, ${{matrix.platform}}
|
||||||
|
runs-on: ${{matrix.os}}
|
||||||
|
strategy:
|
||||||
|
matrix:
|
||||||
|
os: [windows-2019, windows-2022]
|
||||||
|
platform: [Win32, x64]
|
||||||
|
build_type: [Debug, Release]
|
||||||
|
std: [14, 17]
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Configure build
|
||||||
|
working-directory: ${{runner.workspace}}
|
||||||
|
run: |
|
||||||
|
cmake -S $Env:GITHUB_WORKSPACE `
|
||||||
|
-B ${{runner.workspace}}/build `
|
||||||
|
-DCMAKE_CXX_STANDARD=${{matrix.std}} `
|
||||||
|
-A ${{matrix.platform}} `
|
||||||
|
--preset all-tests
|
||||||
|
|
||||||
|
- name: Build tests
|
||||||
|
working-directory: ${{runner.workspace}}
|
||||||
|
run: cmake --build build --config ${{matrix.build_type}} --parallel %NUMBER_OF_PROCESSORS%
|
||||||
|
shell: cmd
|
||||||
|
|
||||||
|
- name: Run tests
|
||||||
|
working-directory: ${{runner.workspace}}/build
|
||||||
|
env:
|
||||||
|
CTEST_OUTPUT_ON_FAILURE: 1
|
||||||
|
run: ctest -C ${{matrix.build_type}} -j %NUMBER_OF_PROCESSORS%
|
||||||
|
shell: cmd
|
3
externals/catch/BUILD.bazel
vendored
3
externals/catch/BUILD.bazel
vendored
|
@ -43,12 +43,15 @@ expand_template(
|
||||||
"#cmakedefine CATCH_CONFIG_NO_GLOBAL_NEXTAFTER": "",
|
"#cmakedefine CATCH_CONFIG_NO_GLOBAL_NEXTAFTER": "",
|
||||||
"#cmakedefine CATCH_CONFIG_NO_POSIX_SIGNALS": "",
|
"#cmakedefine CATCH_CONFIG_NO_POSIX_SIGNALS": "",
|
||||||
"#cmakedefine CATCH_CONFIG_NO_USE_ASYNC": "",
|
"#cmakedefine CATCH_CONFIG_NO_USE_ASYNC": "",
|
||||||
|
"#cmakedefine CATCH_CONFIG_NO_EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT": "",
|
||||||
"#cmakedefine CATCH_CONFIG_NO_WCHAR": "",
|
"#cmakedefine CATCH_CONFIG_NO_WCHAR": "",
|
||||||
"#cmakedefine CATCH_CONFIG_NO_WINDOWS_SEH": "",
|
"#cmakedefine CATCH_CONFIG_NO_WINDOWS_SEH": "",
|
||||||
"#cmakedefine CATCH_CONFIG_NOSTDOUT": "",
|
"#cmakedefine CATCH_CONFIG_NOSTDOUT": "",
|
||||||
"#cmakedefine CATCH_CONFIG_POSIX_SIGNALS": "",
|
"#cmakedefine CATCH_CONFIG_POSIX_SIGNALS": "",
|
||||||
"#cmakedefine CATCH_CONFIG_PREFIX_ALL": "",
|
"#cmakedefine CATCH_CONFIG_PREFIX_ALL": "",
|
||||||
|
"#cmakedefine CATCH_CONFIG_PREFIX_MESSAGES": "",
|
||||||
"#cmakedefine CATCH_CONFIG_SHARED_LIBRARY": "",
|
"#cmakedefine CATCH_CONFIG_SHARED_LIBRARY": "",
|
||||||
|
"#cmakedefine CATCH_CONFIG_EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT": "",
|
||||||
"#cmakedefine CATCH_CONFIG_USE_ASYNC": "",
|
"#cmakedefine CATCH_CONFIG_USE_ASYNC": "",
|
||||||
"#cmakedefine CATCH_CONFIG_WCHAR": "",
|
"#cmakedefine CATCH_CONFIG_WCHAR": "",
|
||||||
"#cmakedefine CATCH_CONFIG_WINDOWS_CRTDBG": "",
|
"#cmakedefine CATCH_CONFIG_WINDOWS_CRTDBG": "",
|
||||||
|
|
12
externals/catch/CMake/CatchConfigOptions.cmake
vendored
12
externals/catch/CMake/CatchConfigOptions.cmake
vendored
|
@ -18,10 +18,12 @@
|
||||||
macro(AddOverridableConfigOption OptionBaseName)
|
macro(AddOverridableConfigOption OptionBaseName)
|
||||||
option(CATCH_CONFIG_${OptionBaseName} "Read docs/configuration.md for details" OFF)
|
option(CATCH_CONFIG_${OptionBaseName} "Read docs/configuration.md for details" OFF)
|
||||||
option(CATCH_CONFIG_NO_${OptionBaseName} "Read docs/configuration.md for details" OFF)
|
option(CATCH_CONFIG_NO_${OptionBaseName} "Read docs/configuration.md for details" OFF)
|
||||||
|
mark_as_advanced(CATCH_CONFIG_${OptionBaseName} CATCH_CONFIG_NO_${OptionBaseName})
|
||||||
endmacro()
|
endmacro()
|
||||||
|
|
||||||
macro(AddConfigOption OptionBaseName)
|
macro(AddConfigOption OptionBaseName)
|
||||||
option(CATCH_CONFIG_${OptionBaseName} "Read docs/configuration.md for details" OFF)
|
option(CATCH_CONFIG_${OptionBaseName} "Read docs/configuration.md for details" OFF)
|
||||||
|
mark_as_advanced(CATCH_CONFIG_${OptionBaseName})
|
||||||
endmacro()
|
endmacro()
|
||||||
|
|
||||||
set(_OverridableOptions
|
set(_OverridableOptions
|
||||||
|
@ -41,6 +43,7 @@ set(_OverridableOptions
|
||||||
"WCHAR"
|
"WCHAR"
|
||||||
"WINDOWS_SEH"
|
"WINDOWS_SEH"
|
||||||
"GETENV"
|
"GETENV"
|
||||||
|
"EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT"
|
||||||
)
|
)
|
||||||
|
|
||||||
foreach(OptionName ${_OverridableOptions})
|
foreach(OptionName ${_OverridableOptions})
|
||||||
|
@ -61,6 +64,7 @@ set(_OtherConfigOptions
|
||||||
"FAST_COMPILE"
|
"FAST_COMPILE"
|
||||||
"NOSTDOUT"
|
"NOSTDOUT"
|
||||||
"PREFIX_ALL"
|
"PREFIX_ALL"
|
||||||
|
"PREFIX_MESSAGES"
|
||||||
"WINDOWS_CRTDBG"
|
"WINDOWS_CRTDBG"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
@ -68,11 +72,17 @@ set(_OtherConfigOptions
|
||||||
foreach(OptionName ${_OtherConfigOptions})
|
foreach(OptionName ${_OtherConfigOptions})
|
||||||
AddConfigOption(${OptionName})
|
AddConfigOption(${OptionName})
|
||||||
endforeach()
|
endforeach()
|
||||||
set(CATCH_CONFIG_SHARED_LIBRARY ${BUILD_SHARED_LIBS})
|
if(DEFINED BUILD_SHARED_LIBS)
|
||||||
|
set(CATCH_CONFIG_SHARED_LIBRARY ${BUILD_SHARED_LIBS})
|
||||||
|
else()
|
||||||
|
set(CATCH_CONFIG_SHARED_LIBRARY "")
|
||||||
|
endif()
|
||||||
|
|
||||||
set(CATCH_CONFIG_DEFAULT_REPORTER "console" CACHE STRING "Read docs/configuration.md for details. The name of the reporter should be without quotes.")
|
set(CATCH_CONFIG_DEFAULT_REPORTER "console" CACHE STRING "Read docs/configuration.md for details. The name of the reporter should be without quotes.")
|
||||||
set(CATCH_CONFIG_CONSOLE_WIDTH "80" CACHE STRING "Read docs/configuration.md for details. Must form a valid integer literal.")
|
set(CATCH_CONFIG_CONSOLE_WIDTH "80" CACHE STRING "Read docs/configuration.md for details. Must form a valid integer literal.")
|
||||||
|
|
||||||
|
mark_as_advanced(CATCH_CONFIG_SHARED_LIBRARY CATCH_CONFIG_DEFAULT_REPORTER CATCH_CONFIG_CONSOLE_WIDTH)
|
||||||
|
|
||||||
# There is no good way to both turn this into a CMake cache variable,
|
# There is no good way to both turn this into a CMake cache variable,
|
||||||
# and keep reasonable default semantics inside the project. Thus we do
|
# and keep reasonable default semantics inside the project. Thus we do
|
||||||
# not define it and users have to provide it as an outside variable.
|
# not define it and users have to provide it as an outside variable.
|
||||||
|
|
|
@ -46,7 +46,6 @@ function(add_warnings_to_targets targets)
|
||||||
set(CHECKED_WARNING_FLAGS
|
set(CHECKED_WARNING_FLAGS
|
||||||
"-Wabsolute-value"
|
"-Wabsolute-value"
|
||||||
"-Wall"
|
"-Wall"
|
||||||
"-Wc++20-compat"
|
|
||||||
"-Wcall-to-pure-virtual-from-ctor-dtor"
|
"-Wcall-to-pure-virtual-from-ctor-dtor"
|
||||||
"-Wcast-align"
|
"-Wcast-align"
|
||||||
"-Wcatch-value"
|
"-Wcatch-value"
|
||||||
|
@ -74,6 +73,7 @@ function(add_warnings_to_targets targets)
|
||||||
"-Woverloaded-virtual"
|
"-Woverloaded-virtual"
|
||||||
"-Wparentheses"
|
"-Wparentheses"
|
||||||
"-Wpedantic"
|
"-Wpedantic"
|
||||||
|
"-Wredundant-decls"
|
||||||
"-Wreorder"
|
"-Wreorder"
|
||||||
"-Wreturn-std-move"
|
"-Wreturn-std-move"
|
||||||
"-Wshadow"
|
"-Wshadow"
|
||||||
|
@ -83,7 +83,7 @@ function(add_warnings_to_targets targets)
|
||||||
"-Wundef"
|
"-Wundef"
|
||||||
"-Wuninitialized"
|
"-Wuninitialized"
|
||||||
"-Wunneeded-internal-declaration"
|
"-Wunneeded-internal-declaration"
|
||||||
"-Wunreachable-code"
|
"-Wunreachable-code-aggressive"
|
||||||
"-Wunused"
|
"-Wunused"
|
||||||
"-Wunused-function"
|
"-Wunused-function"
|
||||||
"-Wunused-parameter"
|
"-Wunused-parameter"
|
||||||
|
|
5
externals/catch/CMakeLists.txt
vendored
5
externals/catch/CMakeLists.txt
vendored
|
@ -21,6 +21,7 @@ cmake_dependent_option(CATCH_ENABLE_COVERAGE "Generate coverage for codecov.io"
|
||||||
cmake_dependent_option(CATCH_ENABLE_WERROR "Enables Werror during build" ON "CATCH_DEVELOPMENT_BUILD" OFF)
|
cmake_dependent_option(CATCH_ENABLE_WERROR "Enables Werror during build" ON "CATCH_DEVELOPMENT_BUILD" OFF)
|
||||||
cmake_dependent_option(CATCH_BUILD_SURROGATES "Enable generating and building surrogate TUs for the main headers" OFF "CATCH_DEVELOPMENT_BUILD" OFF)
|
cmake_dependent_option(CATCH_BUILD_SURROGATES "Enable generating and building surrogate TUs for the main headers" OFF "CATCH_DEVELOPMENT_BUILD" OFF)
|
||||||
cmake_dependent_option(CATCH_ENABLE_CONFIGURE_TESTS "Enable CMake configuration tests. WARNING: VERY EXPENSIVE" OFF "CATCH_DEVELOPMENT_BUILD" OFF)
|
cmake_dependent_option(CATCH_ENABLE_CONFIGURE_TESTS "Enable CMake configuration tests. WARNING: VERY EXPENSIVE" OFF "CATCH_DEVELOPMENT_BUILD" OFF)
|
||||||
|
cmake_dependent_option(CATCH_ENABLE_CMAKE_HELPER_TESTS "Enable CMake helper tests. WARNING: VERY EXPENSIVE" OFF "CATCH_DEVELOPMENT_BUILD" OFF)
|
||||||
|
|
||||||
|
|
||||||
# Catch2's build breaks if done in-tree. You probably should not build
|
# Catch2's build breaks if done in-tree. You probably should not build
|
||||||
|
@ -31,7 +32,7 @@ if (CMAKE_BINARY_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR)
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
project(Catch2
|
project(Catch2
|
||||||
VERSION 3.2.1 # CML version placeholder, don't delete
|
VERSION 3.5.0 # CML version placeholder, don't delete
|
||||||
LANGUAGES CXX
|
LANGUAGES CXX
|
||||||
# HOMEPAGE_URL is not supported until CMake version 3.12, which
|
# HOMEPAGE_URL is not supported until CMake version 3.12, which
|
||||||
# we do not target yet.
|
# we do not target yet.
|
||||||
|
@ -148,6 +149,8 @@ if (NOT_SUBPROJECT)
|
||||||
"extras/ParseAndAddCatchTests.cmake"
|
"extras/ParseAndAddCatchTests.cmake"
|
||||||
"extras/Catch.cmake"
|
"extras/Catch.cmake"
|
||||||
"extras/CatchAddTests.cmake"
|
"extras/CatchAddTests.cmake"
|
||||||
|
"extras/CatchShardTests.cmake"
|
||||||
|
"extras/CatchShardTestsImpl.cmake"
|
||||||
DESTINATION
|
DESTINATION
|
||||||
${CATCH_CMAKE_CONFIG_DESTINATION}
|
${CATCH_CMAKE_CONFIG_DESTINATION}
|
||||||
)
|
)
|
||||||
|
|
3
externals/catch/CMakePresets.json
vendored
3
externals/catch/CMakePresets.json
vendored
|
@ -18,7 +18,8 @@
|
||||||
"CATCH_BUILD_EXAMPLES": "ON",
|
"CATCH_BUILD_EXAMPLES": "ON",
|
||||||
"CATCH_BUILD_EXTRA_TESTS": "ON",
|
"CATCH_BUILD_EXTRA_TESTS": "ON",
|
||||||
"CATCH_BUILD_SURROGATES": "ON",
|
"CATCH_BUILD_SURROGATES": "ON",
|
||||||
"CATCH_ENABLE_CONFIGURE_TESTS": "ON"
|
"CATCH_ENABLE_CONFIGURE_TESTS": "ON",
|
||||||
|
"CATCH_ENABLE_CMAKE_HELPER_TESTS": "ON"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
]
|
]
|
||||||
|
|
2
externals/catch/Doxyfile
vendored
2
externals/catch/Doxyfile
vendored
|
@ -1319,7 +1319,7 @@ CHM_FILE =
|
||||||
HHC_LOCATION =
|
HHC_LOCATION =
|
||||||
|
|
||||||
# The GENERATE_CHI flag controls if a separate .chi index file is generated
|
# The GENERATE_CHI flag controls if a separate .chi index file is generated
|
||||||
# (YES) or that it should be included in the master .chm file (NO).
|
# (YES) or that it should be included in the main .chm file (NO).
|
||||||
# The default value is: NO.
|
# The default value is: NO.
|
||||||
# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
|
# This tag requires that the tag GENERATE_HTMLHELP is set to YES.
|
||||||
|
|
||||||
|
|
20
externals/catch/README.md
vendored
20
externals/catch/README.md
vendored
|
@ -47,24 +47,28 @@ TEST_CASE( "Factorials are computed", "[factorial]" ) {
|
||||||
#include <cstdint>
|
#include <cstdint>
|
||||||
|
|
||||||
uint64_t fibonacci(uint64_t number) {
|
uint64_t fibonacci(uint64_t number) {
|
||||||
return number < 2 ? 1 : fibonacci(number - 1) + fibonacci(number - 2);
|
return number < 2 ? number : fibonacci(number - 1) + fibonacci(number - 2);
|
||||||
}
|
}
|
||||||
|
|
||||||
TEST_CASE("Benchmark Fibonacci", "[!benchmark]") {
|
TEST_CASE("Benchmark Fibonacci", "[!benchmark]") {
|
||||||
REQUIRE(Fibonacci(5) == 5);
|
REQUIRE(fibonacci(5) == 5);
|
||||||
|
|
||||||
REQUIRE(Fibonacci(20) == 6'765);
|
REQUIRE(fibonacci(20) == 6'765);
|
||||||
BENCHMARK("Fibonacci 20") {
|
BENCHMARK("fibonacci 20") {
|
||||||
return Fibonacci(20);
|
return fibonacci(20);
|
||||||
};
|
};
|
||||||
|
|
||||||
REQUIRE(Fibonacci(25) == 75'025);
|
REQUIRE(fibonacci(25) == 75'025);
|
||||||
BENCHMARK("Fibonacci 25") {
|
BENCHMARK("fibonacci 25") {
|
||||||
return Fibonacci(25);
|
return fibonacci(25);
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
_Note that benchmarks are not run by default, so you need to run it explicitly
|
||||||
|
with the `[!benchmark]` tag._
|
||||||
|
|
||||||
|
|
||||||
## Catch2 v3 has been released!
|
## Catch2 v3 has been released!
|
||||||
|
|
||||||
You are on the `devel` branch, where the v3 version is being developed.
|
You are on the `devel` branch, where the v3 version is being developed.
|
||||||
|
|
7
externals/catch/WORKSPACE.bazel
vendored
7
externals/catch/WORKSPACE.bazel
vendored
|
@ -4,12 +4,13 @@ load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
|
||||||
|
|
||||||
http_archive(
|
http_archive(
|
||||||
name = "bazel_skylib",
|
name = "bazel_skylib",
|
||||||
|
sha256 = "66ffd9315665bfaafc96b52278f57c7e2dd09f5ede279ea6d39b2be471e7e3aa",
|
||||||
urls = [
|
urls = [
|
||||||
"https://mirror.bazel.build/github.com/bazelbuild/bazel-skylib/releases/download/1.3.0/bazel-skylib-1.3.0.tar.gz",
|
"https://mirror.bazel.build/github.com/bazelbuild/bazel-skylib/releases/download/1.4.2/bazel-skylib-1.4.2.tar.gz",
|
||||||
"https://github.com/bazelbuild/bazel-skylib/releases/download/1.3.0/bazel-skylib-1.3.0.tar.gz",
|
"https://github.com/bazelbuild/bazel-skylib/releases/download/1.4.2/bazel-skylib-1.4.2.tar.gz",
|
||||||
],
|
],
|
||||||
sha256 = "74d544d96f4a5bb630d465ca8bbcfe231e3594e5aae57e1edbf17a6eb3ca2506",
|
|
||||||
)
|
)
|
||||||
|
|
||||||
load("@bazel_skylib//:workspace.bzl", "bazel_skylib_workspace")
|
load("@bazel_skylib//:workspace.bzl", "bazel_skylib_workspace")
|
||||||
|
|
||||||
bazel_skylib_workspace()
|
bazel_skylib_workspace()
|
||||||
|
|
57
externals/catch/appveyor.yml
vendored
57
externals/catch/appveyor.yml
vendored
|
@ -51,18 +51,6 @@ test_script:
|
||||||
# build explicitly.
|
# build explicitly.
|
||||||
environment:
|
environment:
|
||||||
matrix:
|
matrix:
|
||||||
- FLAVOR: VS 2019 x64 Debug Surrogates Configure Tests
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
|
|
||||||
surrogates: 1
|
|
||||||
configure_tests: 1
|
|
||||||
platform: x64
|
|
||||||
configuration: Debug
|
|
||||||
|
|
||||||
- FLAVOR: VS 2019 x64 Release
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
|
|
||||||
platform: x64
|
|
||||||
configuration: Release
|
|
||||||
|
|
||||||
- FLAVOR: VS 2019 x64 Debug Coverage Examples
|
- FLAVOR: VS 2019 x64 Debug Coverage Examples
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
|
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
|
||||||
examples: 1
|
examples: 1
|
||||||
|
@ -77,53 +65,8 @@ environment:
|
||||||
platform: x64
|
platform: x64
|
||||||
configuration: Debug
|
configuration: Debug
|
||||||
|
|
||||||
- FLAVOR: VS 2019 Win32 Debug
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
|
|
||||||
platform: Win32
|
|
||||||
configuration: Debug
|
|
||||||
|
|
||||||
- FLAVOR: VS 2019 x64 Debug Latest Strict
|
- FLAVOR: VS 2019 x64 Debug Latest Strict
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
|
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2019
|
||||||
additional_flags: "/permissive- /std:c++latest"
|
additional_flags: "/permissive- /std:c++latest"
|
||||||
platform: x64
|
platform: x64
|
||||||
configuration: Debug
|
configuration: Debug
|
||||||
|
|
||||||
- FLAVOR: VS 2017 x64 Debug
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
|
|
||||||
platform: x64
|
|
||||||
configuration: Debug
|
|
||||||
|
|
||||||
- FLAVOR: VS 2017 x64 Release
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
|
|
||||||
platform: x64
|
|
||||||
configuration: Release
|
|
||||||
|
|
||||||
- FLAVOR: VS 2017 x64 Release Coverage
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
|
|
||||||
coverage: 1
|
|
||||||
platform: x64
|
|
||||||
configuration: Debug
|
|
||||||
|
|
||||||
- FLAVOR: VS 2017 Win32 Debug
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
|
|
||||||
platform: Win32
|
|
||||||
configuration: Debug
|
|
||||||
|
|
||||||
- FLAVOR: VS 2017 Win32 Debug Examples
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
|
|
||||||
examples: 1
|
|
||||||
platform: Win32
|
|
||||||
configuration: Debug
|
|
||||||
|
|
||||||
- FLAVOR: VS 2017 Win32 Debug WMain
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
|
|
||||||
wmain: 1
|
|
||||||
additional_flags: "/D_UNICODE /DUNICODE"
|
|
||||||
platform: Win32
|
|
||||||
configuration: Debug
|
|
||||||
|
|
||||||
- FLAVOR: VS 2017 x64 Debug Latest Strict
|
|
||||||
APPVEYOR_BUILD_WORKER_IMAGE: Visual Studio 2017
|
|
||||||
additional_flags: "/permissive- /std:c++latest"
|
|
||||||
platform: x64
|
|
||||||
configuration: Debug
|
|
||||||
|
|
1
externals/catch/docs/Readme.md
vendored
1
externals/catch/docs/Readme.md
vendored
|
@ -11,6 +11,7 @@ Once you're up and running consider the following reference material.
|
||||||
* [Logging macros](logging.md#top)
|
* [Logging macros](logging.md#top)
|
||||||
* [Test cases and sections](test-cases-and-sections.md#top)
|
* [Test cases and sections](test-cases-and-sections.md#top)
|
||||||
* [Test fixtures](test-fixtures.md#top)
|
* [Test fixtures](test-fixtures.md#top)
|
||||||
|
* [Explicitly skipping, passing, and failing tests at runtime](skipping-passing-failing.md#top)
|
||||||
* [Reporters (output customization)](reporters.md#top)
|
* [Reporters (output customization)](reporters.md#top)
|
||||||
* [Event Listeners](event-listeners.md#top)
|
* [Event Listeners](event-listeners.md#top)
|
||||||
* [Data Generators (value parameterized tests)](generators.md#top)
|
* [Data Generators (value parameterized tests)](generators.md#top)
|
||||||
|
|
2
externals/catch/docs/benchmarks.md
vendored
2
externals/catch/docs/benchmarks.md
vendored
|
@ -93,7 +93,7 @@ Fibonacci
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
C:\path\to\Catch2\Benchmark.tests.cpp(10)
|
C:\path\to\Catch2\Benchmark.tests.cpp(10)
|
||||||
...............................................................................
|
...............................................................................
|
||||||
benchmark name samples iterations estimated
|
benchmark name samples iterations est run time
|
||||||
mean low mean high mean
|
mean low mean high mean
|
||||||
std dev low std dev high std dev
|
std dev low std dev high std dev
|
||||||
-------------------------------------------------------------------------------
|
-------------------------------------------------------------------------------
|
||||||
|
|
2
externals/catch/docs/ci-and-misc.md
vendored
2
externals/catch/docs/ci-and-misc.md
vendored
|
@ -82,7 +82,7 @@ variable set to "1".
|
||||||
|
|
||||||
### CodeCoverage module (GCOV, LCOV...)
|
### CodeCoverage module (GCOV, LCOV...)
|
||||||
|
|
||||||
If you are using GCOV tool to get testing coverage of your code, and are not sure how to integrate it with CMake and Catch, there should be an external example over at https://github.com/fkromer/catch_cmake_coverage
|
If you are using GCOV tool to get testing coverage of your code, and are not sure how to integrate it with CMake and Catch, there should be an external example over at https://github.com/claremacrae/catch_cmake_coverage
|
||||||
|
|
||||||
|
|
||||||
### pkg-config
|
### pkg-config
|
||||||
|
|
27
externals/catch/docs/cmake-integration.md
vendored
27
externals/catch/docs/cmake-integration.md
vendored
|
@ -51,7 +51,7 @@ Include(FetchContent)
|
||||||
FetchContent_Declare(
|
FetchContent_Declare(
|
||||||
Catch2
|
Catch2
|
||||||
GIT_REPOSITORY https://github.com/catchorg/Catch2.git
|
GIT_REPOSITORY https://github.com/catchorg/Catch2.git
|
||||||
GIT_TAG v3.0.1 # or a later release
|
GIT_TAG v3.4.0 # or a later release
|
||||||
)
|
)
|
||||||
|
|
||||||
FetchContent_MakeAvailable(Catch2)
|
FetchContent_MakeAvailable(Catch2)
|
||||||
|
@ -90,12 +90,12 @@ cmake_minimum_required(VERSION 3.5)
|
||||||
project(baz LANGUAGES CXX VERSION 0.0.1)
|
project(baz LANGUAGES CXX VERSION 0.0.1)
|
||||||
|
|
||||||
find_package(Catch2 REQUIRED)
|
find_package(Catch2 REQUIRED)
|
||||||
add_executable(foo test.cpp)
|
add_executable(tests test.cpp)
|
||||||
target_link_libraries(foo PRIVATE Catch2::Catch2)
|
target_link_libraries(tests PRIVATE Catch2::Catch2)
|
||||||
|
|
||||||
include(CTest)
|
include(CTest)
|
||||||
include(Catch)
|
include(Catch)
|
||||||
catch_discover_tests(foo)
|
catch_discover_tests(tests)
|
||||||
```
|
```
|
||||||
|
|
||||||
When using `FetchContent`, `include(Catch)` will fail unless
|
When using `FetchContent`, `include(Catch)` will fail unless
|
||||||
|
@ -108,7 +108,7 @@ directory.
|
||||||
list(APPEND CMAKE_MODULE_PATH ${catch2_SOURCE_DIR}/extras)
|
list(APPEND CMAKE_MODULE_PATH ${catch2_SOURCE_DIR}/extras)
|
||||||
include(CTest)
|
include(CTest)
|
||||||
include(Catch)
|
include(Catch)
|
||||||
catch_discover_tests()
|
catch_discover_tests(tests)
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Customization
|
#### Customization
|
||||||
|
@ -126,6 +126,7 @@ catch_discover_tests(target
|
||||||
[OUTPUT_DIR dir]
|
[OUTPUT_DIR dir]
|
||||||
[OUTPUT_PREFIX prefix]
|
[OUTPUT_PREFIX prefix]
|
||||||
[OUTPUT_SUFFIX suffix]
|
[OUTPUT_SUFFIX suffix]
|
||||||
|
[DISCOVERY_MODE <POST_BUILD|PRE_TEST>]
|
||||||
)
|
)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
@ -198,6 +199,16 @@ If specified, `suffix` is added to each output file name, like so
|
||||||
`--out dir/<test_name>suffix`. This can be used to add a file extension to
|
`--out dir/<test_name>suffix`. This can be used to add a file extension to
|
||||||
the output file name e.g. ".xml".
|
the output file name e.g. ".xml".
|
||||||
|
|
||||||
|
* `DISCOVERY_MODE mode`
|
||||||
|
|
||||||
|
If specified allows control over when test discovery is performed.
|
||||||
|
For a value of `POST_BUILD` (default) test discovery is performed at build time.
|
||||||
|
For a value of `PRE_TEST` test discovery is delayed until just prior to test
|
||||||
|
execution (useful e.g. in cross-compilation environments).
|
||||||
|
``DISCOVERY_MODE`` defaults to the value of the
|
||||||
|
``CMAKE_CATCH_DISCOVER_TESTS_DISCOVERY_MODE`` variable if it is not passed when
|
||||||
|
calling ``catch_discover_tests``. This provides a mechanism for globally
|
||||||
|
selecting a preferred test discovery behavior.
|
||||||
|
|
||||||
### `ParseAndAddCatchTests.cmake`
|
### `ParseAndAddCatchTests.cmake`
|
||||||
|
|
||||||
|
@ -222,12 +233,12 @@ cmake_minimum_required(VERSION 3.5)
|
||||||
project(baz LANGUAGES CXX VERSION 0.0.1)
|
project(baz LANGUAGES CXX VERSION 0.0.1)
|
||||||
|
|
||||||
find_package(Catch2 REQUIRED)
|
find_package(Catch2 REQUIRED)
|
||||||
add_executable(foo test.cpp)
|
add_executable(tests test.cpp)
|
||||||
target_link_libraries(foo PRIVATE Catch2::Catch2)
|
target_link_libraries(tests PRIVATE Catch2::Catch2)
|
||||||
|
|
||||||
include(CTest)
|
include(CTest)
|
||||||
include(ParseAndAddCatchTests)
|
include(ParseAndAddCatchTests)
|
||||||
ParseAndAddCatchTests(foo)
|
ParseAndAddCatchTests(tests)
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
128
externals/catch/docs/command-line.md
vendored
128
externals/catch/docs/command-line.md
vendored
|
@ -85,43 +85,102 @@ Click one of the following links to take you straight to that option - or scroll
|
||||||
|
|
||||||
<pre><test-spec> ...</pre>
|
<pre><test-spec> ...</pre>
|
||||||
|
|
||||||
Test cases, wildcarded test cases, tags and tag expressions are all passed directly as arguments. Tags are distinguished by being enclosed in square brackets.
|
By providing a test spec, you filter which tests will be run. If you call
|
||||||
|
Catch2 without any test spec, then it will run all non-hidden test
|
||||||
|
cases. A test case is hidden if it has the `[!benchmark]` tag, any tag
|
||||||
|
with a dot at the start, e.g. `[.]` or `[.foo]`.
|
||||||
|
|
||||||
If no test specs are supplied then all test cases, except "hidden" tests, are run.
|
There are three basic test specs that can then be combined into more
|
||||||
A test is hidden by giving it any tag starting with (or just) a period (```.```) - or, in the deprecated case, tagged ```[hide]``` or given name starting with `'./'`. To specify hidden tests from the command line ```[.]``` or ```[hide]``` can be used *regardless of how they were declared*.
|
complex specs:
|
||||||
|
|
||||||
Specs must be enclosed in quotes if they contain spaces. If they do not contain spaces the quotes are optional.
|
* Full test name, e.g. `"Test 1"`.
|
||||||
|
|
||||||
Wildcards consist of the `*` character at the beginning and/or end of test case names and can substitute for any number of any characters (including none).
|
This allows only test cases whose name is "Test 1".
|
||||||
|
|
||||||
Test specs are case insensitive.
|
* Wildcarded test name, e.g. `"*Test"`, or `"Test*"`, or `"*Test*"`.
|
||||||
|
|
||||||
If a spec is prefixed with `exclude:` or the `~` character then the pattern matches an exclusion. This means that tests matching the pattern are excluded from the set - even if a prior inclusion spec included them. Subsequent inclusion specs will take precedence, however.
|
This allows any test case whose name ends with, starts with, or contains
|
||||||
Inclusions and exclusions are evaluated in left-to-right order.
|
in the middle the string "Test". Note that the wildcard can only be at
|
||||||
|
the start or end.
|
||||||
|
|
||||||
Test case examples:
|
* Tag name, e.g. `[some-tag]`.
|
||||||
|
|
||||||
|
This allows any test case tagged with "[some-tag]". Remember that some
|
||||||
|
tags are special, e.g. those that start with "." or with "!".
|
||||||
|
|
||||||
|
|
||||||
|
You can also combine the basic test specs to create more complex test
|
||||||
|
specs. You can:
|
||||||
|
|
||||||
|
* Concatenate specs to apply all of them, e.g. `[some-tag][other-tag]`.
|
||||||
|
|
||||||
|
This allows test cases that are tagged with **both** "[some-tag]" **and**
|
||||||
|
"[other-tag]". A test case with just "[some-tag]" will not pass the filter,
|
||||||
|
nor will test case with just "[other-tag]".
|
||||||
|
|
||||||
|
* Comma-join specs to apply any of them, e.g. `[some-tag],[other-tag]`.
|
||||||
|
|
||||||
|
This allows test cases that are tagged with **either** "[some-tag]" **or**
|
||||||
|
"[other-tag]". A test case with both will obviously also pass the filter.
|
||||||
|
|
||||||
|
Note that commas take precendence over simple concatenation. This means
|
||||||
|
that `[a][b],[c]` accepts tests that are tagged with either both "[a]" and
|
||||||
|
"[b]", or tests that are tagged with just "[c]".
|
||||||
|
|
||||||
|
* Negate the spec by prepending it with `~`, e.g. `~[some-tag]`.
|
||||||
|
|
||||||
|
This rejects any test case that is tagged with "[some-tag]". Note that
|
||||||
|
rejection takes precedence over other filters.
|
||||||
|
|
||||||
|
Note that negations always binds to the following _basic_ test spec.
|
||||||
|
This means that `~[foo][bar]` negates only the "[foo]" tag and not the
|
||||||
|
"[bar]" tag.
|
||||||
|
|
||||||
|
Note that when Catch2 is deciding whether to include a test, first it
|
||||||
|
checks whether the test matches any negative filters. If it does,
|
||||||
|
the test is rejected. After that, the behaviour depends on whether there
|
||||||
|
are positive filters as well. If there are no positive filters, all
|
||||||
|
remaining non-hidden tests are included. If there are positive filters,
|
||||||
|
only tests that match the positive filters are included.
|
||||||
|
|
||||||
|
You can also match test names with special characters by escaping them
|
||||||
|
with a backslash (`"\"`), e.g. a test named `"Do A, then B"` is matched
|
||||||
|
by "Do A\, then B" test spec. Backslash also escapes itself.
|
||||||
|
|
||||||
|
|
||||||
|
### Examples
|
||||||
|
|
||||||
|
Given these TEST_CASEs,
|
||||||
```
|
```
|
||||||
thisTestOnly Matches the test case called, 'thisTestOnly'
|
TEST_CASE("Test 1") {}
|
||||||
"this test only" Matches the test case called, 'this test only'
|
|
||||||
these* Matches all cases starting with 'these'
|
TEST_CASE("Test 2", "[.foo]") {}
|
||||||
exclude:notThis Matches all tests except, 'notThis'
|
|
||||||
~notThis Matches all tests except, 'notThis'
|
TEST_CASE("Test 3", "[.bar]") {}
|
||||||
~*private* Matches all tests except those that contain 'private'
|
|
||||||
a* ~ab* abc Matches all tests that start with 'a', except those that
|
TEST_CASE("Test 4", "[.][foo][bar]") {}
|
||||||
start with 'ab', except 'abc', which is included
|
|
||||||
~[tag1] Matches all tests except those tagged with '[tag1]'
|
|
||||||
-# [#somefile] Matches all tests from the file 'somefile.cpp'
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Names within square brackets are interpreted as tags.
|
this is the result of these filters
|
||||||
A series of tags form an AND expression whereas a comma-separated sequence forms an OR expression. e.g.:
|
```
|
||||||
|
./tests # Selects only the first test, others are hidden
|
||||||
|
./tests "Test 1" # Selects only the first test, other do not match
|
||||||
|
./tests ~"Test 1" # Selects no tests. Test 1 is rejected, other tests are hidden
|
||||||
|
./tests "Test *" # Selects all tests.
|
||||||
|
./tests [bar] # Selects tests 3 and 4. Other tests are not tagged [bar]
|
||||||
|
./tests ~[foo] # Selects test 1, because it is the only non-hidden test without [foo] tag
|
||||||
|
./tests [foo][bar] # Selects test 4.
|
||||||
|
./tests [foo],[bar] # Selects tests 2, 3, 4.
|
||||||
|
./tests ~[foo][bar] # Selects test 3. 2 and 4 are rejected due to having [foo] tag
|
||||||
|
./tests ~"Test 2"[foo] # Selects test 4, because test 2 is explicitly rejected
|
||||||
|
./tests [foo][bar],"Test 1" # Selects tests 1 and 4.
|
||||||
|
./tests "Test 1*" # Selects test 1, wildcard can match zero characters
|
||||||
|
```
|
||||||
|
|
||||||
<pre>[one][two],[three]</pre>
|
_Note: Using plain asterisk on a command line can cause issues with shell
|
||||||
This matches all tests tagged `[one]` and `[two]`, as well as all tests tagged `[three]`
|
expansion. Make sure that the asterisk is passed to Catch2 and is not
|
||||||
|
interpreted by the shell._
|
||||||
|
|
||||||
Test names containing special characters, such as `,` or `[` can specify them on the command line using `\`.
|
|
||||||
`\` also escapes itself.
|
|
||||||
|
|
||||||
<a id="choosing-a-reporter-to-use"></a>
|
<a id="choosing-a-reporter-to-use"></a>
|
||||||
## Choosing a reporter to use
|
## Choosing a reporter to use
|
||||||
|
@ -148,7 +207,7 @@ validity, and throw an error if they are wrong._
|
||||||
> Support for passing arguments to reporters through the `-r`, `--reporter` flag was introduced in Catch2 3.0.1
|
> Support for passing arguments to reporters through the `-r`, `--reporter` flag was introduced in Catch2 3.0.1
|
||||||
|
|
||||||
There are multiple built-in reporters, you can see what they do by using the
|
There are multiple built-in reporters, you can see what they do by using the
|
||||||
[`--list-reporter`](command-line.md#listing-available-tests-tags-or-reporters)
|
[`--list-reporters`](command-line.md#listing-available-tests-tags-or-reporters)
|
||||||
flag. If you need a reporter providing custom format outside of the already
|
flag. If you need a reporter providing custom format outside of the already
|
||||||
provided ones, look at the ["write your own reporter" part of the reporter
|
provided ones, look at the ["write your own reporter" part of the reporter
|
||||||
documentation](reporters.md#writing-your-own-reporter).
|
documentation](reporters.md#writing-your-own-reporter).
|
||||||
|
@ -507,10 +566,13 @@ start of the first section.</br>
|
||||||
## Filenames as tags
|
## Filenames as tags
|
||||||
<pre>-#, --filenames-as-tags</pre>
|
<pre>-#, --filenames-as-tags</pre>
|
||||||
|
|
||||||
When this option is used then every test is given an additional tag which is formed of the unqualified
|
This option adds an extra tag to all test cases. The tag is `#` followed
|
||||||
filename it is found in, with any extension stripped, prefixed with the `#` character.
|
by the unqualified filename the test case is defined in, with the _last_
|
||||||
|
extension stripped out.
|
||||||
|
|
||||||
|
For example, tests within the file `tests\SelfTest\UsageTests\BDD.tests.cpp`
|
||||||
|
will be given the `[#BDD.tests]` tag.
|
||||||
|
|
||||||
So, for example, tests within the file `~\Dev\MyProject\Ferrets.cpp` would be tagged `[#Ferrets]`.
|
|
||||||
|
|
||||||
<a id="colour-mode"></a>
|
<a id="colour-mode"></a>
|
||||||
## Override output colouring
|
## Override output colouring
|
||||||
|
@ -561,10 +623,10 @@ processes, as is done with the [Bazel test sharding](https://docs.bazel.build/ve
|
||||||
|
|
||||||
> Introduced in Catch2 3.0.1.
|
> Introduced in Catch2 3.0.1.
|
||||||
|
|
||||||
By default, Catch2 test binaries return non-0 exit code if no tests were
|
By default, Catch2 test binaries return non-0 exit code if no tests were run,
|
||||||
run, e.g. if the binary was compiled with no tests, or the provided test
|
e.g. if the binary was compiled with no tests, the provided test spec matched no
|
||||||
spec matched no tests. This flag overrides that, so a test run with no
|
tests, or all tests [were skipped at runtime](skipping-passing-failing.md#top). This flag
|
||||||
tests still returns 0.
|
overrides that, so a test run with no tests still returns 0.
|
||||||
|
|
||||||
## Output verbosity
|
## Output verbosity
|
||||||
```
|
```
|
||||||
|
|
29
externals/catch/docs/configuration.md
vendored
29
externals/catch/docs/configuration.md
vendored
|
@ -15,6 +15,7 @@
|
||||||
[Enabling stringification](#enabling-stringification)<br>
|
[Enabling stringification](#enabling-stringification)<br>
|
||||||
[Disabling exceptions](#disabling-exceptions)<br>
|
[Disabling exceptions](#disabling-exceptions)<br>
|
||||||
[Overriding Catch's debug break (`-b`)](#overriding-catchs-debug-break--b)<br>
|
[Overriding Catch's debug break (`-b`)](#overriding-catchs-debug-break--b)<br>
|
||||||
|
[Static analysis support](#static-analysis-support)<br>
|
||||||
|
|
||||||
Catch2 is designed to "just work" as much as possible, and most of the
|
Catch2 is designed to "just work" as much as possible, and most of the
|
||||||
configuration options below are changed automatically during compilation,
|
configuration options below are changed automatically during compilation,
|
||||||
|
@ -25,7 +26,8 @@ with the same name.
|
||||||
|
|
||||||
## Prefixing Catch macros
|
## Prefixing Catch macros
|
||||||
|
|
||||||
CATCH_CONFIG_PREFIX_ALL
|
CATCH_CONFIG_PREFIX_ALL // Prefix all macros with CATCH_
|
||||||
|
CATCH_CONFIG_PREFIX_MESSAGES // Prefix only INFO, UNSCOPED_INFO, WARN and CAPTURE
|
||||||
|
|
||||||
To keep test code clean and uncluttered Catch uses short macro names (e.g. ```TEST_CASE``` and ```REQUIRE```). Occasionally these may conflict with identifiers from platform headers or the system under test. In this case the above identifier can be defined. This will cause all the Catch user macros to be prefixed with ```CATCH_``` (e.g. ```CATCH_TEST_CASE``` and ```CATCH_REQUIRE```).
|
To keep test code clean and uncluttered Catch uses short macro names (e.g. ```TEST_CASE``` and ```REQUIRE```). Occasionally these may conflict with identifiers from platform headers or the system under test. In this case the above identifier can be defined. This will cause all the Catch user macros to be prefixed with ```CATCH_``` (e.g. ```CATCH_TEST_CASE``` and ```CATCH_REQUIRE```).
|
||||||
|
|
||||||
|
@ -264,6 +266,31 @@ The macro will be used as is, that is, `CATCH_BREAK_INTO_DEBUGGER();`
|
||||||
must compile and must break into debugger.
|
must compile and must break into debugger.
|
||||||
|
|
||||||
|
|
||||||
|
## Static analysis support
|
||||||
|
|
||||||
|
> Introduced in Catch2 3.4.0.
|
||||||
|
|
||||||
|
Some parts of Catch2, e.g. `SECTION`s, can be hard for static analysis
|
||||||
|
tools to reason about. Catch2 can change its internals to help static
|
||||||
|
analysis tools reason about the tests.
|
||||||
|
|
||||||
|
Catch2 automatically detects some static analysis tools (initial
|
||||||
|
implementation checks for clang-tidy and Coverity), but you can override
|
||||||
|
its detection (in either direction) via
|
||||||
|
|
||||||
|
```
|
||||||
|
CATCH_CONFIG_EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT // force enables static analysis help
|
||||||
|
CATCH_CONFIG_NO_EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT // force disables static analysis help
|
||||||
|
```
|
||||||
|
|
||||||
|
_As the name suggests, this is currently experimental, and thus we provide
|
||||||
|
no backwards compatibility guarantees._
|
||||||
|
|
||||||
|
**DO NOT ENABLE THIS FOR BUILDS YOU INTEND TO RUN.** The changed internals
|
||||||
|
are not meant to be runnable, only "scannable".
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[Home](Readme.md#top)
|
[Home](Readme.md#top)
|
||||||
|
|
23
externals/catch/docs/contributing.md
vendored
23
externals/catch/docs/contributing.md
vendored
|
@ -55,6 +55,15 @@ tests from `SelfTest` through a specific reporter and then compare the
|
||||||
generated output with a known good output ("Baseline"). By default, new
|
generated output with a known good output ("Baseline"). By default, new
|
||||||
tests should be placed here.
|
tests should be placed here.
|
||||||
|
|
||||||
|
To configure a Catch2 build with just the basic tests, use the `basic-tests`
|
||||||
|
preset, like so:
|
||||||
|
|
||||||
|
```
|
||||||
|
# Assuming you are in Catch2's root folder
|
||||||
|
|
||||||
|
cmake -B basic-test-build -S . -DCMAKE_BUILD_TYPE=Debug --preset basic-tests
|
||||||
|
```
|
||||||
|
|
||||||
However, not all tests can be written as plain unit tests. For example,
|
However, not all tests can be written as plain unit tests. For example,
|
||||||
checking that Catch2 orders tests randomly when asked to, and that this
|
checking that Catch2 orders tests randomly when asked to, and that this
|
||||||
random ordering is subset-invariant, is better done as an integration
|
random ordering is subset-invariant, is better done as an integration
|
||||||
|
@ -76,21 +85,23 @@ configuration and require separate compilation.
|
||||||
Finally, CMake config tests test that you set Catch2's compile-time
|
Finally, CMake config tests test that you set Catch2's compile-time
|
||||||
configuration options through CMake, using CMake options of the same name.
|
configuration options through CMake, using CMake options of the same name.
|
||||||
|
|
||||||
None of these tests are enabled by default. To enable them, add
|
These test categories can be enabled one by one, by passing
|
||||||
`-DCATCH_BUILD_EXAMPLES=ON`, `-DCATCH_BUILD_EXTRA_TESTS=ON`, and
|
`-DCATCH_BUILD_EXAMPLES=ON`, `-DCATCH_BUILD_EXTRA_TESTS=ON`, and
|
||||||
`-DCATCH_ENABLE_CONFIGURE_TESTS=ON` when configuration the CMake build.
|
`-DCATCH_ENABLE_CONFIGURE_TESTS=ON` when configuring the build.
|
||||||
|
|
||||||
Bringing this all together, the steps below should configure, build,
|
Catch2 also provides a preset that promises to enable _all_ test types,
|
||||||
and run all tests in the `Debug` compilation.
|
`all-tests`.
|
||||||
|
|
||||||
|
The snippet below will build & run all tests, in `Debug` compilation mode.
|
||||||
|
|
||||||
<!-- snippet: catch2-build-and-test -->
|
<!-- snippet: catch2-build-and-test -->
|
||||||
<a id='snippet-catch2-build-and-test'></a>
|
<a id='snippet-catch2-build-and-test'></a>
|
||||||
```sh
|
```sh
|
||||||
# 1. Regenerate the amalgamated distribution
|
# 1. Regenerate the amalgamated distribution (some tests are built against it)
|
||||||
./tools/scripts/generateAmalgamatedFiles.py
|
./tools/scripts/generateAmalgamatedFiles.py
|
||||||
|
|
||||||
# 2. Configure the full test build
|
# 2. Configure the full test build
|
||||||
cmake -Bdebug-build -H. -DCMAKE_BUILD_TYPE=Debug -DCATCH_DEVELOPMENT_BUILD=ON -DCATCH_BUILD_EXAMPLES=ON -DCATCH_BUILD_EXTRA_TESTS=ON
|
cmake -B debug-build -S . -DCMAKE_BUILD_TYPE=Debug --preset all-tests
|
||||||
|
|
||||||
# 3. Run the actual build
|
# 3. Run the actual build
|
||||||
cmake --build debug-build
|
cmake --build debug-build
|
||||||
|
|
9
externals/catch/docs/deprecations.md
vendored
9
externals/catch/docs/deprecations.md
vendored
|
@ -26,6 +26,15 @@ to accurately probe the environment for this information so the flag
|
||||||
where it will export `BAZEL_TEST=1` for purposes like the above. Catch2
|
where it will export `BAZEL_TEST=1` for purposes like the above. Catch2
|
||||||
will now instead inspect the environment instead of relying on build configuration.
|
will now instead inspect the environment instead of relying on build configuration.
|
||||||
|
|
||||||
|
### `IEventLister::skipTest( TestCaseInfo const& testInfo )`
|
||||||
|
|
||||||
|
This event (including implementations in derived classes such as `ReporterBase`)
|
||||||
|
is deprecated and will be removed in the next major release. It is currently
|
||||||
|
invoked for all test cases that are not going to be executed due to the test run
|
||||||
|
being aborted (when using `--abort` or `--abortx`). It is however
|
||||||
|
**NOT** invoked for test cases that are [explicitly skipped using the `SKIP`
|
||||||
|
macro](skipping-passing-failing.md#top).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[Home](Readme.md#top)
|
[Home](Readme.md#top)
|
||||||
|
|
27
externals/catch/docs/faq.md
vendored
27
externals/catch/docs/faq.md
vendored
|
@ -10,6 +10,7 @@
|
||||||
[Does Catch2 support running tests in parallel?](#does-catch2-support-running-tests-in-parallel)<br>
|
[Does Catch2 support running tests in parallel?](#does-catch2-support-running-tests-in-parallel)<br>
|
||||||
[Can I compile Catch2 into a dynamic library?](#can-i-compile-catch2-into-a-dynamic-library)<br>
|
[Can I compile Catch2 into a dynamic library?](#can-i-compile-catch2-into-a-dynamic-library)<br>
|
||||||
[What repeatability guarantees does Catch2 provide?](#what-repeatability-guarantees-does-catch2-provide)<br>
|
[What repeatability guarantees does Catch2 provide?](#what-repeatability-guarantees-does-catch2-provide)<br>
|
||||||
|
[My build cannot find `catch2/catch_user_config.hpp`, how can I fix it?](#my-build-cannot-find-catch2catch_user_confighpp-how-can-i-fix-it)<br>
|
||||||
|
|
||||||
|
|
||||||
## How do I run global setup/teardown only if tests will be run?
|
## How do I run global setup/teardown only if tests will be run?
|
||||||
|
@ -28,7 +29,7 @@ depending on how often the cleanup needs to happen.
|
||||||
## Why cannot I derive from the built-in reporters?
|
## Why cannot I derive from the built-in reporters?
|
||||||
|
|
||||||
They are not made to be overridden, in that we do not attempt to maintain
|
They are not made to be overridden, in that we do not attempt to maintain
|
||||||
a consistent internal state if a member function is overriden, and by
|
a consistent internal state if a member function is overridden, and by
|
||||||
forbidding users from using them as a base class, we can refactor them
|
forbidding users from using them as a base class, we can refactor them
|
||||||
as needed later.
|
as needed later.
|
||||||
|
|
||||||
|
@ -83,12 +84,30 @@ and it is also generally repeatable across versions, but we might break
|
||||||
it from time to time. E.g. we broke repeatability with previous versions
|
it from time to time. E.g. we broke repeatability with previous versions
|
||||||
in v2.13.4 so that test cases with similar names are shuffled better.
|
in v2.13.4 so that test cases with similar names are shuffled better.
|
||||||
|
|
||||||
Random generators currently rely on platform's stdlib, specifically
|
Since Catch2 3.5.0 the random generators use custom distributions,
|
||||||
the distributions from `<random>`. We thus provide no extra guarantee
|
that should be repeatable across different platforms, with few caveats.
|
||||||
above what your platform does. **Important: `<random>`'s distributions
|
For details see the section on random generators in the [Generator
|
||||||
|
documentation](generators.md#random-number-generators-details).
|
||||||
|
|
||||||
|
Before this version, random generators relied on distributions from
|
||||||
|
platform's stdlib. We thus can provide no extra guarantee on top of the
|
||||||
|
ones given by your platform. **Important: `<random>`'s distributions
|
||||||
are not specified to be repeatable across different platforms.**
|
are not specified to be repeatable across different platforms.**
|
||||||
|
|
||||||
|
|
||||||
|
## My build cannot find `catch2/catch_user_config.hpp`, how can I fix it?
|
||||||
|
|
||||||
|
`catch2/catch_user_config.hpp` is a generated header that contains user
|
||||||
|
compile time configuration. It is generated by CMake/Meson/Bazel during
|
||||||
|
build. If you are not using either of these, your three options are to
|
||||||
|
|
||||||
|
1) Build Catch2 separately using build tool that will generate the header
|
||||||
|
2) Use the amalgamated files to build Catch2
|
||||||
|
3) Use CMake to configure a build. This will generate the header and you
|
||||||
|
can copy it into your own checkout of Catch2.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
[Home](Readme.md#top)
|
[Home](Readme.md#top)
|
||||||
|
|
51
externals/catch/docs/generators.md
vendored
51
externals/catch/docs/generators.md
vendored
|
@ -134,7 +134,7 @@ type, making their usage much nicer. These are
|
||||||
* `map<T>(func, GeneratorWrapper<U>&&)` for `MapGenerator<T, U, Func>` (map `U` to `T`)
|
* `map<T>(func, GeneratorWrapper<U>&&)` for `MapGenerator<T, U, Func>` (map `U` to `T`)
|
||||||
* `chunk(chunk-size, GeneratorWrapper<T>&&)` for `ChunkGenerator<T>`
|
* `chunk(chunk-size, GeneratorWrapper<T>&&)` for `ChunkGenerator<T>`
|
||||||
* `random(IntegerOrFloat a, IntegerOrFloat b)` for `RandomIntegerGenerator` or `RandomFloatGenerator`
|
* `random(IntegerOrFloat a, IntegerOrFloat b)` for `RandomIntegerGenerator` or `RandomFloatGenerator`
|
||||||
* `range(Arithemtic start, Arithmetic end)` for `RangeGenerator<Arithmetic>` with a step size of `1`
|
* `range(Arithmetic start, Arithmetic end)` for `RangeGenerator<Arithmetic>` with a step size of `1`
|
||||||
* `range(Arithmetic start, Arithmetic end, Arithmetic step)` for `RangeGenerator<Arithmetic>` with a custom step size
|
* `range(Arithmetic start, Arithmetic end, Arithmetic step)` for `RangeGenerator<Arithmetic>` with a custom step size
|
||||||
* `from_range(InputIterator from, InputIterator to)` for `IteratorGenerator<T>`
|
* `from_range(InputIterator from, InputIterator to)` for `IteratorGenerator<T>`
|
||||||
* `from_range(Container const&)` for `IteratorGenerator<T>`
|
* `from_range(Container const&)` for `IteratorGenerator<T>`
|
||||||
|
@ -189,6 +189,31 @@ TEST_CASE("type conversion", "[generators]") {
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
### Random number generators: details
|
||||||
|
|
||||||
|
> This section applies from Catch2 3.5.0. Before that, random generators
|
||||||
|
> were a thin wrapper around distributions from `<random>`.
|
||||||
|
|
||||||
|
All of the `random(a, b)` generators in Catch2 currently generate uniformly
|
||||||
|
distributed number in closed interval \[a; b\]. This is different from
|
||||||
|
`std::uniform_real_distribution`, which should return numbers in interval
|
||||||
|
\[a; b) (but due to rounding can end up returning b anyway), but the
|
||||||
|
difference is intentional, so that `random(a, a)` makes sense. If there is
|
||||||
|
enough interest from users, we can provide API to pick any of CC, CO, OC,
|
||||||
|
or OO ranges.
|
||||||
|
|
||||||
|
Unlike `std::uniform_int_distribution`, Catch2's generators also support
|
||||||
|
various single-byte integral types, such as `char` or `bool`.
|
||||||
|
|
||||||
|
Given the same seed, the output from the integral generators is
|
||||||
|
reproducible across different platforms. For floating point generators,
|
||||||
|
we only promise reproducibility on platforms that obey the IEEE 754
|
||||||
|
standard, and where `float` is 4 bytes and `double` is 8 bytes. We provide
|
||||||
|
no guarantees for `long double`, as the internals of `long double` can
|
||||||
|
vary wildly across different platforms.
|
||||||
|
|
||||||
|
|
||||||
## Generator interface
|
## Generator interface
|
||||||
|
|
||||||
You can also implement your own generators, by deriving from the
|
You can also implement your own generators, by deriving from the
|
||||||
|
@ -205,15 +230,37 @@ struct IGenerator : GeneratorUntypedBase {
|
||||||
// Precondition:
|
// Precondition:
|
||||||
// The generator is either freshly constructed or the last call to next() returned true
|
// The generator is either freshly constructed or the last call to next() returned true
|
||||||
virtual T const& get() const = 0;
|
virtual T const& get() const = 0;
|
||||||
|
|
||||||
|
// Returns user-friendly string showing the current generator element
|
||||||
|
// Does not have to be overridden, IGenerator provides default implementation
|
||||||
|
virtual std::string stringifyImpl() const;
|
||||||
};
|
};
|
||||||
```
|
```
|
||||||
|
|
||||||
However, to be able to use your custom generator inside `GENERATE`, it
|
However, to be able to use your custom generator inside `GENERATE`, it
|
||||||
will need to be wrapped inside a `GeneratorWrapper<T>`.
|
will need to be wrapped inside a `GeneratorWrapper<T>`.
|
||||||
`GeneratorWrapper<T>` is a value wrapper around a
|
`GeneratorWrapper<T>` is a value wrapper around a
|
||||||
`std::unique_ptr<IGenerator<T>>`.
|
`Catch::Detail::unique_ptr<IGenerator<T>>`.
|
||||||
|
|
||||||
For full example of implementing your own generator, look into Catch2's
|
For full example of implementing your own generator, look into Catch2's
|
||||||
examples, specifically
|
examples, specifically
|
||||||
[Generators: Create your own generator](../examples/300-Gen-OwnGenerator.cpp).
|
[Generators: Create your own generator](../examples/300-Gen-OwnGenerator.cpp).
|
||||||
|
|
||||||
|
|
||||||
|
### Handling empty generators
|
||||||
|
|
||||||
|
The generator interface assumes that a generator always has at least one
|
||||||
|
element. This is not always true, e.g. if the generator depends on an external
|
||||||
|
datafile, the file might be missing.
|
||||||
|
|
||||||
|
There are two ways to handle this, depending on whether you want this
|
||||||
|
to be an error or not.
|
||||||
|
|
||||||
|
* If empty generator **is** an error, throw an exception in constructor.
|
||||||
|
* If empty generator **is not** an error, use the [`SKIP`](skipping-passing-failing.md#skipping-test-cases-at-runtime) in constructor.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
[Home](Readme.md#top)
|
||||||
|
|
16
externals/catch/docs/limitations.md
vendored
16
externals/catch/docs/limitations.md
vendored
|
@ -88,8 +88,8 @@ because only one thread passes the `REQUIRE` macro and this is not
|
||||||
REQUIRE(cnt == 16);
|
REQUIRE(cnt == 16);
|
||||||
```
|
```
|
||||||
|
|
||||||
Because C++11 provides the necessary tools to do this, we are planning
|
We currently do not plan to support thread-safe assertions.
|
||||||
to remove this limitation in the future.
|
|
||||||
|
|
||||||
### Process isolation in a test
|
### Process isolation in a test
|
||||||
Catch does not support running tests in isolated (forked) processes. While this might in the future, the fact that Windows does not support forking and only allows full-on process creation and the desire to keep code as similar as possible across platforms, mean that this is likely to take significant development time, that is not currently available.
|
Catch does not support running tests in isolated (forked) processes. While this might in the future, the fact that Windows does not support forking and only allows full-on process creation and the desire to keep code as similar as possible across platforms, mean that this is likely to take significant development time, that is not currently available.
|
||||||
|
@ -155,7 +155,7 @@ with expansion:
|
||||||
|
|
||||||
|
|
||||||
### Clang/G++ -- skipping leaf sections after an exception
|
### Clang/G++ -- skipping leaf sections after an exception
|
||||||
Some versions of `libc++` and `libstdc++` (or their runtimes) have a bug with `std::uncaught_exception()` getting stuck returning `true` after rethrow, even if there are no active exceptions. One such case is this snippet, which skipped the sections "a" and "b", when compiled against `libcxxrt` from master
|
Some versions of `libc++` and `libstdc++` (or their runtimes) have a bug with `std::uncaught_exception()` getting stuck returning `true` after rethrow, even if there are no active exceptions. One such case is this snippet, which skipped the sections "a" and "b", when compiled against `libcxxrt` from the master branch
|
||||||
```cpp
|
```cpp
|
||||||
#include <catch2/catch_test_macros.hpp>
|
#include <catch2/catch_test_macros.hpp>
|
||||||
|
|
||||||
|
@ -173,13 +173,3 @@ TEST_CASE("b") {
|
||||||
|
|
||||||
If you are seeing a problem like this, i.e. weird test paths that trigger only under Clang with `libc++`, or only under very specific version of `libstdc++`, it is very likely you are seeing this. The only known workaround is to use a fixed version of your standard library.
|
If you are seeing a problem like this, i.e. weird test paths that trigger only under Clang with `libc++`, or only under very specific version of `libstdc++`, it is very likely you are seeing this. The only known workaround is to use a fixed version of your standard library.
|
||||||
|
|
||||||
|
|
||||||
### libstdc++, `_GLIBCXX_DEBUG` macro and random ordering of tests
|
|
||||||
|
|
||||||
Running a Catch2 binary compiled against libstdc++ with `_GLIBCXX_DEBUG`
|
|
||||||
macro defined with `--order rand` will cause a debug check to trigger and
|
|
||||||
abort the run due to self-assignment.
|
|
||||||
[This is a known bug inside libstdc++](https://stackoverflow.com/questions/22915325/avoiding-self-assignment-in-stdshuffle/23691322)
|
|
||||||
|
|
||||||
Workaround: Don't use `--order rand` when compiling against debug-enabled
|
|
||||||
libstdc++.
|
|
||||||
|
|
62
externals/catch/docs/matchers.md
vendored
62
externals/catch/docs/matchers.md
vendored
|
@ -141,18 +141,27 @@ are a permutation of the ones in `some_vec`.
|
||||||
|
|
||||||
### Floating point matchers
|
### Floating point matchers
|
||||||
|
|
||||||
Catch2 provides 3 matchers that target floating point numbers. These
|
Catch2 provides 4 matchers that target floating point numbers. These
|
||||||
are:
|
are:
|
||||||
|
|
||||||
* `WithinAbs(double target, double margin)`,
|
* `WithinAbs(double target, double margin)`,
|
||||||
* `WithinULP(FloatingPoint target, uint64_t maxUlpDiff)`, and
|
* `WithinULP(FloatingPoint target, uint64_t maxUlpDiff)`, and
|
||||||
* `WithinRel(FloatingPoint target, FloatingPoint eps)`.
|
* `WithinRel(FloatingPoint target, FloatingPoint eps)`.
|
||||||
|
* `IsNaN()`
|
||||||
|
|
||||||
> `WithinRel` matcher was introduced in Catch2 2.10.0
|
> `WithinRel` matcher was introduced in Catch2 2.10.0
|
||||||
|
|
||||||
For more details, read [the docs on comparing floating point
|
> `IsNaN` matcher was introduced in Catch2 3.3.2.
|
||||||
|
|
||||||
|
The first three serve to compare two floating pointe numbers. For more
|
||||||
|
details about how they work, read [the docs on comparing floating point
|
||||||
numbers](comparing-floating-point-numbers.md#floating-point-matchers).
|
numbers](comparing-floating-point-numbers.md#floating-point-matchers).
|
||||||
|
|
||||||
|
`IsNaN` then does exactly what it says on the tin. It matches the input
|
||||||
|
if it is a NaN (Not a Number). The advantage of using it over just plain
|
||||||
|
`REQUIRE(std::isnan(x))`, is that if the check fails, with `REQUIRE` you
|
||||||
|
won't see the value of `x`, but with `REQUIRE_THAT(x, IsNaN())`, you will.
|
||||||
|
|
||||||
|
|
||||||
### Miscellaneous matchers
|
### Miscellaneous matchers
|
||||||
|
|
||||||
|
@ -190,13 +199,23 @@ properties. The macro is `REQUIRE_THROWS_MATCHES(expr, ExceptionType, Matcher)`.
|
||||||
> `REQUIRE_THROWS_MATCHES` macro lives in `catch2/matchers/catch_matchers.hpp`
|
> `REQUIRE_THROWS_MATCHES` macro lives in `catch2/matchers/catch_matchers.hpp`
|
||||||
|
|
||||||
|
|
||||||
Catch2 currently provides only one matcher for exceptions,
|
Catch2 currently provides two matchers for exceptions.
|
||||||
`Message(std::string message)`. `Message` checks that the exception's
|
These are:
|
||||||
|
* `Message(std::string message)`.
|
||||||
|
* `MessageMatches(Matcher matcher)`.
|
||||||
|
|
||||||
|
> `MessageMatches` was [introduced](https://github.com/catchorg/Catch2/pull/2570) in Catch2 3.3.0
|
||||||
|
|
||||||
|
`Message` checks that the exception's
|
||||||
message, as returned from `what` is exactly equal to `message`.
|
message, as returned from `what` is exactly equal to `message`.
|
||||||
|
|
||||||
|
`MessageMatches` applies the provided matcher on the exception's
|
||||||
|
message, as returned from `what`. This is useful in conjunctions with the `std::string` matchers (e.g. `StartsWith`)
|
||||||
|
|
||||||
Example use:
|
Example use:
|
||||||
```cpp
|
```cpp
|
||||||
REQUIRE_THROWS_MATCHES(throwsDerivedException(), DerivedException, Message("DerivedException::what"));
|
REQUIRE_THROWS_MATCHES(throwsDerivedException(), DerivedException, Message("DerivedException::what"));
|
||||||
|
REQUIRE_THROWS_MATCHES(throwsDerivedException(), DerivedException, MessageMatches(StartsWith("DerivedException")));
|
||||||
```
|
```
|
||||||
|
|
||||||
Note that `DerivedException` in the example above has to derive from
|
Note that `DerivedException` in the example above has to derive from
|
||||||
|
@ -218,11 +237,19 @@ definitions to handle generic range-like types. These are:
|
||||||
* `Contains(T&& target_element, Comparator = std::equal_to<>{})`
|
* `Contains(T&& target_element, Comparator = std::equal_to<>{})`
|
||||||
* `Contains(Matcher element_matcher)`
|
* `Contains(Matcher element_matcher)`
|
||||||
* `AllMatch(Matcher element_matcher)`
|
* `AllMatch(Matcher element_matcher)`
|
||||||
* `NoneMatch(Matcher element_matcher)`
|
|
||||||
* `AnyMatch(Matcher element_matcher)`
|
* `AnyMatch(Matcher element_matcher)`
|
||||||
* `AllTrue()`
|
* `NoneMatch(Matcher element_matcher)`
|
||||||
* `NoneTrue()`
|
* `AllTrue()`, `AnyTrue()`, `NoneTrue()`
|
||||||
* `AnyTrue()`
|
* `RangeEquals(TargetRangeLike&&, Comparator = std::equal_to<>{})`
|
||||||
|
* `UnorderedRangeEquals(TargetRangeLike&&, Comparator = std::equal_to<>{})`
|
||||||
|
|
||||||
|
> `IsEmpty`, `SizeIs`, `Contains` were introduced in Catch2 3.0.1
|
||||||
|
|
||||||
|
> `All/Any/NoneMatch` were introduced in Catch2 3.0.1
|
||||||
|
|
||||||
|
> `All/Any/NoneTrue` were introduced in Catch2 3.1.0
|
||||||
|
|
||||||
|
> `RangeEquals` and `UnorderedRangeEquals` matchers were [introduced](https://github.com/catchorg/Catch2/pull/2377) in Catch2 3.3.0
|
||||||
|
|
||||||
`IsEmpty` should be self-explanatory. It successfully matches objects
|
`IsEmpty` should be self-explanatory. It successfully matches objects
|
||||||
that are empty according to either `std::empty`, or ADL-found `empty`
|
that are empty according to either `std::empty`, or ADL-found `empty`
|
||||||
|
@ -249,6 +276,25 @@ all, none, or any of the contained elements are `true`, respectively.
|
||||||
It works for ranges of `bool`s and ranges of elements (explicitly)
|
It works for ranges of `bool`s and ranges of elements (explicitly)
|
||||||
convertible to `bool`.
|
convertible to `bool`.
|
||||||
|
|
||||||
|
`RangeEquals` compares the range that the matcher is constructed with
|
||||||
|
(the "target range") against the range to be tested, element-wise. The
|
||||||
|
match succeeds if all elements from the two ranges compare equal (using
|
||||||
|
`operator==` by default). The ranges do not need to be the same type,
|
||||||
|
and the element types do not need to be the same, as long as they are
|
||||||
|
comparable. (e.g. you may compare `std::vector<int>` to `std::array<char>`).
|
||||||
|
|
||||||
|
`UnorderedRangeEquals` is similar to `RangeEquals`, but the order
|
||||||
|
does not matter. For example "1, 2, 3" would match "3, 2, 1", but not
|
||||||
|
"1, 1, 2, 3" As with `RangeEquals`, `UnorderedRangeEquals` compares
|
||||||
|
the individual elements using `operator==` by default.
|
||||||
|
|
||||||
|
Both `RangeEquals` and `UnorderedRangeEquals` optionally accept a
|
||||||
|
predicate which can be used to compare the containers element-wise.
|
||||||
|
|
||||||
|
To check a container elementwise against a given matcher, use
|
||||||
|
`AllMatch`.
|
||||||
|
|
||||||
|
|
||||||
## Writing custom matchers (old style)
|
## Writing custom matchers (old style)
|
||||||
|
|
||||||
The old style of writing matchers has been introduced back in Catch
|
The old style of writing matchers has been introduced back in Catch
|
||||||
|
|
11
externals/catch/docs/opensource-users.md
vendored
11
externals/catch/docs/opensource-users.md
vendored
|
@ -95,6 +95,9 @@ A C++ client library for Consul. Consul is a distributed tool for discovering an
|
||||||
### [Reactive-Extensions/ RxCpp](https://github.com/Reactive-Extensions/RxCpp)
|
### [Reactive-Extensions/ RxCpp](https://github.com/Reactive-Extensions/RxCpp)
|
||||||
A library of algorithms for values-distributed-in-time.
|
A library of algorithms for values-distributed-in-time.
|
||||||
|
|
||||||
|
### [SFML](https://github.com/SFML/SFML)
|
||||||
|
Simple and Fast Multimedia Library.
|
||||||
|
|
||||||
### [SOCI](https://github.com/SOCI/soci)
|
### [SOCI](https://github.com/SOCI/soci)
|
||||||
The C++ Database Access Library.
|
The C++ Database Access Library.
|
||||||
|
|
||||||
|
@ -110,6 +113,12 @@ A header-only TOML parser and serializer for modern C++.
|
||||||
### [Trompeloeil](https://github.com/rollbear/trompeloeil)
|
### [Trompeloeil](https://github.com/rollbear/trompeloeil)
|
||||||
A thread-safe header-only mocking framework for C++14.
|
A thread-safe header-only mocking framework for C++14.
|
||||||
|
|
||||||
|
### [wxWidgets](https://www.wxwidgets.org/)
|
||||||
|
Cross-Platform C++ GUI Library.
|
||||||
|
|
||||||
|
### [xmlwrapp](https://github.com/vslavik/xmlwrapp)
|
||||||
|
C++ XML parsing library using libxml2.
|
||||||
|
|
||||||
## Applications & Tools
|
## Applications & Tools
|
||||||
|
|
||||||
### [App Mesh](https://github.com/laoshanxi/app-mesh)
|
### [App Mesh](https://github.com/laoshanxi/app-mesh)
|
||||||
|
@ -137,7 +146,7 @@ Newsbeuter is an open-source RSS/Atom feed reader for text terminals.
|
||||||
A 2D, Zombie, RPG game which is being made on our own engine.
|
A 2D, Zombie, RPG game which is being made on our own engine.
|
||||||
|
|
||||||
### [raspigcd](https://github.com/pantadeusz/raspigcd)
|
### [raspigcd](https://github.com/pantadeusz/raspigcd)
|
||||||
Low level CLI app and library for execution of GCODE on Raspberry Pi without any additional microcontrolers (just RPi + Stepsticks).
|
Low level CLI app and library for execution of GCODE on Raspberry Pi without any additional microcontrollers (just RPi + Stepsticks).
|
||||||
|
|
||||||
### [SpECTRE](https://github.com/sxs-collaboration/spectre)
|
### [SpECTRE](https://github.com/sxs-collaboration/spectre)
|
||||||
SpECTRE is a code for multi-scale, multi-physics problems in astrophysics and gravitational physics.
|
SpECTRE is a code for multi-scale, multi-physics problems in astrophysics and gravitational physics.
|
||||||
|
|
139
externals/catch/docs/release-notes.md
vendored
139
externals/catch/docs/release-notes.md
vendored
|
@ -2,6 +2,11 @@
|
||||||
|
|
||||||
# Release notes
|
# Release notes
|
||||||
**Contents**<br>
|
**Contents**<br>
|
||||||
|
[3.5.0](#350)<br>
|
||||||
|
[3.4.0](#340)<br>
|
||||||
|
[3.3.2](#332)<br>
|
||||||
|
[3.3.1](#331)<br>
|
||||||
|
[3.3.0](#330)<br>
|
||||||
[3.2.1](#321)<br>
|
[3.2.1](#321)<br>
|
||||||
[3.2.0](#320)<br>
|
[3.2.0](#320)<br>
|
||||||
[3.1.1](#311)<br>
|
[3.1.1](#311)<br>
|
||||||
|
@ -54,6 +59,130 @@
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## 3.5.0
|
||||||
|
|
||||||
|
### Improvements
|
||||||
|
* Introduced `CATCH_CONFIG_PREFIX_MESSAGES` to prefix only logging macros (#2544)
|
||||||
|
* This means `INFO`, `UNSCOPED_INFO`, `WARN` and `CAPTURE`.
|
||||||
|
* Section hints in static analysis mode are now `const`
|
||||||
|
* This prevents Clang-Tidy from complaining about `misc-const-correctness`.
|
||||||
|
* `from_range` generator supports C arrays and ranges that require ADL (#2737)
|
||||||
|
* Stringification support for `std::optional` now also includes `std::nullopt` (#2740)
|
||||||
|
* The Console reporter flushes output after writing benchmark runtime estimate.
|
||||||
|
* This means that you can immediately see for how long the benchmark is expected to run.
|
||||||
|
* Added workaround to enable compilation with ICC 19.1 (#2551, #2766)
|
||||||
|
* Compiling Catch2 for XBox should work out of the box (#2772)
|
||||||
|
* Catch2 should automatically disable getenv when compiled for XBox.
|
||||||
|
* Compiling Catch2 with exceptions disabled no longer triggers `Wunused-function` (#2726)
|
||||||
|
* **`random` Generators for integral types are now reproducible across different platforms**
|
||||||
|
* Unlike `<rando>`, Catch2's generators also support 1 byte integral types (`char`, `bool`, ...)
|
||||||
|
* **`random` Generators for `float` and `double` are now reproducible across different platforms**
|
||||||
|
* `long double` varies across different platforms too much to be reproducible
|
||||||
|
* This guarantee applies only to platforms with IEEE 754 floats.
|
||||||
|
|
||||||
|
### Fixes
|
||||||
|
* UDL declaration inside Catch2 are now strictly conforming to the standard
|
||||||
|
* `operator "" _a` is UB, `operator ""_a` is fine. Seriously.
|
||||||
|
* Fixed `CAPTURE` tests failing to compile in C++23 mode (#2744)
|
||||||
|
* Fixed missing include in `catch_message.hpp` (#2758)
|
||||||
|
* Fixed `CHECK_ELSE` suppressing failure from uncaught exceptions(#2723)
|
||||||
|
|
||||||
|
### Miscellaneous
|
||||||
|
* The documentation for specifying which tests to run through commandline has been completely rewritten (#2738)
|
||||||
|
* Fixed installation when building Catch2 with meson (#2722, #2742)
|
||||||
|
* Fixed `catch_discover_tests` when using custom reporter and `PRE_TEST` discovery mode (#2747)
|
||||||
|
* `catch_discover_tests` supports multi-config CMake generator in `PRE_TEST` discovery mode (#2739, #2746)
|
||||||
|
|
||||||
|
|
||||||
|
## 3.4.0
|
||||||
|
|
||||||
|
### Improvements
|
||||||
|
* `VectorEquals` supports elements that provide only `==` and not `!=` (#2648)
|
||||||
|
* Catch2 supports compiling with IAR compiler (#2651)
|
||||||
|
* Various small internal performance improvements
|
||||||
|
* Various small internal compilation time improvements
|
||||||
|
* XMLReporter now reports location info for INFO and WARN (#1251)
|
||||||
|
* This bumps up the xml format version to 3
|
||||||
|
* Documented that `SKIP` in generator constructor can be used to handle empty generator (#1593)
|
||||||
|
* Added experimental static analysis support to `TEST_CASE` and `SECTION` macros (#2681)
|
||||||
|
* The two macros are redefined in a way that helps the SA tools reason about the possible paths through a test case with sections.
|
||||||
|
* The support is controlled by the `CATCH_CONFIG_EXPERIMENTAL_STATIC_ANALYSIS_SUPPORT` option and autodetects clang-tidy and Coverity.
|
||||||
|
* `*_THROWS`, `*_THROWS_AS`, etc now suppress warning coming from `__attribute__((warn_unused_result))` on GCC (#2691)
|
||||||
|
* Unlike plain `[[nodiscard]]`, this warning is not silenced by void cast. WTF GCC?
|
||||||
|
|
||||||
|
### Fixes
|
||||||
|
* Fixed `assertionStarting` events being sent after the expr is evaluated (#2678)
|
||||||
|
* Errors in `TEST_CASE` tags are now reported nicely (#2650)
|
||||||
|
|
||||||
|
### Miscellaneous
|
||||||
|
* Bunch of improvements to `catch_discover_tests`
|
||||||
|
* Added DISCOVERY_MODE option, so the discovery can happen either post build or pre-run.
|
||||||
|
* Fixed handling of semicolons and backslashes in test names (#2674, #2676)
|
||||||
|
* meson build can disable building tests (#2693)
|
||||||
|
* meson build properly sets meson version 0.54.1 as the minimal supported version (#2688)
|
||||||
|
|
||||||
|
|
||||||
|
## 3.3.2
|
||||||
|
|
||||||
|
### Improvements
|
||||||
|
* Further reduced allocations
|
||||||
|
* The compact, console, TAP and XML reporters perform less allocations in various cases
|
||||||
|
* Removed 1 allocation per entered `SECTION`/`TEST_CASE`.
|
||||||
|
* Removed 2 allocations per test case exit, if stdout/stderr is captured
|
||||||
|
* Improved performance
|
||||||
|
* Section tracking is 10%-25% faster than in v3.3.0
|
||||||
|
* Assertion handling is 5%-10% faster than in v3.3.0
|
||||||
|
* Test case registration is 1%-2% faster than in v3.3.0
|
||||||
|
* Tiny speedup for registering listeners
|
||||||
|
* Tiny speedup for `CAPTURE`, `TEST_CASE_METHOD`, `METHOD_AS_TEST_CASE`, and `TEMPLATE_LIST_TEST_*` macros.
|
||||||
|
* `Contains`, `RangeEquals` and `UnorderedRangeEquals` matchers now support ranges with iterator + sentinel pair
|
||||||
|
* Added `IsNaN` matcher
|
||||||
|
* Unlike `REQUIRE(isnan(x))`, `REQUIRE_THAT(x, IsNaN())` shows you the value of `x`.
|
||||||
|
* Suppressed `declared_but_not_referenced` warning for NVHPC (#2637)
|
||||||
|
|
||||||
|
### Fixes
|
||||||
|
* Fixed performance regression in section tracking introduced in v3.3.1
|
||||||
|
* Extreme cases would cause the tracking to run about 4x slower than in 3.3.0
|
||||||
|
|
||||||
|
|
||||||
|
## 3.3.1
|
||||||
|
|
||||||
|
### Improvements
|
||||||
|
* Reduced allocations and improved performance
|
||||||
|
* The exact improvements are dependent on your usage of Catch2.
|
||||||
|
* For example running Catch2's SelfTest binary performs 8k less allocations.
|
||||||
|
* The main improvement comes from smarter handling of `SECTION`s, especially sibling `SECTION`s
|
||||||
|
|
||||||
|
|
||||||
|
## 3.3.0
|
||||||
|
|
||||||
|
### Improvements
|
||||||
|
|
||||||
|
* Added `MessageMatches` exception matcher (#2570)
|
||||||
|
* Added `RangeEquals` and `UnorderedRangeEquals` generic range matchers (#2377)
|
||||||
|
* Added `SKIP` macro for skipping tests from within the test body (#2360)
|
||||||
|
* All built-in reporters have been extended to handle it properly, whether your custom reporter needs changes depends on how it was written
|
||||||
|
* `skipTest` reporter event **is unrelated** to this, and has been deprecated since it has practically no uses
|
||||||
|
* Restored support for PPC Macs in the break-into-debugger functionality (#2619)
|
||||||
|
* Made our warning suppression compatible with CUDA toolkit pre 11.5 (#2626)
|
||||||
|
* Cleaned out some static analysis complaints
|
||||||
|
|
||||||
|
|
||||||
|
### Fixes
|
||||||
|
|
||||||
|
* Fixed macro redefinition warning when NVCC was reporting as MSVC (#2603)
|
||||||
|
* Fixed throws in generator constructor causing the whole binary to abort (#2615)
|
||||||
|
* Now it just fails the test
|
||||||
|
* Fixed missing transitive include with libstdc++13 (#2611)
|
||||||
|
|
||||||
|
|
||||||
|
### Miscellaneous
|
||||||
|
|
||||||
|
* Improved support for dynamic library build with non-MSVC compilers on Windows (#2630)
|
||||||
|
* When used as a subproject, Catch2 keeps its generated header in a separate directory from the main project (#2604)
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## 3.2.1
|
## 3.2.1
|
||||||
|
|
||||||
### Improvements
|
### Improvements
|
||||||
|
@ -85,7 +214,7 @@
|
||||||
|
|
||||||
### Fixes
|
### Fixes
|
||||||
* Cleaned out some warnings and static analysis issues
|
* Cleaned out some warnings and static analysis issues
|
||||||
* Suppressed `-Wcomma` warning rarely occuring in templated test cases (#2543)
|
* Suppressed `-Wcomma` warning rarely occurring in templated test cases (#2543)
|
||||||
* Constified implementation details in `INFO` (#2564)
|
* Constified implementation details in `INFO` (#2564)
|
||||||
* Made `MatcherGenericBase` copy constructor const (#2566)
|
* Made `MatcherGenericBase` copy constructor const (#2566)
|
||||||
* Fixed serialization of test filters so the output roundtrips
|
* Fixed serialization of test filters so the output roundtrips
|
||||||
|
@ -288,7 +417,7 @@ v3 releases.
|
||||||
* Added `STATIC_CHECK` macro, similar to `STATIC_REQUIRE` (#2318)
|
* Added `STATIC_CHECK` macro, similar to `STATIC_REQUIRE` (#2318)
|
||||||
* When deferred tu runtime, it behaves like `CHECK`, and not like `REQUIRE`.
|
* When deferred tu runtime, it behaves like `CHECK`, and not like `REQUIRE`.
|
||||||
* You can have multiple tests with the same name, as long as other parts of the test identity differ (#1915, #1999, #2175)
|
* You can have multiple tests with the same name, as long as other parts of the test identity differ (#1915, #1999, #2175)
|
||||||
* Test identity includes test's name, test's tags and and test's class name if applicable.
|
* Test identity includes test's name, test's tags and test's class name if applicable.
|
||||||
* Added new warning, `UnmatchedTestSpec`, to error on test specs with no matching tests
|
* Added new warning, `UnmatchedTestSpec`, to error on test specs with no matching tests
|
||||||
* The `-w`, `--warn` warning flags can now be provided multiple times to enable multiple warnings
|
* The `-w`, `--warn` warning flags can now be provided multiple times to enable multiple warnings
|
||||||
* The case-insensitive handling of tags is now more reliable and takes up less memory
|
* The case-insensitive handling of tags is now more reliable and takes up less memory
|
||||||
|
@ -453,7 +582,7 @@ v3 releases.
|
||||||
* The `SECTION`(s) before the `GENERATE` will not be run multiple times, the following ones will.
|
* The `SECTION`(s) before the `GENERATE` will not be run multiple times, the following ones will.
|
||||||
* Added `-D`/`--min-duration` command line flag (#1910)
|
* Added `-D`/`--min-duration` command line flag (#1910)
|
||||||
* If a test takes longer to finish than the provided value, its name and duration will be printed.
|
* If a test takes longer to finish than the provided value, its name and duration will be printed.
|
||||||
* This flag is overriden by setting `-d`/`--duration`.
|
* This flag is overridden by setting `-d`/`--duration`.
|
||||||
|
|
||||||
### Fixes
|
### Fixes
|
||||||
* `TAPReporter` no longer skips successful assertions (#1983)
|
* `TAPReporter` no longer skips successful assertions (#1983)
|
||||||
|
@ -521,7 +650,7 @@ v3 releases.
|
||||||
### Fixes
|
### Fixes
|
||||||
* Fixed computation of benchmarking column widths in ConsoleReporter (#1885, #1886)
|
* Fixed computation of benchmarking column widths in ConsoleReporter (#1885, #1886)
|
||||||
* Suppressed clang-tidy's `cppcoreguidelines-pro-type-vararg` in assertions (#1901)
|
* Suppressed clang-tidy's `cppcoreguidelines-pro-type-vararg` in assertions (#1901)
|
||||||
* It was a false positive trigered by the new warning support workaround
|
* It was a false positive triggered by the new warning support workaround
|
||||||
* Fixed bug in test specification parser handling of OR'd patterns using escaping (#1905)
|
* Fixed bug in test specification parser handling of OR'd patterns using escaping (#1905)
|
||||||
|
|
||||||
### Miscellaneous
|
### Miscellaneous
|
||||||
|
@ -858,7 +987,7 @@ v3 releases.
|
||||||
|
|
||||||
### Contrib
|
### Contrib
|
||||||
* `ParseAndAddCatchTests` has learned how to use `DISABLED` CTest property (#1452)
|
* `ParseAndAddCatchTests` has learned how to use `DISABLED` CTest property (#1452)
|
||||||
* `ParseAndAddCatchTests` now works when there is a whitspace before the test name (#1493)
|
* `ParseAndAddCatchTests` now works when there is a whitespace before the test name (#1493)
|
||||||
|
|
||||||
|
|
||||||
### Miscellaneous
|
### Miscellaneous
|
||||||
|
|
12
externals/catch/docs/reporter-events.md
vendored
12
externals/catch/docs/reporter-events.md
vendored
|
@ -96,12 +96,12 @@ void assertionStarting( AssertionInfo const& assertionInfo );
|
||||||
void assertionEnded( AssertionStats const& assertionStats );
|
void assertionEnded( AssertionStats const& assertionStats );
|
||||||
```
|
```
|
||||||
|
|
||||||
`assertionStarting` is called after the expression is captured, but before
|
The `assertionStarting` event is emitted before the expression in the
|
||||||
the assertion expression is evaluated. This might seem like a minor
|
assertion is captured or evaluated and `assertionEnded` is emitted
|
||||||
distinction, but what it means is that if you have assertion like
|
afterwards. This means that given assertion like `REQUIRE(a + b == c + d)`,
|
||||||
`REQUIRE( a + b == c + d )`, then what happens is that `a + b` and `c + d`
|
Catch2 first emits `assertionStarting` event, then `a + b` and `c + d`
|
||||||
are evaluated before `assertionStarting` is emitted, while the `==` is
|
are evaluated, then their results are captured, the comparison is evaluated,
|
||||||
evaluated after the event.
|
and then `assertionEnded` event is emitted.
|
||||||
|
|
||||||
|
|
||||||
## Benchmarking events
|
## Benchmarking events
|
||||||
|
|
2
externals/catch/docs/reporters.md
vendored
2
externals/catch/docs/reporters.md
vendored
|
@ -52,7 +52,7 @@ its machine-readable XML output to file `result-junit.xml`, and the
|
||||||
uses ANSI colour codes for colouring the output.
|
uses ANSI colour codes for colouring the output.
|
||||||
|
|
||||||
Using multiple reporters (or one reporter and one-or-more [event
|
Using multiple reporters (or one reporter and one-or-more [event
|
||||||
listeners](event-listener.md#top)) can have surprisingly complex semantics
|
listeners](event-listeners.md#top)) can have surprisingly complex semantics
|
||||||
when using customization points provided to reporters by Catch2, namely
|
when using customization points provided to reporters by Catch2, namely
|
||||||
capturing stdout/stderr from test cases.
|
capturing stdout/stderr from test cases.
|
||||||
|
|
||||||
|
|
135
externals/catch/docs/skipping-passing-failing.md
vendored
Normal file
135
externals/catch/docs/skipping-passing-failing.md
vendored
Normal file
|
@ -0,0 +1,135 @@
|
||||||
|
<a id="top"></a>
|
||||||
|
# Explicitly skipping, passing, and failing tests at runtime
|
||||||
|
|
||||||
|
## Skipping Test Cases at Runtime
|
||||||
|
|
||||||
|
> [Introduced](https://github.com/catchorg/Catch2/pull/2360) in Catch2 3.3.0.
|
||||||
|
|
||||||
|
In some situations it may not be possible to meaningfully execute a test case,
|
||||||
|
for example when the system under test is missing certain hardware capabilities.
|
||||||
|
If the required conditions can only be determined at runtime, it often
|
||||||
|
doesn't make sense to consider such a test case as either passed or failed,
|
||||||
|
because it simply cannot run at all.
|
||||||
|
|
||||||
|
To properly express such scenarios, Catch2 provides a way to explicitly
|
||||||
|
_skip_ test cases, using the `SKIP` macro:
|
||||||
|
|
||||||
|
```
|
||||||
|
SKIP( [streamable expression] )
|
||||||
|
```
|
||||||
|
|
||||||
|
Example usage:
|
||||||
|
|
||||||
|
```c++
|
||||||
|
TEST_CASE("copy files between drives") {
|
||||||
|
if(getNumberOfHardDrives() < 2) {
|
||||||
|
SKIP("at least two hard drives required");
|
||||||
|
}
|
||||||
|
// ...
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
This test case is then reported as _skipped_ instead of _passed_ or _failed_.
|
||||||
|
|
||||||
|
The `SKIP` macro behaves similarly to an explicit [`FAIL`](#passing-and-failing-test-cases),
|
||||||
|
in that it is the last expression that will be executed:
|
||||||
|
|
||||||
|
```c++
|
||||||
|
TEST_CASE("my test") {
|
||||||
|
printf("foo");
|
||||||
|
SKIP();
|
||||||
|
printf("bar"); // not printed
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
However a failed assertion _before_ a `SKIP` still causes the entire
|
||||||
|
test case to fail:
|
||||||
|
|
||||||
|
```c++
|
||||||
|
TEST_CASE("failing test") {
|
||||||
|
CHECK(1 == 2);
|
||||||
|
SKIP();
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### Interaction with Sections and Generators
|
||||||
|
|
||||||
|
Sections, nested sections as well as specific outputs from [generators](generators.md#top)
|
||||||
|
can all be individually skipped, with the rest executing as usual:
|
||||||
|
|
||||||
|
```c++
|
||||||
|
TEST_CASE("complex test case") {
|
||||||
|
int value = GENERATE(2, 4, 6);
|
||||||
|
SECTION("a") {
|
||||||
|
SECTION("a1") { CHECK(value < 8); }
|
||||||
|
SECTION("a2") {
|
||||||
|
if (value == 4) {
|
||||||
|
SKIP();
|
||||||
|
}
|
||||||
|
CHECK(value % 2 == 0);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
This test case will report 5 passing assertions; one for each of the three
|
||||||
|
values in section `a1`, and then two in section `a2`, from values 2 and 4.
|
||||||
|
|
||||||
|
Note that as soon as one section is skipped, the entire test case will
|
||||||
|
be reported as _skipped_ (unless there is a failing assertion, in which
|
||||||
|
case the test is handled as _failed_ instead).
|
||||||
|
|
||||||
|
Note that if all test cases in a run are skipped, Catch2 returns a non-zero
|
||||||
|
exit code, same as it does if no test cases have run. This behaviour can
|
||||||
|
be overridden using the [--allow-running-no-tests](command-line.md#no-tests-override)
|
||||||
|
flag.
|
||||||
|
|
||||||
|
### `SKIP` inside generators
|
||||||
|
|
||||||
|
You can also use the `SKIP` macro inside generator's constructor to handle
|
||||||
|
cases where the generator is empty, but you do not want to fail the test
|
||||||
|
case.
|
||||||
|
|
||||||
|
|
||||||
|
## Passing and failing test cases
|
||||||
|
|
||||||
|
Test cases can also be explicitly passed or failed, without the use of
|
||||||
|
assertions, and with a specific message. This can be useful to handle
|
||||||
|
complex preconditions/postconditions and give useful error messages
|
||||||
|
when they fail.
|
||||||
|
|
||||||
|
* `SUCCEED( [streamable expression] )`
|
||||||
|
|
||||||
|
`SUCCEED` is morally equivalent with `INFO( [streamable expression] ); REQUIRE( true );`.
|
||||||
|
Note that it does not stop further test execution, so it cannot be used
|
||||||
|
to guard failing assertions from being executed.
|
||||||
|
|
||||||
|
_In practice, `SUCCEED` is usually used as a test placeholder, to avoid
|
||||||
|
[failing a test case due to missing assertions](command-line.md#warnings)._
|
||||||
|
|
||||||
|
```cpp
|
||||||
|
TEST_CASE( "SUCCEED showcase" ) {
|
||||||
|
int I = 1;
|
||||||
|
SUCCEED( "I is " << I );
|
||||||
|
// ... execution continues here ...
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
* `FAIL( [streamable expression] )`
|
||||||
|
|
||||||
|
`FAIL` is morally equivalent with `INFO( [streamable expression] ); REQUIRE( false );`.
|
||||||
|
|
||||||
|
_In practice, `FAIL` is usually used to stop executing test that is currently
|
||||||
|
known to be broken, but has to be fixed later._
|
||||||
|
|
||||||
|
```cpp
|
||||||
|
TEST_CASE( "FAIL showcase" ) {
|
||||||
|
FAIL( "This test case causes segfault, which breaks CI." );
|
||||||
|
// ... this will not be executed ...
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
[Home](Readme.md#top)
|
18
externals/catch/docs/test-cases-and-sections.md
vendored
18
externals/catch/docs/test-cases-and-sections.md
vendored
|
@ -25,7 +25,8 @@ _section description_ can be used to provide long form description
|
||||||
of a section while keeping the _section name_ short for use with the
|
of a section while keeping the _section name_ short for use with the
|
||||||
[`-c` command line parameter](command-line.md#specify-the-section-to-run).
|
[`-c` command line parameter](command-line.md#specify-the-section-to-run).
|
||||||
|
|
||||||
**Test names must be unique within the Catch executable.**
|
**The combination of test names and tags must be unique within the Catch2
|
||||||
|
executable.**
|
||||||
|
|
||||||
For examples see the [Tutorial](tutorial.md#top)
|
For examples see the [Tutorial](tutorial.md#top)
|
||||||
|
|
||||||
|
@ -68,7 +69,8 @@ All tag names beginning with non-alphanumeric characters are reserved by Catch.
|
||||||
|
|
||||||
* `[!nonportable]` - Indicates that behaviour may vary between platforms or compilers.
|
* `[!nonportable]` - Indicates that behaviour may vary between platforms or compilers.
|
||||||
|
|
||||||
* `[#<filename>]` - running with `-#` or `--filenames-as-tags` causes Catch to add the filename, prefixed with `#` (and with any extension stripped), as a tag to all contained tests, e.g. tests in testfile.cpp would all be tagged `[#testfile]`.
|
* `[#<filename>]` - these tags are added to test cases when you run Catch2
|
||||||
|
with [`-#` or `--filenames-as-tags`](command-line.md#filenames-as-tags).
|
||||||
|
|
||||||
* `[@<alias>]` - tag aliases all begin with `@` (see below).
|
* `[@<alias>]` - tag aliases all begin with `@` (see below).
|
||||||
|
|
||||||
|
@ -167,7 +169,11 @@ Other than the additional prefixes and the formatting in the console reporter th
|
||||||
|
|
||||||
In addition to `TEST_CASE`s, Catch2 also supports test cases parametrised
|
In addition to `TEST_CASE`s, Catch2 also supports test cases parametrised
|
||||||
by types, in the form of `TEMPLATE_TEST_CASE`,
|
by types, in the form of `TEMPLATE_TEST_CASE`,
|
||||||
`TEMPLATE_PRODUCT_TEST_CASE` and `TEMPLATE_LIST_TEST_CASE`.
|
`TEMPLATE_PRODUCT_TEST_CASE` and `TEMPLATE_LIST_TEST_CASE`. These macros
|
||||||
|
are defined in the `catch_template_test_macros.hpp` header, so compiling
|
||||||
|
the code examples below also requires
|
||||||
|
`#include <catch2/catch_template_test_macros.hpp>`.
|
||||||
|
|
||||||
|
|
||||||
* **TEMPLATE_TEST_CASE(** _test name_ , _tags_, _type1_, _type2_, ..., _typen_ **)**
|
* **TEMPLATE_TEST_CASE(** _test name_ , _tags_, _type1_, _type2_, ..., _typen_ **)**
|
||||||
|
|
||||||
|
@ -225,7 +231,7 @@ TEMPLATE_TEST_CASE( "vectors can be sized and resized", "[vector][template]", in
|
||||||
|
|
||||||
> [Introduced](https://github.com/catchorg/Catch2/issues/1468) in Catch2 2.6.0.
|
> [Introduced](https://github.com/catchorg/Catch2/issues/1468) in Catch2 2.6.0.
|
||||||
|
|
||||||
_template-type1_ through _template-typen_ is list of template template
|
_template-type1_ through _template-typen_ is list of template
|
||||||
types which should be combined with each of _template-arg1_ through
|
types which should be combined with each of _template-arg1_ through
|
||||||
_template-argm_, resulting in _n * m_ test cases. Inside the test case,
|
_template-argm_, resulting in _n * m_ test cases. Inside the test case,
|
||||||
the resulting type is available under the name of `TestType`.
|
the resulting type is available under the name of `TestType`.
|
||||||
|
@ -289,7 +295,9 @@ TEMPLATE_LIST_TEST_CASE("Template test case with test types specified inside std
|
||||||
In addition to [type parametrised test cases](#type-parametrised-test-cases) Catch2 also supports
|
In addition to [type parametrised test cases](#type-parametrised-test-cases) Catch2 also supports
|
||||||
signature base parametrised test cases, in form of `TEMPLATE_TEST_CASE_SIG` and `TEMPLATE_PRODUCT_TEST_CASE_SIG`.
|
signature base parametrised test cases, in form of `TEMPLATE_TEST_CASE_SIG` and `TEMPLATE_PRODUCT_TEST_CASE_SIG`.
|
||||||
These test cases have similar syntax like [type parametrised test cases](#type-parametrised-test-cases), with one
|
These test cases have similar syntax like [type parametrised test cases](#type-parametrised-test-cases), with one
|
||||||
additional positional argument which specifies the signature.
|
additional positional argument which specifies the signature. These macros are defined in the
|
||||||
|
`catch_template_test_macros.hpp` header, so compiling the code examples below also requires
|
||||||
|
`#include <catch2/catch_template_test_macros.hpp>`.
|
||||||
|
|
||||||
### Signature
|
### Signature
|
||||||
Signature has some strict rules for these tests cases to work properly:
|
Signature has some strict rules for these tests cases to work properly:
|
||||||
|
|
2
externals/catch/docs/tostring.md
vendored
2
externals/catch/docs/tostring.md
vendored
|
@ -75,7 +75,7 @@ CATCH_TRANSLATE_EXCEPTION( MyType const& ex ) {
|
||||||
|
|
||||||
Enums that already have a `<<` overload for `std::ostream` will convert to strings as expected.
|
Enums that already have a `<<` overload for `std::ostream` will convert to strings as expected.
|
||||||
If you only need to convert enums to strings for test reporting purposes you can provide a `StringMaker` specialisations as any other type.
|
If you only need to convert enums to strings for test reporting purposes you can provide a `StringMaker` specialisations as any other type.
|
||||||
However, as a convenience, Catch provides the `REGISTER_ENUM` helper macro that will generate the `StringMaker` specialiation for you with minimal code.
|
However, as a convenience, Catch provides the `REGISTER_ENUM` helper macro that will generate the `StringMaker` specialisation for you with minimal code.
|
||||||
Simply provide it the (qualified) enum name, followed by all the enum values, and you're done!
|
Simply provide it the (qualified) enum name, followed by all the enum values, and you're done!
|
||||||
|
|
||||||
E.g.
|
E.g.
|
||||||
|
|
9
externals/catch/docs/tutorial.md
vendored
9
externals/catch/docs/tutorial.md
vendored
|
@ -119,7 +119,7 @@ This is best explained through an example ([code](../examples/100-Fix-Section.cp
|
||||||
|
|
||||||
```c++
|
```c++
|
||||||
TEST_CASE( "vectors can be sized and resized", "[vector]" ) {
|
TEST_CASE( "vectors can be sized and resized", "[vector]" ) {
|
||||||
|
// This setup will be done 4 times in total, once for each section
|
||||||
std::vector<int> v( 5 );
|
std::vector<int> v( 5 );
|
||||||
|
|
||||||
REQUIRE( v.size() == 5 );
|
REQUIRE( v.size() == 5 );
|
||||||
|
@ -152,11 +152,12 @@ TEST_CASE( "vectors can be sized and resized", "[vector]" ) {
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
For each `SECTION` the `TEST_CASE` is executed from the start. This means
|
For each `SECTION` the `TEST_CASE` is **executed from the start**. This means
|
||||||
that each section is entered with a freshly constructed vector `v`, that
|
that each section is entered with a freshly constructed vector `v`, that
|
||||||
we know has size 5 and capacity at least 5, because the two assertions
|
we know has size 5 and capacity at least 5, because the two assertions
|
||||||
are also checked before the section is entered. Each run through a test
|
are also checked before the section is entered. This behaviour may not be
|
||||||
case will execute one, and only one, leaf section.
|
ideal for tests where setup is expensive. Each run through a test case will
|
||||||
|
execute one, and only one, leaf section.
|
||||||
|
|
||||||
Section can also be nested, in which case the parent section can be
|
Section can also be nested, in which case the parent section can be
|
||||||
entered multiple times, once for each leaf section. Nested sections are
|
entered multiple times, once for each leaf section. Nested sections are
|
||||||
|
|
6
externals/catch/docs/why-catch.md
vendored
6
externals/catch/docs/why-catch.md
vendored
|
@ -30,7 +30,7 @@ So what does Catch2 bring to the party that differentiates it from these? Apart
|
||||||
* Output is through modular reporter objects. Basic textual and XML reporters are included. Custom reporters can easily be added.
|
* Output is through modular reporter objects. Basic textual and XML reporters are included. Custom reporters can easily be added.
|
||||||
* JUnit xml output is supported for integration with third-party tools, such as CI servers.
|
* JUnit xml output is supported for integration with third-party tools, such as CI servers.
|
||||||
* A default main() function is provided, but you can supply your own for complete control (e.g. integration into your own test runner GUI).
|
* A default main() function is provided, but you can supply your own for complete control (e.g. integration into your own test runner GUI).
|
||||||
* A command line parser is provided and can still be used if you choose to provided your own main() function.
|
* A command line parser is provided and can still be used if you choose to provide your own main() function.
|
||||||
* Alternative assertion macro(s) report failures but don't abort the test case
|
* Alternative assertion macro(s) report failures but don't abort the test case
|
||||||
* Good set of facilities for floating point comparisons (`Catch::Approx` and full set of matchers)
|
* Good set of facilities for floating point comparisons (`Catch::Approx` and full set of matchers)
|
||||||
* Internal and friendly macros are isolated so name clashes can be managed
|
* Internal and friendly macros are isolated so name clashes can be managed
|
||||||
|
@ -41,8 +41,8 @@ So what does Catch2 bring to the party that differentiates it from these? Apart
|
||||||
|
|
||||||
## Who else is using Catch2?
|
## Who else is using Catch2?
|
||||||
|
|
||||||
A whole lot of people. According to the 2021 JetBrains C++ ecosystem survey,
|
A whole lot of people. According to [the 2022 JetBrains C++ ecosystem survey](https://www.jetbrains.com/lp/devecosystem-2022/cpp/#Which-unit-testing-frameworks-do-you-regularly-use),
|
||||||
about 11% of C++ programmers use Catch2 for unit testing, making it the
|
about 12% of C++ programmers use Catch2 for unit testing, making it the
|
||||||
second most popular unit testing framework.
|
second most popular unit testing framework.
|
||||||
|
|
||||||
You can also take a look at the (incomplete) list of [open source projects](opensource-users.md#top)
|
You can also take a look at the (incomplete) list of [open source projects](opensource-users.md#top)
|
||||||
|
|
8
externals/catch/examples/010-TestCase.cpp
vendored
8
externals/catch/examples/010-TestCase.cpp
vendored
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 010-TestCase.cpp
|
// 010-TestCase.cpp
|
||||||
// And write tests in the same file:
|
// And write tests in the same file:
|
||||||
#include <catch2/catch_test_macros.hpp>
|
#include <catch2/catch_test_macros.hpp>
|
||||||
|
|
8
externals/catch/examples/020-TestCase-1.cpp
vendored
8
externals/catch/examples/020-TestCase-1.cpp
vendored
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 020-TestCase-1.cpp
|
// 020-TestCase-1.cpp
|
||||||
|
|
||||||
#include <catch2/catch_test_macros.hpp>
|
#include <catch2/catch_test_macros.hpp>
|
||||||
|
|
8
externals/catch/examples/020-TestCase-2.cpp
vendored
8
externals/catch/examples/020-TestCase-2.cpp
vendored
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 020-TestCase-2.cpp
|
// 020-TestCase-2.cpp
|
||||||
|
|
||||||
// main() provided by Catch in file 020-TestCase-1.cpp.
|
// main() provided by Catch in file 020-TestCase-1.cpp.
|
||||||
|
|
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 030-Asn-Require-Check.cpp
|
// 030-Asn-Require-Check.cpp
|
||||||
|
|
||||||
// Catch has two natural expression assertion macro's:
|
// Catch has two natural expression assertion macro's:
|
||||||
|
|
8
externals/catch/examples/100-Fix-Section.cpp
vendored
8
externals/catch/examples/100-Fix-Section.cpp
vendored
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 100-Fix-Section.cpp
|
// 100-Fix-Section.cpp
|
||||||
|
|
||||||
// Catch has two ways to express fixtures:
|
// Catch has two ways to express fixtures:
|
||||||
|
|
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 110-Fix-ClassFixture.cpp
|
// 110-Fix-ClassFixture.cpp
|
||||||
|
|
||||||
// Catch has two ways to express fixtures:
|
// Catch has two ways to express fixtures:
|
||||||
|
|
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 120-Bdd-ScenarioGivenWhenThen.cpp
|
// 120-Bdd-ScenarioGivenWhenThen.cpp
|
||||||
|
|
||||||
// main() provided by linkage with Catch2WithMain
|
// main() provided by linkage with Catch2WithMain
|
||||||
|
|
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 210-Evt-EventListeners.cpp
|
// 210-Evt-EventListeners.cpp
|
||||||
|
|
||||||
// Contents:
|
// Contents:
|
||||||
|
|
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 231-Cfg-OutputStreams.cpp
|
// 231-Cfg-OutputStreams.cpp
|
||||||
// Show how to replace the streams with a simple custom made streambuf.
|
// Show how to replace the streams with a simple custom made streambuf.
|
||||||
|
|
||||||
|
|
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 300-Gen-OwnGenerator.cpp
|
// 300-Gen-OwnGenerator.cpp
|
||||||
// Shows how to define a custom generator.
|
// Shows how to define a custom generator.
|
||||||
|
|
||||||
|
|
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 301-Gen-MapTypeConversion.cpp
|
// 301-Gen-MapTypeConversion.cpp
|
||||||
// Shows how to use map to modify generator's return type.
|
// Shows how to use map to modify generator's return type.
|
||||||
|
|
||||||
|
|
12
externals/catch/examples/302-Gen-Table.cpp
vendored
12
externals/catch/examples/302-Gen-Table.cpp
vendored
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 302-Gen-Table.cpp
|
// 302-Gen-Table.cpp
|
||||||
// Shows how to use table to run a test many times with different inputs. Lifted from examples on
|
// Shows how to use table to run a test many times with different inputs. Lifted from examples on
|
||||||
// issue #850.
|
// issue #850.
|
||||||
|
@ -44,11 +52,11 @@ TEST_CASE("Table allows pre-computed test inputs and outputs", "[example][genera
|
||||||
|
|
||||||
/* Possible simplifications where less legacy toolchain support is needed:
|
/* Possible simplifications where less legacy toolchain support is needed:
|
||||||
*
|
*
|
||||||
* - With libstdc++6 or newer, the make_tuple() calls can be ommitted
|
* - With libstdc++6 or newer, the make_tuple() calls can be omitted
|
||||||
* (technically C++17 but does not require -std in GCC/Clang). See
|
* (technically C++17 but does not require -std in GCC/Clang). See
|
||||||
* https://stackoverflow.com/questions/12436586/tuple-vector-and-initializer-list
|
* https://stackoverflow.com/questions/12436586/tuple-vector-and-initializer-list
|
||||||
*
|
*
|
||||||
* - In C++17 mode std::tie() and the preceding variable delcarations can be
|
* - In C++17 mode std::tie() and the preceding variable declarations can be
|
||||||
* replaced by structured bindings: auto [test_input, expected] = GENERATE(
|
* replaced by structured bindings: auto [test_input, expected] = GENERATE(
|
||||||
* table<std::string, size_t>({ ...
|
* table<std::string, size_t>({ ...
|
||||||
*/
|
*/
|
||||||
|
|
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 310-Gen-VariablesInGenerator.cpp
|
// 310-Gen-VariablesInGenerator.cpp
|
||||||
// Shows how to use variables when creating generators.
|
// Shows how to use variables when creating generators.
|
||||||
|
|
||||||
|
|
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
// 311-Gen-CustomCapture.cpp
|
// 311-Gen-CustomCapture.cpp
|
||||||
// Shows how to provide custom capture list to the generator expression
|
// Shows how to provide custom capture list to the generator expression
|
||||||
|
|
||||||
|
|
100
externals/catch/extras/Catch.cmake
vendored
100
externals/catch/extras/Catch.cmake
vendored
|
@ -35,8 +35,9 @@ same as the Catch name; see also ``TEST_PREFIX`` and ``TEST_SUFFIX``.
|
||||||
[TEST_LIST var]
|
[TEST_LIST var]
|
||||||
[REPORTER reporter]
|
[REPORTER reporter]
|
||||||
[OUTPUT_DIR dir]
|
[OUTPUT_DIR dir]
|
||||||
[OUTPUT_PREFIX prefix}
|
[OUTPUT_PREFIX prefix]
|
||||||
[OUTPUT_SUFFIX suffix]
|
[OUTPUT_SUFFIX suffix]
|
||||||
|
[DISCOVERY_MODE <POST_BUILD|PRE_TEST>]
|
||||||
)
|
)
|
||||||
|
|
||||||
``catch_discover_tests`` sets up a post-build command on the test executable
|
``catch_discover_tests`` sets up a post-build command on the test executable
|
||||||
|
@ -123,14 +124,28 @@ same as the Catch name; see also ``TEST_PREFIX`` and ``TEST_SUFFIX``.
|
||||||
test executable and when the tests are executed themselves. This requires
|
test executable and when the tests are executed themselves. This requires
|
||||||
cmake/ctest >= 3.22.
|
cmake/ctest >= 3.22.
|
||||||
|
|
||||||
|
`DISCOVERY_MODE mode``
|
||||||
|
Provides control over when ``catch_discover_tests`` performs test discovery.
|
||||||
|
By default, ``POST_BUILD`` sets up a post-build command to perform test discovery
|
||||||
|
at build time. In certain scenarios, like cross-compiling, this ``POST_BUILD``
|
||||||
|
behavior is not desirable. By contrast, ``PRE_TEST`` delays test discovery until
|
||||||
|
just prior to test execution. This way test discovery occurs in the target environment
|
||||||
|
where the test has a better chance at finding appropriate runtime dependencies.
|
||||||
|
|
||||||
|
``DISCOVERY_MODE`` defaults to the value of the
|
||||||
|
``CMAKE_CATCH_DISCOVER_TESTS_DISCOVERY_MODE`` variable if it is not passed when
|
||||||
|
calling ``catch_discover_tests``. This provides a mechanism for globally selecting
|
||||||
|
a preferred test discovery behavior without having to modify each call site.
|
||||||
|
|
||||||
#]=======================================================================]
|
#]=======================================================================]
|
||||||
|
|
||||||
#------------------------------------------------------------------------------
|
#------------------------------------------------------------------------------
|
||||||
function(catch_discover_tests TARGET)
|
function(catch_discover_tests TARGET)
|
||||||
|
|
||||||
cmake_parse_arguments(
|
cmake_parse_arguments(
|
||||||
""
|
""
|
||||||
""
|
""
|
||||||
"TEST_PREFIX;TEST_SUFFIX;WORKING_DIRECTORY;TEST_LIST;REPORTER;OUTPUT_DIR;OUTPUT_PREFIX;OUTPUT_SUFFIX"
|
"TEST_PREFIX;TEST_SUFFIX;WORKING_DIRECTORY;TEST_LIST;REPORTER;OUTPUT_DIR;OUTPUT_PREFIX;OUTPUT_SUFFIX;DISCOVERY_MODE"
|
||||||
"TEST_SPEC;EXTRA_ARGS;PROPERTIES;DL_PATHS"
|
"TEST_SPEC;EXTRA_ARGS;PROPERTIES;DL_PATHS"
|
||||||
${ARGN}
|
${ARGN}
|
||||||
)
|
)
|
||||||
|
@ -141,24 +156,36 @@ function(catch_discover_tests TARGET)
|
||||||
if(NOT _TEST_LIST)
|
if(NOT _TEST_LIST)
|
||||||
set(_TEST_LIST ${TARGET}_TESTS)
|
set(_TEST_LIST ${TARGET}_TESTS)
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
if (_DL_PATHS)
|
if (_DL_PATHS)
|
||||||
if(${CMAKE_VERSION} VERSION_LESS "3.22.0")
|
if(${CMAKE_VERSION} VERSION_LESS "3.22.0")
|
||||||
message(FATAL_ERROR "The DL_PATHS option requires at least cmake 3.22")
|
message(FATAL_ERROR "The DL_PATHS option requires at least cmake 3.22")
|
||||||
endif()
|
endif()
|
||||||
endif()
|
endif()
|
||||||
|
if(NOT _DISCOVERY_MODE)
|
||||||
|
if(NOT CMAKE_CATCH_DISCOVER_TESTS_DISCOVERY_MODE)
|
||||||
|
set(CMAKE_CATCH_DISCOVER_TESTS_DISCOVERY_MODE "POST_BUILD")
|
||||||
|
endif()
|
||||||
|
set(_DISCOVERY_MODE ${CMAKE_CATCH_DISCOVER_TESTS_DISCOVERY_MODE})
|
||||||
|
endif()
|
||||||
|
if (NOT _DISCOVERY_MODE MATCHES "^(POST_BUILD|PRE_TEST)$")
|
||||||
|
message(FATAL_ERROR "Unknown DISCOVERY_MODE: ${_DISCOVERY_MODE}")
|
||||||
|
endif()
|
||||||
|
|
||||||
## Generate a unique name based on the extra arguments
|
## Generate a unique name based on the extra arguments
|
||||||
string(SHA1 args_hash "${_TEST_SPEC} ${_EXTRA_ARGS} ${_REPORTER} ${_OUTPUT_DIR} ${_OUTPUT_PREFIX} ${_OUTPUT_SUFFIX}")
|
string(SHA1 args_hash "${_TEST_SPEC} ${_EXTRA_ARGS} ${_REPORTER} ${_OUTPUT_DIR} ${_OUTPUT_PREFIX} ${_OUTPUT_SUFFIX}")
|
||||||
string(SUBSTRING ${args_hash} 0 7 args_hash)
|
string(SUBSTRING ${args_hash} 0 7 args_hash)
|
||||||
|
|
||||||
# Define rule to generate test list for aforementioned test executable
|
# Define rule to generate test list for aforementioned test executable
|
||||||
set(ctest_include_file "${CMAKE_CURRENT_BINARY_DIR}/${TARGET}_include-${args_hash}.cmake")
|
set(ctest_file_base "${CMAKE_CURRENT_BINARY_DIR}/${TARGET}-${args_hash}")
|
||||||
set(ctest_tests_file "${CMAKE_CURRENT_BINARY_DIR}/${TARGET}_tests-${args_hash}.cmake")
|
set(ctest_include_file "${ctest_file_base}_include.cmake")
|
||||||
|
set(ctest_tests_file "${ctest_file_base}_tests.cmake")
|
||||||
|
|
||||||
get_property(crosscompiling_emulator
|
get_property(crosscompiling_emulator
|
||||||
TARGET ${TARGET}
|
TARGET ${TARGET}
|
||||||
PROPERTY CROSSCOMPILING_EMULATOR
|
PROPERTY CROSSCOMPILING_EMULATOR
|
||||||
)
|
)
|
||||||
|
|
||||||
|
if(_DISCOVERY_MODE STREQUAL "POST_BUILD")
|
||||||
add_custom_command(
|
add_custom_command(
|
||||||
TARGET ${TARGET} POST_BUILD
|
TARGET ${TARGET} POST_BUILD
|
||||||
BYPRODUCTS "${ctest_tests_file}"
|
BYPRODUCTS "${ctest_tests_file}"
|
||||||
|
@ -191,6 +218,65 @@ function(catch_discover_tests TARGET)
|
||||||
"endif()\n"
|
"endif()\n"
|
||||||
)
|
)
|
||||||
|
|
||||||
|
elseif(_DISCOVERY_MODE STREQUAL "PRE_TEST")
|
||||||
|
|
||||||
|
get_property(GENERATOR_IS_MULTI_CONFIG GLOBAL
|
||||||
|
PROPERTY GENERATOR_IS_MULTI_CONFIG
|
||||||
|
)
|
||||||
|
|
||||||
|
if(GENERATOR_IS_MULTI_CONFIG)
|
||||||
|
set(ctest_tests_file "${ctest_file_base}_tests-$<CONFIG>.cmake")
|
||||||
|
endif()
|
||||||
|
|
||||||
|
string(CONCAT ctest_include_content
|
||||||
|
"if(EXISTS \"$<TARGET_FILE:${TARGET}>\")" "\n"
|
||||||
|
" if(NOT EXISTS \"${ctest_tests_file}\" OR" "\n"
|
||||||
|
" NOT \"${ctest_tests_file}\" IS_NEWER_THAN \"$<TARGET_FILE:${TARGET}>\" OR\n"
|
||||||
|
" NOT \"${ctest_tests_file}\" IS_NEWER_THAN \"\${CMAKE_CURRENT_LIST_FILE}\")\n"
|
||||||
|
" include(\"${_CATCH_DISCOVER_TESTS_SCRIPT}\")" "\n"
|
||||||
|
" catch_discover_tests_impl(" "\n"
|
||||||
|
" TEST_EXECUTABLE" " [==[" "$<TARGET_FILE:${TARGET}>" "]==]" "\n"
|
||||||
|
" TEST_EXECUTOR" " [==[" "${crosscompiling_emulator}" "]==]" "\n"
|
||||||
|
" TEST_WORKING_DIR" " [==[" "${_WORKING_DIRECTORY}" "]==]" "\n"
|
||||||
|
" TEST_SPEC" " [==[" "${_TEST_SPEC}" "]==]" "\n"
|
||||||
|
" TEST_EXTRA_ARGS" " [==[" "${_EXTRA_ARGS}" "]==]" "\n"
|
||||||
|
" TEST_PROPERTIES" " [==[" "${_PROPERTIES}" "]==]" "\n"
|
||||||
|
" TEST_PREFIX" " [==[" "${_TEST_PREFIX}" "]==]" "\n"
|
||||||
|
" TEST_SUFFIX" " [==[" "${_TEST_SUFFIX}" "]==]" "\n"
|
||||||
|
" TEST_LIST" " [==[" "${_TEST_LIST}" "]==]" "\n"
|
||||||
|
" TEST_REPORTER" " [==[" "${_REPORTER}" "]==]" "\n"
|
||||||
|
" TEST_OUTPUT_DIR" " [==[" "${_OUTPUT_DIR}" "]==]" "\n"
|
||||||
|
" TEST_OUTPUT_PREFIX" " [==[" "${_OUTPUT_PREFIX}" "]==]" "\n"
|
||||||
|
" TEST_OUTPUT_SUFFIX" " [==[" "${_OUTPUT_SUFFIX}" "]==]" "\n"
|
||||||
|
" CTEST_FILE" " [==[" "${ctest_tests_file}" "]==]" "\n"
|
||||||
|
" TEST_DL_PATHS" " [==[" "${_DL_PATHS}" "]==]" "\n"
|
||||||
|
" CTEST_FILE" " [==[" "${CTEST_FILE}" "]==]" "\n"
|
||||||
|
" )" "\n"
|
||||||
|
" endif()" "\n"
|
||||||
|
" include(\"${ctest_tests_file}\")" "\n"
|
||||||
|
"else()" "\n"
|
||||||
|
" add_test(${TARGET}_NOT_BUILT ${TARGET}_NOT_BUILT)" "\n"
|
||||||
|
"endif()" "\n"
|
||||||
|
)
|
||||||
|
|
||||||
|
if(GENERATOR_IS_MULTI_CONFIG)
|
||||||
|
foreach(_config ${CMAKE_CONFIGURATION_TYPES})
|
||||||
|
file(GENERATE OUTPUT "${ctest_file_base}_include-${_config}.cmake" CONTENT "${ctest_include_content}" CONDITION $<CONFIG:${_config}>)
|
||||||
|
endforeach()
|
||||||
|
string(CONCAT ctest_include_multi_content
|
||||||
|
"if(NOT CTEST_CONFIGURATION_TYPE)" "\n"
|
||||||
|
" message(\"No configuration for testing specified, use '-C <cfg>'.\")" "\n"
|
||||||
|
"else()" "\n"
|
||||||
|
" include(\"${ctest_file_base}_include-\${CTEST_CONFIGURATION_TYPE}.cmake\")" "\n"
|
||||||
|
"endif()" "\n"
|
||||||
|
)
|
||||||
|
file(GENERATE OUTPUT "${ctest_include_file}" CONTENT "${ctest_include_multi_content}")
|
||||||
|
else()
|
||||||
|
file(GENERATE OUTPUT "${ctest_file_base}_include.cmake" CONTENT "${ctest_include_content}")
|
||||||
|
file(WRITE "${ctest_include_file}" "include(\"${ctest_file_base}_include.cmake\")")
|
||||||
|
endif()
|
||||||
|
endif()
|
||||||
|
|
||||||
if(NOT ${CMAKE_VERSION} VERSION_LESS "3.10.0")
|
if(NOT ${CMAKE_VERSION} VERSION_LESS "3.10.0")
|
||||||
# Add discovered tests to directory TEST_INCLUDE_FILES
|
# Add discovered tests to directory TEST_INCLUDE_FILES
|
||||||
set_property(DIRECTORY
|
set_property(DIRECTORY
|
||||||
|
@ -204,9 +290,7 @@ function(catch_discover_tests TARGET)
|
||||||
PROPERTY TEST_INCLUDE_FILE "${ctest_include_file}"
|
PROPERTY TEST_INCLUDE_FILE "${ctest_include_file}"
|
||||||
)
|
)
|
||||||
else()
|
else()
|
||||||
message(FATAL_ERROR
|
message(FATAL_ERROR "Cannot set more than one TEST_INCLUDE_FILE")
|
||||||
"Cannot set more than one TEST_INCLUDE_FILE"
|
|
||||||
)
|
|
||||||
endif()
|
endif()
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
|
|
198
externals/catch/extras/CatchAddTests.cmake
vendored
198
externals/catch/extras/CatchAddTests.cmake
vendored
|
@ -1,28 +1,6 @@
|
||||||
# Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
# Distributed under the OSI-approved BSD 3-Clause License. See accompanying
|
||||||
# file Copyright.txt or https://cmake.org/licensing for details.
|
# file Copyright.txt or https://cmake.org/licensing for details.
|
||||||
|
|
||||||
set(prefix "${TEST_PREFIX}")
|
|
||||||
set(suffix "${TEST_SUFFIX}")
|
|
||||||
set(spec ${TEST_SPEC})
|
|
||||||
set(extra_args ${TEST_EXTRA_ARGS})
|
|
||||||
set(properties ${TEST_PROPERTIES})
|
|
||||||
set(reporter ${TEST_REPORTER})
|
|
||||||
set(output_dir ${TEST_OUTPUT_DIR})
|
|
||||||
set(output_prefix ${TEST_OUTPUT_PREFIX})
|
|
||||||
set(output_suffix ${TEST_OUTPUT_SUFFIX})
|
|
||||||
set(dl_paths ${TEST_DL_PATHS})
|
|
||||||
set(script)
|
|
||||||
set(suite)
|
|
||||||
set(tests)
|
|
||||||
|
|
||||||
if(WIN32)
|
|
||||||
set(dl_paths_variable_name PATH)
|
|
||||||
elseif(APPLE)
|
|
||||||
set(dl_paths_variable_name DYLD_LIBRARY_PATH)
|
|
||||||
else()
|
|
||||||
set(dl_paths_variable_name LD_LIBRARY_PATH)
|
|
||||||
endif()
|
|
||||||
|
|
||||||
function(add_command NAME)
|
function(add_command NAME)
|
||||||
set(_args "")
|
set(_args "")
|
||||||
# use ARGV* instead of ARGN, because ARGN splits arrays into multiple arguments
|
# use ARGV* instead of ARGN, because ARGN splits arrays into multiple arguments
|
||||||
|
@ -38,94 +16,131 @@ function(add_command NAME)
|
||||||
set(script "${script}${NAME}(${_args})\n" PARENT_SCOPE)
|
set(script "${script}${NAME}(${_args})\n" PARENT_SCOPE)
|
||||||
endfunction()
|
endfunction()
|
||||||
|
|
||||||
# Run test executable to get list of available tests
|
function(catch_discover_tests_impl)
|
||||||
if(NOT EXISTS "${TEST_EXECUTABLE}")
|
|
||||||
message(FATAL_ERROR
|
|
||||||
"Specified test executable '${TEST_EXECUTABLE}' does not exist"
|
|
||||||
)
|
|
||||||
endif()
|
|
||||||
|
|
||||||
if(dl_paths)
|
cmake_parse_arguments(
|
||||||
|
""
|
||||||
|
""
|
||||||
|
"TEST_EXECUTABLE;TEST_WORKING_DIR;TEST_DL_PATHS;TEST_OUTPUT_DIR;TEST_OUTPUT_PREFIX;TEST_OUTPUT_SUFFIX;TEST_PREFIX;TEST_REPORTER;TEST_SPEC;TEST_SUFFIX;TEST_LIST;CTEST_FILE"
|
||||||
|
"TEST_EXTRA_ARGS;TEST_PROPERTIES;TEST_EXECUTOR"
|
||||||
|
${ARGN}
|
||||||
|
)
|
||||||
|
|
||||||
|
set(prefix "${_TEST_PREFIX}")
|
||||||
|
set(suffix "${_TEST_SUFFIX}")
|
||||||
|
set(spec ${_TEST_SPEC})
|
||||||
|
set(extra_args ${_TEST_EXTRA_ARGS})
|
||||||
|
set(properties ${_TEST_PROPERTIES})
|
||||||
|
set(reporter ${_TEST_REPORTER})
|
||||||
|
set(output_dir ${_TEST_OUTPUT_DIR})
|
||||||
|
set(output_prefix ${_TEST_OUTPUT_PREFIX})
|
||||||
|
set(output_suffix ${_TEST_OUTPUT_SUFFIX})
|
||||||
|
set(dl_paths ${_TEST_DL_PATHS})
|
||||||
|
set(script)
|
||||||
|
set(suite)
|
||||||
|
set(tests)
|
||||||
|
|
||||||
|
if(WIN32)
|
||||||
|
set(dl_paths_variable_name PATH)
|
||||||
|
elseif(APPLE)
|
||||||
|
set(dl_paths_variable_name DYLD_LIBRARY_PATH)
|
||||||
|
else()
|
||||||
|
set(dl_paths_variable_name LD_LIBRARY_PATH)
|
||||||
|
endif()
|
||||||
|
|
||||||
|
# Run test executable to get list of available tests
|
||||||
|
if(NOT EXISTS "${_TEST_EXECUTABLE}")
|
||||||
|
message(FATAL_ERROR
|
||||||
|
"Specified test executable '${_TEST_EXECUTABLE}' does not exist"
|
||||||
|
)
|
||||||
|
endif()
|
||||||
|
|
||||||
|
if(dl_paths)
|
||||||
cmake_path(CONVERT "${dl_paths}" TO_NATIVE_PATH_LIST paths)
|
cmake_path(CONVERT "${dl_paths}" TO_NATIVE_PATH_LIST paths)
|
||||||
set(ENV{${dl_paths_variable_name}} "${paths}")
|
set(ENV{${dl_paths_variable_name}} "${paths}")
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
execute_process(
|
execute_process(
|
||||||
COMMAND ${TEST_EXECUTOR} "${TEST_EXECUTABLE}" ${spec} --list-tests --verbosity quiet
|
COMMAND ${_TEST_EXECUTOR} "${_TEST_EXECUTABLE}" ${spec} --list-tests --verbosity quiet
|
||||||
OUTPUT_VARIABLE output
|
OUTPUT_VARIABLE output
|
||||||
RESULT_VARIABLE result
|
RESULT_VARIABLE result
|
||||||
WORKING_DIRECTORY "${TEST_WORKING_DIR}"
|
WORKING_DIRECTORY "${_TEST_WORKING_DIR}"
|
||||||
)
|
)
|
||||||
if(NOT ${result} EQUAL 0)
|
if(NOT ${result} EQUAL 0)
|
||||||
message(FATAL_ERROR
|
message(FATAL_ERROR
|
||||||
"Error running test executable '${TEST_EXECUTABLE}':\n"
|
"Error running test executable '${_TEST_EXECUTABLE}':\n"
|
||||||
" Result: ${result}\n"
|
" Result: ${result}\n"
|
||||||
" Output: ${output}\n"
|
" Output: ${output}\n"
|
||||||
)
|
)
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
string(REPLACE "\n" ";" output "${output}")
|
# Make sure to escape ; (semicolons) in test names first, because
|
||||||
|
# that'd break the foreach loop for "Parse output" later and create
|
||||||
|
# wrongly splitted and thus failing test cases (false positives)
|
||||||
|
string(REPLACE ";" "\;" output "${output}")
|
||||||
|
string(REPLACE "\n" ";" output "${output}")
|
||||||
|
|
||||||
# Run test executable to get list of available reporters
|
# Prepare reporter
|
||||||
execute_process(
|
if(reporter)
|
||||||
COMMAND ${TEST_EXECUTOR} "${TEST_EXECUTABLE}" ${spec} --list-reporters
|
set(reporter_arg "--reporter ${reporter}")
|
||||||
OUTPUT_VARIABLE reporters_output
|
|
||||||
RESULT_VARIABLE reporters_result
|
# Run test executable to check whether reporter is available
|
||||||
WORKING_DIRECTORY "${TEST_WORKING_DIR}"
|
# note that the use of --list-reporters is not the important part,
|
||||||
)
|
# we only want to check whether the execution succeeds with ${reporter_arg}
|
||||||
if(NOT ${reporters_result} EQUAL 0)
|
execute_process(
|
||||||
message(FATAL_ERROR
|
COMMAND ${_TEST_EXECUTOR} "${_TEST_EXECUTABLE}" ${spec} ${reporter_arg} --list-reporters
|
||||||
"Error running test executable '${TEST_EXECUTABLE}':\n"
|
OUTPUT_VARIABLE reporter_check_output
|
||||||
" Result: ${reporters_result}\n"
|
RESULT_VARIABLE reporter_check_result
|
||||||
" Output: ${reporters_output}\n"
|
WORKING_DIRECTORY "${_TEST_WORKING_DIR}"
|
||||||
)
|
)
|
||||||
endif()
|
if(${reporter_check_result} EQUAL 255)
|
||||||
string(FIND "${reporters_output}" "${reporter}" reporter_is_valid)
|
|
||||||
if(reporter AND ${reporter_is_valid} EQUAL -1)
|
|
||||||
message(FATAL_ERROR
|
message(FATAL_ERROR
|
||||||
"\"${reporter}\" is not a valid reporter!\n"
|
"\"${reporter}\" is not a valid reporter!\n"
|
||||||
)
|
)
|
||||||
endif()
|
elseif(NOT ${reporter_check_result} EQUAL 0)
|
||||||
|
message(FATAL_ERROR
|
||||||
|
"Error running test executable '${_TEST_EXECUTABLE}':\n"
|
||||||
|
" Result: ${reporter_check_result}\n"
|
||||||
|
" Output: ${reporter_check_output}\n"
|
||||||
|
)
|
||||||
|
endif()
|
||||||
|
endif()
|
||||||
|
|
||||||
# Prepare reporter
|
# Prepare output dir
|
||||||
if(reporter)
|
if(output_dir AND NOT IS_ABSOLUTE ${output_dir})
|
||||||
set(reporter_arg "--reporter ${reporter}")
|
set(output_dir "${_TEST_WORKING_DIR}/${output_dir}")
|
||||||
endif()
|
|
||||||
|
|
||||||
# Prepare output dir
|
|
||||||
if(output_dir AND NOT IS_ABSOLUTE ${output_dir})
|
|
||||||
set(output_dir "${TEST_WORKING_DIR}/${output_dir}")
|
|
||||||
if(NOT EXISTS ${output_dir})
|
if(NOT EXISTS ${output_dir})
|
||||||
file(MAKE_DIRECTORY ${output_dir})
|
file(MAKE_DIRECTORY ${output_dir})
|
||||||
endif()
|
endif()
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
if(dl_paths)
|
if(dl_paths)
|
||||||
foreach(path ${dl_paths})
|
foreach(path ${dl_paths})
|
||||||
cmake_path(NATIVE_PATH path native_path)
|
cmake_path(NATIVE_PATH path native_path)
|
||||||
list(APPEND environment_modifications "${dl_paths_variable_name}=path_list_prepend:${native_path}")
|
list(APPEND environment_modifications "${dl_paths_variable_name}=path_list_prepend:${native_path}")
|
||||||
endforeach()
|
endforeach()
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
# Parse output
|
# Parse output
|
||||||
foreach(line ${output})
|
foreach(line ${output})
|
||||||
set(test ${line})
|
set(test "${line}")
|
||||||
# Escape characters in test case names that would be parsed by Catch2
|
# Escape characters in test case names that would be parsed by Catch2
|
||||||
set(test_name ${test})
|
# Note that the \ escaping must happen FIRST! Do not change the order.
|
||||||
foreach(char , [ ])
|
set(test_name "${test}")
|
||||||
string(REPLACE ${char} "\\${char}" test_name ${test_name})
|
foreach(char \\ , [ ])
|
||||||
|
string(REPLACE ${char} "\\${char}" test_name "${test_name}")
|
||||||
endforeach(char)
|
endforeach(char)
|
||||||
# ...add output dir
|
# ...add output dir
|
||||||
if(output_dir)
|
if(output_dir)
|
||||||
string(REGEX REPLACE "[^A-Za-z0-9_]" "_" test_name_clean ${test_name})
|
string(REGEX REPLACE "[^A-Za-z0-9_]" "_" test_name_clean "${test_name}")
|
||||||
set(output_dir_arg "--out ${output_dir}/${output_prefix}${test_name_clean}${output_suffix}")
|
set(output_dir_arg "--out ${output_dir}/${output_prefix}${test_name_clean}${output_suffix}")
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
# ...and add to script
|
# ...and add to script
|
||||||
add_command(add_test
|
add_command(add_test
|
||||||
"${prefix}${test}${suffix}"
|
"${prefix}${test}${suffix}"
|
||||||
${TEST_EXECUTOR}
|
${_TEST_EXECUTOR}
|
||||||
"${TEST_EXECUTABLE}"
|
"${_TEST_EXECUTABLE}"
|
||||||
"${test_name}"
|
"${test_name}"
|
||||||
${extra_args}
|
${extra_args}
|
||||||
"${reporter_arg}"
|
"${reporter_arg}"
|
||||||
|
@ -134,7 +149,7 @@ foreach(line ${output})
|
||||||
add_command(set_tests_properties
|
add_command(set_tests_properties
|
||||||
"${prefix}${test}${suffix}"
|
"${prefix}${test}${suffix}"
|
||||||
PROPERTIES
|
PROPERTIES
|
||||||
WORKING_DIRECTORY "${TEST_WORKING_DIR}"
|
WORKING_DIRECTORY "${_TEST_WORKING_DIR}"
|
||||||
${properties}
|
${properties}
|
||||||
)
|
)
|
||||||
|
|
||||||
|
@ -146,11 +161,32 @@ foreach(line ${output})
|
||||||
endif()
|
endif()
|
||||||
|
|
||||||
list(APPEND tests "${prefix}${test}${suffix}")
|
list(APPEND tests "${prefix}${test}${suffix}")
|
||||||
endforeach()
|
endforeach()
|
||||||
|
|
||||||
# Create a list of all discovered tests, which users may use to e.g. set
|
# Create a list of all discovered tests, which users may use to e.g. set
|
||||||
# properties on the tests
|
# properties on the tests
|
||||||
add_command(set ${TEST_LIST} ${tests})
|
add_command(set ${_TEST_LIST} ${tests})
|
||||||
|
|
||||||
# Write CTest script
|
# Write CTest script
|
||||||
file(WRITE "${CTEST_FILE}" "${script}")
|
file(WRITE "${_CTEST_FILE}" "${script}")
|
||||||
|
endfunction()
|
||||||
|
|
||||||
|
if(CMAKE_SCRIPT_MODE_FILE)
|
||||||
|
catch_discover_tests_impl(
|
||||||
|
TEST_EXECUTABLE ${TEST_EXECUTABLE}
|
||||||
|
TEST_EXECUTOR ${TEST_EXECUTOR}
|
||||||
|
TEST_WORKING_DIR ${TEST_WORKING_DIR}
|
||||||
|
TEST_SPEC ${TEST_SPEC}
|
||||||
|
TEST_EXTRA_ARGS ${TEST_EXTRA_ARGS}
|
||||||
|
TEST_PROPERTIES ${TEST_PROPERTIES}
|
||||||
|
TEST_PREFIX ${TEST_PREFIX}
|
||||||
|
TEST_SUFFIX ${TEST_SUFFIX}
|
||||||
|
TEST_LIST ${TEST_LIST}
|
||||||
|
TEST_REPORTER ${TEST_REPORTER}
|
||||||
|
TEST_OUTPUT_DIR ${TEST_OUTPUT_DIR}
|
||||||
|
TEST_OUTPUT_PREFIX ${TEST_OUTPUT_PREFIX}
|
||||||
|
TEST_OUTPUT_SUFFIX ${TEST_OUTPUT_SUFFIX}
|
||||||
|
TEST_DL_PATHS ${TEST_DL_PATHS}
|
||||||
|
CTEST_FILE ${CTEST_FILE}
|
||||||
|
)
|
||||||
|
endif()
|
||||||
|
|
10
externals/catch/extras/CatchShardTests.cmake
vendored
10
externals/catch/extras/CatchShardTests.cmake
vendored
|
@ -46,7 +46,7 @@ function(catch_add_sharded_tests TARGET)
|
||||||
APPEND PROPERTY TEST_INCLUDE_FILES "${ctest_include_file}"
|
APPEND PROPERTY TEST_INCLUDE_FILES "${ctest_include_file}"
|
||||||
)
|
)
|
||||||
|
|
||||||
set(shard_impl_script_file "${CMAKE_CURRENT_LIST_DIR}/CatchShardTestsImpl.cmake")
|
set(shard_impl_script_file "${_CATCH_DISCOVER_SHARD_TESTS_IMPL_SCRIPT}")
|
||||||
|
|
||||||
add_custom_command(
|
add_custom_command(
|
||||||
TARGET ${TARGET} POST_BUILD
|
TARGET ${TARGET} POST_BUILD
|
||||||
|
@ -64,3 +64,11 @@ function(catch_add_sharded_tests TARGET)
|
||||||
|
|
||||||
|
|
||||||
endfunction()
|
endfunction()
|
||||||
|
|
||||||
|
|
||||||
|
###############################################################################
|
||||||
|
|
||||||
|
set(_CATCH_DISCOVER_SHARD_TESTS_IMPL_SCRIPT
|
||||||
|
${CMAKE_CURRENT_LIST_DIR}/CatchShardTestsImpl.cmake
|
||||||
|
CACHE INTERNAL "Catch2 full path to CatchShardTestsImpl.cmake helper file"
|
||||||
|
)
|
||||||
|
|
2013
externals/catch/extras/catch_amalgamated.cpp
vendored
2013
externals/catch/extras/catch_amalgamated.cpp
vendored
File diff suppressed because it is too large
Load diff
4314
externals/catch/extras/catch_amalgamated.hpp
vendored
4314
externals/catch/extras/catch_amalgamated.hpp
vendored
File diff suppressed because it is too large
Load diff
8
externals/catch/fuzzing/NullOStream.cpp
vendored
8
externals/catch/fuzzing/NullOStream.cpp
vendored
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
#include "NullOStream.h"
|
#include "NullOStream.h"
|
||||||
|
|
||||||
void NullOStream::avoidOutOfLineVirtualCompilerWarning()
|
void NullOStream::avoidOutOfLineVirtualCompilerWarning()
|
||||||
|
|
8
externals/catch/fuzzing/NullOStream.h
vendored
8
externals/catch/fuzzing/NullOStream.h
vendored
|
@ -1,3 +1,11 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
#pragma once
|
#pragma once
|
||||||
|
|
||||||
#include <ostream>
|
#include <ostream>
|
||||||
|
|
|
@ -1,4 +1,10 @@
|
||||||
//License: Boost 1.0
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
//By Paul Dreik 2020
|
//By Paul Dreik 2020
|
||||||
|
|
||||||
#include <catch2/internal/catch_test_spec_parser.hpp>
|
#include <catch2/internal/catch_test_spec_parser.hpp>
|
||||||
|
|
8
externals/catch/fuzzing/fuzz_XmlWriter.cpp
vendored
8
externals/catch/fuzzing/fuzz_XmlWriter.cpp
vendored
|
@ -1,4 +1,10 @@
|
||||||
//License: Boost 1.0
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
//By Paul Dreik 2020
|
//By Paul Dreik 2020
|
||||||
|
|
||||||
#include <catch2/internal/catch_xmlwriter.hpp>
|
#include <catch2/internal/catch_xmlwriter.hpp>
|
||||||
|
|
8
externals/catch/fuzzing/fuzz_textflow.cpp
vendored
8
externals/catch/fuzzing/fuzz_textflow.cpp
vendored
|
@ -1,4 +1,10 @@
|
||||||
//License: Boost 1.0
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
//By Paul Dreik 2020
|
//By Paul Dreik 2020
|
||||||
|
|
||||||
#include <catch2/internal/catch_textflow.hpp>
|
#include <catch2/internal/catch_textflow.hpp>
|
||||||
|
|
8
externals/catch/meson.build
vendored
8
externals/catch/meson.build
vendored
|
@ -8,10 +8,12 @@
|
||||||
project(
|
project(
|
||||||
'catch2',
|
'catch2',
|
||||||
'cpp',
|
'cpp',
|
||||||
version: '3.2.1', # CML version placeholder, don't delete
|
version: '3.5.0', # CML version placeholder, don't delete
|
||||||
license: 'BSL-1.0',
|
license: 'BSL-1.0',
|
||||||
meson_version: '>=0.50.0',
|
meson_version: '>=0.54.1',
|
||||||
)
|
)
|
||||||
|
|
||||||
subdir('src/catch2')
|
subdir('src/catch2')
|
||||||
subdir('tests')
|
if get_option('tests')
|
||||||
|
subdir('tests')
|
||||||
|
endif
|
||||||
|
|
1
externals/catch/meson_options.txt
vendored
Normal file
1
externals/catch/meson_options.txt
vendored
Normal file
|
@ -0,0 +1 @@
|
||||||
|
option('tests', type: 'boolean', value: true, description: 'Build the unit tests')
|
35
externals/catch/src/CMakeLists.txt
vendored
35
externals/catch/src/CMakeLists.txt
vendored
|
@ -21,6 +21,8 @@ set(BENCHMARK_HEADERS
|
||||||
${SOURCES_DIR}/benchmark/catch_sample_analysis.hpp
|
${SOURCES_DIR}/benchmark/catch_sample_analysis.hpp
|
||||||
${SOURCES_DIR}/benchmark/detail/catch_analyse.hpp
|
${SOURCES_DIR}/benchmark/detail/catch_analyse.hpp
|
||||||
${SOURCES_DIR}/benchmark/detail/catch_benchmark_function.hpp
|
${SOURCES_DIR}/benchmark/detail/catch_benchmark_function.hpp
|
||||||
|
${SOURCES_DIR}/benchmark/detail/catch_benchmark_stats.hpp
|
||||||
|
${SOURCES_DIR}/benchmark/detail/catch_benchmark_stats_fwd.hpp
|
||||||
${SOURCES_DIR}/benchmark/detail/catch_complete_invoke.hpp
|
${SOURCES_DIR}/benchmark/detail/catch_complete_invoke.hpp
|
||||||
${SOURCES_DIR}/benchmark/detail/catch_estimate_clock.hpp
|
${SOURCES_DIR}/benchmark/detail/catch_estimate_clock.hpp
|
||||||
${SOURCES_DIR}/benchmark/detail/catch_measure.hpp
|
${SOURCES_DIR}/benchmark/detail/catch_measure.hpp
|
||||||
|
@ -31,6 +33,7 @@ set(BENCHMARK_HEADERS
|
||||||
)
|
)
|
||||||
set(BENCHMARK_SOURCES
|
set(BENCHMARK_SOURCES
|
||||||
${SOURCES_DIR}/benchmark/catch_chronometer.cpp
|
${SOURCES_DIR}/benchmark/catch_chronometer.cpp
|
||||||
|
${SOURCES_DIR}/benchmark/detail/catch_analyse.cpp
|
||||||
${SOURCES_DIR}/benchmark/detail/catch_benchmark_function.cpp
|
${SOURCES_DIR}/benchmark/detail/catch_benchmark_function.cpp
|
||||||
${SOURCES_DIR}/benchmark/detail/catch_run_for_at_least.cpp
|
${SOURCES_DIR}/benchmark/detail/catch_run_for_at_least.cpp
|
||||||
${SOURCES_DIR}/benchmark/detail/catch_stats.cpp
|
${SOURCES_DIR}/benchmark/detail/catch_stats.cpp
|
||||||
|
@ -39,7 +42,7 @@ set(BENCHMARK_FILES ${BENCHMARK_HEADERS} ${BENCHMARK_SOURCES})
|
||||||
|
|
||||||
|
|
||||||
set(IMPL_HEADERS
|
set(IMPL_HEADERS
|
||||||
"${CMAKE_BINARY_DIR}/generated-includes/catch2/catch_user_config.hpp"
|
"${PROJECT_BINARY_DIR}/generated-includes/catch2/catch_user_config.hpp"
|
||||||
${SOURCES_DIR}/catch_user_config.hpp.in
|
${SOURCES_DIR}/catch_user_config.hpp.in
|
||||||
${SOURCES_DIR}/catch_all.hpp
|
${SOURCES_DIR}/catch_all.hpp
|
||||||
${SOURCES_DIR}/catch_approx.hpp
|
${SOURCES_DIR}/catch_approx.hpp
|
||||||
|
@ -71,6 +74,7 @@ set(IMPL_HEADERS
|
||||||
${SOURCES_DIR}/internal/catch_compiler_capabilities.hpp
|
${SOURCES_DIR}/internal/catch_compiler_capabilities.hpp
|
||||||
${SOURCES_DIR}/internal/catch_config_android_logwrite.hpp
|
${SOURCES_DIR}/internal/catch_config_android_logwrite.hpp
|
||||||
${SOURCES_DIR}/internal/catch_config_counter.hpp
|
${SOURCES_DIR}/internal/catch_config_counter.hpp
|
||||||
|
${SOURCES_DIR}/internal/catch_config_static_analysis_support.hpp
|
||||||
${SOURCES_DIR}/internal/catch_config_uncaught_exceptions.hpp
|
${SOURCES_DIR}/internal/catch_config_uncaught_exceptions.hpp
|
||||||
${SOURCES_DIR}/internal/catch_config_wchar.hpp
|
${SOURCES_DIR}/internal/catch_config_wchar.hpp
|
||||||
${SOURCES_DIR}/internal/catch_console_colour.hpp
|
${SOURCES_DIR}/internal/catch_console_colour.hpp
|
||||||
|
@ -88,6 +92,8 @@ set(IMPL_HEADERS
|
||||||
${SOURCES_DIR}/internal/catch_floating_point_helpers.hpp
|
${SOURCES_DIR}/internal/catch_floating_point_helpers.hpp
|
||||||
${SOURCES_DIR}/internal/catch_getenv.hpp
|
${SOURCES_DIR}/internal/catch_getenv.hpp
|
||||||
${SOURCES_DIR}/internal/catch_istream.hpp
|
${SOURCES_DIR}/internal/catch_istream.hpp
|
||||||
|
${SOURCES_DIR}/internal/catch_is_permutation.hpp
|
||||||
|
${SOURCES_DIR}/internal/catch_jsonwriter.hpp
|
||||||
${SOURCES_DIR}/internal/catch_lazy_expr.hpp
|
${SOURCES_DIR}/internal/catch_lazy_expr.hpp
|
||||||
${SOURCES_DIR}/internal/catch_leak_detector.hpp
|
${SOURCES_DIR}/internal/catch_leak_detector.hpp
|
||||||
${SOURCES_DIR}/internal/catch_list.hpp
|
${SOURCES_DIR}/internal/catch_list.hpp
|
||||||
|
@ -103,6 +109,8 @@ set(IMPL_HEADERS
|
||||||
${SOURCES_DIR}/internal/catch_polyfills.hpp
|
${SOURCES_DIR}/internal/catch_polyfills.hpp
|
||||||
${SOURCES_DIR}/internal/catch_preprocessor.hpp
|
${SOURCES_DIR}/internal/catch_preprocessor.hpp
|
||||||
${SOURCES_DIR}/internal/catch_preprocessor_remove_parens.hpp
|
${SOURCES_DIR}/internal/catch_preprocessor_remove_parens.hpp
|
||||||
|
${SOURCES_DIR}/internal/catch_random_floating_point_helpers.hpp
|
||||||
|
${SOURCES_DIR}/internal/catch_random_integer_helpers.hpp
|
||||||
${SOURCES_DIR}/internal/catch_random_number_generator.hpp
|
${SOURCES_DIR}/internal/catch_random_number_generator.hpp
|
||||||
${SOURCES_DIR}/internal/catch_random_seed_generation.hpp
|
${SOURCES_DIR}/internal/catch_random_seed_generation.hpp
|
||||||
${SOURCES_DIR}/internal/catch_reporter_registry.hpp
|
${SOURCES_DIR}/internal/catch_reporter_registry.hpp
|
||||||
|
@ -127,10 +135,13 @@ set(IMPL_HEADERS
|
||||||
${SOURCES_DIR}/internal/catch_test_failure_exception.hpp
|
${SOURCES_DIR}/internal/catch_test_failure_exception.hpp
|
||||||
${SOURCES_DIR}/internal/catch_test_macro_impl.hpp
|
${SOURCES_DIR}/internal/catch_test_macro_impl.hpp
|
||||||
${SOURCES_DIR}/internal/catch_test_registry.hpp
|
${SOURCES_DIR}/internal/catch_test_registry.hpp
|
||||||
|
${SOURCES_DIR}/internal/catch_test_run_info.hpp
|
||||||
${SOURCES_DIR}/internal/catch_test_spec_parser.hpp
|
${SOURCES_DIR}/internal/catch_test_spec_parser.hpp
|
||||||
${SOURCES_DIR}/internal/catch_textflow.hpp
|
${SOURCES_DIR}/internal/catch_textflow.hpp
|
||||||
${SOURCES_DIR}/internal/catch_to_string.hpp
|
${SOURCES_DIR}/internal/catch_to_string.hpp
|
||||||
${SOURCES_DIR}/internal/catch_uncaught_exceptions.hpp
|
${SOURCES_DIR}/internal/catch_uncaught_exceptions.hpp
|
||||||
|
${SOURCES_DIR}/internal/catch_uniform_floating_point_distribution.hpp
|
||||||
|
${SOURCES_DIR}/internal/catch_uniform_integer_distribution.hpp
|
||||||
${SOURCES_DIR}/internal/catch_unique_name.hpp
|
${SOURCES_DIR}/internal/catch_unique_name.hpp
|
||||||
${SOURCES_DIR}/internal/catch_unique_ptr.hpp
|
${SOURCES_DIR}/internal/catch_unique_ptr.hpp
|
||||||
${SOURCES_DIR}/internal/catch_void_type.hpp
|
${SOURCES_DIR}/internal/catch_void_type.hpp
|
||||||
|
@ -152,6 +163,7 @@ set(IMPL_SOURCES
|
||||||
${SOURCES_DIR}/catch_timer.cpp
|
${SOURCES_DIR}/catch_timer.cpp
|
||||||
${SOURCES_DIR}/catch_tostring.cpp
|
${SOURCES_DIR}/catch_tostring.cpp
|
||||||
${SOURCES_DIR}/catch_totals.cpp
|
${SOURCES_DIR}/catch_totals.cpp
|
||||||
|
${SOURCES_DIR}/catch_translate_exception.cpp
|
||||||
${SOURCES_DIR}/catch_version.cpp
|
${SOURCES_DIR}/catch_version.cpp
|
||||||
${SOURCES_DIR}/internal/catch_assertion_handler.cpp
|
${SOURCES_DIR}/internal/catch_assertion_handler.cpp
|
||||||
${SOURCES_DIR}/internal/catch_case_insensitive_comparisons.cpp
|
${SOURCES_DIR}/internal/catch_case_insensitive_comparisons.cpp
|
||||||
|
@ -170,6 +182,7 @@ set(IMPL_SOURCES
|
||||||
${SOURCES_DIR}/internal/catch_floating_point_helpers.cpp
|
${SOURCES_DIR}/internal/catch_floating_point_helpers.cpp
|
||||||
${SOURCES_DIR}/internal/catch_getenv.cpp
|
${SOURCES_DIR}/internal/catch_getenv.cpp
|
||||||
${SOURCES_DIR}/internal/catch_istream.cpp
|
${SOURCES_DIR}/internal/catch_istream.cpp
|
||||||
|
${SOURCES_DIR}/internal/catch_jsonwriter.cpp
|
||||||
${SOURCES_DIR}/internal/catch_lazy_expr.cpp
|
${SOURCES_DIR}/internal/catch_lazy_expr.cpp
|
||||||
${SOURCES_DIR}/internal/catch_leak_detector.cpp
|
${SOURCES_DIR}/internal/catch_leak_detector.cpp
|
||||||
${SOURCES_DIR}/internal/catch_list.cpp
|
${SOURCES_DIR}/internal/catch_list.cpp
|
||||||
|
@ -215,8 +228,8 @@ set(INTERFACE_HEADERS
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_registry_hub.hpp
|
${SOURCES_DIR}/interfaces/catch_interfaces_registry_hub.hpp
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_reporter.hpp
|
${SOURCES_DIR}/interfaces/catch_interfaces_reporter.hpp
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_reporter_factory.hpp
|
${SOURCES_DIR}/interfaces/catch_interfaces_reporter_factory.hpp
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_reporter_registry.hpp
|
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_tag_alias_registry.hpp
|
${SOURCES_DIR}/interfaces/catch_interfaces_tag_alias_registry.hpp
|
||||||
|
${SOURCES_DIR}/interfaces/catch_interfaces_test_invoker.hpp
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_testcase.hpp
|
${SOURCES_DIR}/interfaces/catch_interfaces_testcase.hpp
|
||||||
)
|
)
|
||||||
set(INTERFACE_SOURCES
|
set(INTERFACE_SOURCES
|
||||||
|
@ -227,7 +240,6 @@ set(INTERFACE_SOURCES
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_registry_hub.cpp
|
${SOURCES_DIR}/interfaces/catch_interfaces_registry_hub.cpp
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_reporter.cpp
|
${SOURCES_DIR}/interfaces/catch_interfaces_reporter.cpp
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_reporter_factory.cpp
|
${SOURCES_DIR}/interfaces/catch_interfaces_reporter_factory.cpp
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_reporter_registry.cpp
|
|
||||||
${SOURCES_DIR}/interfaces/catch_interfaces_testcase.cpp
|
${SOURCES_DIR}/interfaces/catch_interfaces_testcase.cpp
|
||||||
)
|
)
|
||||||
set(INTERFACE_FILES ${INTERFACE_HEADERS} ${INTERFACE_SOURCES})
|
set(INTERFACE_FILES ${INTERFACE_HEADERS} ${INTERFACE_SOURCES})
|
||||||
|
@ -252,6 +264,7 @@ set(MATCHER_HEADERS
|
||||||
${SOURCES_DIR}/matchers/catch_matchers_all.hpp
|
${SOURCES_DIR}/matchers/catch_matchers_all.hpp
|
||||||
${SOURCES_DIR}/matchers/catch_matchers_container_properties.hpp
|
${SOURCES_DIR}/matchers/catch_matchers_container_properties.hpp
|
||||||
${SOURCES_DIR}/matchers/catch_matchers_contains.hpp
|
${SOURCES_DIR}/matchers/catch_matchers_contains.hpp
|
||||||
|
${SOURCES_DIR}/matchers/catch_matchers_range_equals.hpp
|
||||||
${SOURCES_DIR}/matchers/catch_matchers_exception.hpp
|
${SOURCES_DIR}/matchers/catch_matchers_exception.hpp
|
||||||
${SOURCES_DIR}/matchers/catch_matchers_floating_point.hpp
|
${SOURCES_DIR}/matchers/catch_matchers_floating_point.hpp
|
||||||
${SOURCES_DIR}/matchers/catch_matchers_predicate.hpp
|
${SOURCES_DIR}/matchers/catch_matchers_predicate.hpp
|
||||||
|
@ -282,6 +295,7 @@ set(REPORTER_HEADERS
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_cumulative_base.hpp
|
${SOURCES_DIR}/reporters/catch_reporter_cumulative_base.hpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_event_listener.hpp
|
${SOURCES_DIR}/reporters/catch_reporter_event_listener.hpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_helpers.hpp
|
${SOURCES_DIR}/reporters/catch_reporter_helpers.hpp
|
||||||
|
${SOURCES_DIR}/reporters/catch_reporter_json.hpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_junit.hpp
|
${SOURCES_DIR}/reporters/catch_reporter_junit.hpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_multi.hpp
|
${SOURCES_DIR}/reporters/catch_reporter_multi.hpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_registrars.hpp
|
${SOURCES_DIR}/reporters/catch_reporter_registrars.hpp
|
||||||
|
@ -300,6 +314,7 @@ set(REPORTER_SOURCES
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_cumulative_base.cpp
|
${SOURCES_DIR}/reporters/catch_reporter_cumulative_base.cpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_event_listener.cpp
|
${SOURCES_DIR}/reporters/catch_reporter_event_listener.cpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_helpers.cpp
|
${SOURCES_DIR}/reporters/catch_reporter_helpers.cpp
|
||||||
|
${SOURCES_DIR}/reporters/catch_reporter_json.cpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_junit.cpp
|
${SOURCES_DIR}/reporters/catch_reporter_junit.cpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_multi.cpp
|
${SOURCES_DIR}/reporters/catch_reporter_multi.cpp
|
||||||
${SOURCES_DIR}/reporters/catch_reporter_registrars.cpp
|
${SOURCES_DIR}/reporters/catch_reporter_registrars.cpp
|
||||||
|
@ -321,7 +336,7 @@ set(ALL_FILES
|
||||||
)
|
)
|
||||||
|
|
||||||
set(FILTERED_FILES ${ALL_FILES})
|
set(FILTERED_FILES ${ALL_FILES})
|
||||||
list(REMOVE_ITEM FILTERED_FILES "${CMAKE_BINARY_DIR}/generated-includes/catch2/catch_user_config.hpp")
|
list(REMOVE_ITEM FILTERED_FILES "${PROJECT_BINARY_DIR}/generated-includes/catch2/catch_user_config.hpp")
|
||||||
source_group(
|
source_group(
|
||||||
TREE ${SOURCES_DIR}
|
TREE ${SOURCES_DIR}
|
||||||
PREFIX sources
|
PREFIX sources
|
||||||
|
@ -329,7 +344,7 @@ source_group(
|
||||||
)
|
)
|
||||||
source_group("generated headers"
|
source_group("generated headers"
|
||||||
FILES
|
FILES
|
||||||
"${CMAKE_BINARY_DIR}/generated-includes/catch2/catch_user_config.hpp"
|
"${PROJECT_BINARY_DIR}/generated-includes/catch2/catch_user_config.hpp"
|
||||||
)
|
)
|
||||||
|
|
||||||
add_library(Catch2 ${ALL_FILES})
|
add_library(Catch2 ${ALL_FILES})
|
||||||
|
@ -372,13 +387,13 @@ target_compile_features(Catch2
|
||||||
|
|
||||||
configure_file(
|
configure_file(
|
||||||
"${SOURCES_DIR}/catch_user_config.hpp.in"
|
"${SOURCES_DIR}/catch_user_config.hpp.in"
|
||||||
"${CMAKE_BINARY_DIR}/generated-includes/catch2/catch_user_config.hpp"
|
"${PROJECT_BINARY_DIR}/generated-includes/catch2/catch_user_config.hpp"
|
||||||
)
|
)
|
||||||
|
|
||||||
target_include_directories(Catch2
|
target_include_directories(Catch2
|
||||||
PUBLIC
|
PUBLIC
|
||||||
$<BUILD_INTERFACE:${SOURCES_DIR}/..>
|
$<BUILD_INTERFACE:${SOURCES_DIR}/..>
|
||||||
$<BUILD_INTERFACE:${CMAKE_BINARY_DIR}/generated-includes>
|
$<BUILD_INTERFACE:${PROJECT_BINARY_DIR}/generated-includes>
|
||||||
$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
|
$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
|
||||||
)
|
)
|
||||||
|
|
||||||
|
@ -426,7 +441,7 @@ if (NOT_SUBPROJECT)
|
||||||
install(
|
install(
|
||||||
DIRECTORY
|
DIRECTORY
|
||||||
"${SOURCES_DIR}"
|
"${SOURCES_DIR}"
|
||||||
"${CMAKE_BINARY_DIR}/generated-includes/catch2" # Also install the generated header
|
"${PROJECT_BINARY_DIR}/generated-includes/catch2" # Also install the generated header
|
||||||
DESTINATION
|
DESTINATION
|
||||||
"${CMAKE_INSTALL_INCLUDEDIR}"
|
"${CMAKE_INSTALL_INCLUDEDIR}"
|
||||||
FILES_MATCHING
|
FILES_MATCHING
|
||||||
|
@ -447,7 +462,7 @@ if (CATCH_BUILD_EXAMPLES OR CATCH_BUILD_EXTRA_TESTS)
|
||||||
target_include_directories(Catch2_buildall_interface
|
target_include_directories(Catch2_buildall_interface
|
||||||
INTERFACE
|
INTERFACE
|
||||||
$<BUILD_INTERFACE:${SOURCES_DIR}/..>
|
$<BUILD_INTERFACE:${SOURCES_DIR}/..>
|
||||||
$<BUILD_INTERFACE:${CMAKE_BINARY_DIR}/generated-includes>
|
$<BUILD_INTERFACE:${PROJECT_BINARY_DIR}/generated-includes>
|
||||||
$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
|
$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}>
|
||||||
)
|
)
|
||||||
target_compile_definitions(Catch2_buildall_interface
|
target_compile_definitions(Catch2_buildall_interface
|
||||||
|
@ -487,12 +502,10 @@ set(CATCH_WARNING_TARGETS ${CATCH_WARNING_TARGETS} PARENT_SCOPE)
|
||||||
# so we want to check & warn users if they do this. However, we won't abort
|
# so we want to check & warn users if they do this. However, we won't abort
|
||||||
# the configuration step so that we don't have to also provide an override.
|
# the configuration step so that we don't have to also provide an override.
|
||||||
if (BUILD_SHARED_LIBS)
|
if (BUILD_SHARED_LIBS)
|
||||||
if (MSVC)
|
|
||||||
set_target_properties(Catch2 Catch2WithMain
|
set_target_properties(Catch2 Catch2WithMain
|
||||||
PROPERTIES
|
PROPERTIES
|
||||||
WINDOWS_EXPORT_ALL_SYMBOLS ON
|
WINDOWS_EXPORT_ALL_SYMBOLS ON
|
||||||
)
|
)
|
||||||
endif()
|
|
||||||
|
|
||||||
get_target_property(_VisPreset Catch2 CXX_VISIBILITY_PRESET)
|
get_target_property(_VisPreset Catch2 CXX_VISIBILITY_PRESET)
|
||||||
if (NOT MSVC AND _VisPreset STREQUAL "hidden")
|
if (NOT MSVC AND _VisPreset STREQUAL "hidden")
|
||||||
|
|
|
@ -10,26 +10,28 @@
|
||||||
#ifndef CATCH_BENCHMARK_HPP_INCLUDED
|
#ifndef CATCH_BENCHMARK_HPP_INCLUDED
|
||||||
#define CATCH_BENCHMARK_HPP_INCLUDED
|
#define CATCH_BENCHMARK_HPP_INCLUDED
|
||||||
|
|
||||||
#include <catch2/interfaces/catch_interfaces_config.hpp>
|
#include <catch2/catch_user_config.hpp>
|
||||||
#include <catch2/internal/catch_compiler_capabilities.hpp>
|
#include <catch2/internal/catch_compiler_capabilities.hpp>
|
||||||
#include <catch2/internal/catch_context.hpp>
|
#include <catch2/internal/catch_context.hpp>
|
||||||
#include <catch2/interfaces/catch_interfaces_reporter.hpp>
|
|
||||||
#include <catch2/internal/catch_unique_name.hpp>
|
|
||||||
#include <catch2/internal/catch_move_and_forward.hpp>
|
#include <catch2/internal/catch_move_and_forward.hpp>
|
||||||
#include <catch2/benchmark/catch_chronometer.hpp>
|
#include <catch2/internal/catch_test_failure_exception.hpp>
|
||||||
|
#include <catch2/internal/catch_unique_name.hpp>
|
||||||
|
#include <catch2/interfaces/catch_interfaces_capture.hpp>
|
||||||
|
#include <catch2/interfaces/catch_interfaces_config.hpp>
|
||||||
|
#include <catch2/interfaces/catch_interfaces_registry_hub.hpp>
|
||||||
|
#include <catch2/benchmark/detail/catch_benchmark_stats.hpp>
|
||||||
#include <catch2/benchmark/catch_clock.hpp>
|
#include <catch2/benchmark/catch_clock.hpp>
|
||||||
#include <catch2/benchmark/catch_environment.hpp>
|
#include <catch2/benchmark/catch_environment.hpp>
|
||||||
#include <catch2/benchmark/catch_execution_plan.hpp>
|
#include <catch2/benchmark/catch_execution_plan.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_estimate_clock.hpp>
|
#include <catch2/benchmark/detail/catch_estimate_clock.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_complete_invoke.hpp>
|
|
||||||
#include <catch2/benchmark/detail/catch_analyse.hpp>
|
#include <catch2/benchmark/detail/catch_analyse.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_benchmark_function.hpp>
|
#include <catch2/benchmark/detail/catch_benchmark_function.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_run_for_at_least.hpp>
|
#include <catch2/benchmark/detail/catch_run_for_at_least.hpp>
|
||||||
|
|
||||||
#include <algorithm>
|
#include <algorithm>
|
||||||
#include <functional>
|
#include <chrono>
|
||||||
|
#include <exception>
|
||||||
#include <string>
|
#include <string>
|
||||||
#include <vector>
|
|
||||||
#include <cmath>
|
#include <cmath>
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
|
@ -43,16 +45,18 @@ namespace Catch {
|
||||||
: fun(CATCH_MOVE(func)), name(CATCH_MOVE(benchmarkName)) {}
|
: fun(CATCH_MOVE(func)), name(CATCH_MOVE(benchmarkName)) {}
|
||||||
|
|
||||||
template <typename Clock>
|
template <typename Clock>
|
||||||
ExecutionPlan<FloatDuration<Clock>> prepare(const IConfig &cfg, Environment<FloatDuration<Clock>> env) const {
|
ExecutionPlan prepare(const IConfig &cfg, Environment env) const {
|
||||||
auto min_time = env.clock_resolution.mean * Detail::minimum_ticks;
|
auto min_time = env.clock_resolution.mean * Detail::minimum_ticks;
|
||||||
auto run_time = std::max(min_time, std::chrono::duration_cast<decltype(min_time)>(cfg.benchmarkWarmupTime()));
|
auto run_time = std::max(min_time, std::chrono::duration_cast<decltype(min_time)>(cfg.benchmarkWarmupTime()));
|
||||||
auto&& test = Detail::run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(run_time), 1, fun);
|
auto&& test = Detail::run_for_at_least<Clock>(std::chrono::duration_cast<IDuration>(run_time), 1, fun);
|
||||||
int new_iters = static_cast<int>(std::ceil(min_time * test.iterations / test.elapsed));
|
int new_iters = static_cast<int>(std::ceil(min_time * test.iterations / test.elapsed));
|
||||||
return { new_iters, test.elapsed / test.iterations * new_iters * cfg.benchmarkSamples(), fun, std::chrono::duration_cast<FloatDuration<Clock>>(cfg.benchmarkWarmupTime()), Detail::warmup_iterations };
|
return { new_iters, test.elapsed / test.iterations * new_iters * cfg.benchmarkSamples(), fun, std::chrono::duration_cast<FDuration>(cfg.benchmarkWarmupTime()), Detail::warmup_iterations };
|
||||||
}
|
}
|
||||||
|
|
||||||
template <typename Clock = default_clock>
|
template <typename Clock = default_clock>
|
||||||
void run() {
|
void run() {
|
||||||
|
static_assert( Clock::is_steady,
|
||||||
|
"Benchmarking clock should be steady" );
|
||||||
auto const* cfg = getCurrentContext().getConfig();
|
auto const* cfg = getCurrentContext().getConfig();
|
||||||
|
|
||||||
auto env = Detail::measure_environment<Clock>();
|
auto env = Detail::measure_environment<Clock>();
|
||||||
|
@ -64,7 +68,7 @@ namespace Catch {
|
||||||
});
|
});
|
||||||
|
|
||||||
BenchmarkInfo info {
|
BenchmarkInfo info {
|
||||||
name,
|
CATCH_MOVE(name),
|
||||||
plan.estimated_duration.count(),
|
plan.estimated_duration.count(),
|
||||||
plan.iterations_per_sample,
|
plan.iterations_per_sample,
|
||||||
cfg->benchmarkSamples(),
|
cfg->benchmarkSamples(),
|
||||||
|
@ -79,10 +83,10 @@ namespace Catch {
|
||||||
return plan.template run<Clock>(*cfg, env);
|
return plan.template run<Clock>(*cfg, env);
|
||||||
});
|
});
|
||||||
|
|
||||||
auto analysis = Detail::analyse(*cfg, env, samples.begin(), samples.end());
|
auto analysis = Detail::analyse(*cfg, samples.data(), samples.data() + samples.size());
|
||||||
BenchmarkStats<FloatDuration<Clock>> stats{ info, analysis.samples, analysis.mean, analysis.standard_deviation, analysis.outliers, analysis.outlier_variance };
|
BenchmarkStats<> stats{ CATCH_MOVE(info), CATCH_MOVE(analysis.samples), analysis.mean, analysis.standard_deviation, analysis.outliers, analysis.outlier_variance };
|
||||||
getResultCapture().benchmarkEnded(stats);
|
getResultCapture().benchmarkEnded(stats);
|
||||||
} CATCH_CATCH_ANON (TestFailureException) {
|
} CATCH_CATCH_ANON (TestFailureException const&) {
|
||||||
getResultCapture().benchmarkFailed("Benchmark failed due to failed assertion"_sr);
|
getResultCapture().benchmarkFailed("Benchmark failed due to failed assertion"_sr);
|
||||||
} CATCH_CATCH_ALL{
|
} CATCH_CATCH_ALL{
|
||||||
getResultCapture().benchmarkFailed(translateActiveException());
|
getResultCapture().benchmarkFailed(translateActiveException());
|
||||||
|
|
|
@ -33,6 +33,8 @@
|
||||||
#include <catch2/benchmark/catch_sample_analysis.hpp>
|
#include <catch2/benchmark/catch_sample_analysis.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_analyse.hpp>
|
#include <catch2/benchmark/detail/catch_analyse.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_benchmark_function.hpp>
|
#include <catch2/benchmark/detail/catch_benchmark_function.hpp>
|
||||||
|
#include <catch2/benchmark/detail/catch_benchmark_stats.hpp>
|
||||||
|
#include <catch2/benchmark/detail/catch_benchmark_stats_fwd.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_complete_invoke.hpp>
|
#include <catch2/benchmark/detail/catch_complete_invoke.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_estimate_clock.hpp>
|
#include <catch2/benchmark/detail/catch_estimate_clock.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_measure.hpp>
|
#include <catch2/benchmark/detail/catch_measure.hpp>
|
||||||
|
|
|
@ -12,7 +12,6 @@
|
||||||
|
|
||||||
#include <catch2/benchmark/catch_clock.hpp>
|
#include <catch2/benchmark/catch_clock.hpp>
|
||||||
#include <catch2/benchmark/catch_optimizer.hpp>
|
#include <catch2/benchmark/catch_optimizer.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_complete_invoke.hpp>
|
|
||||||
#include <catch2/internal/catch_meta.hpp>
|
#include <catch2/internal/catch_meta.hpp>
|
||||||
#include <catch2/internal/catch_move_and_forward.hpp>
|
#include <catch2/internal/catch_move_and_forward.hpp>
|
||||||
|
|
||||||
|
@ -33,7 +32,10 @@ namespace Catch {
|
||||||
void start() override { started = Clock::now(); }
|
void start() override { started = Clock::now(); }
|
||||||
void finish() override { finished = Clock::now(); }
|
void finish() override { finished = Clock::now(); }
|
||||||
|
|
||||||
ClockDuration<Clock> elapsed() const { return finished - started; }
|
IDuration elapsed() const {
|
||||||
|
return std::chrono::duration_cast<std::chrono::nanoseconds>(
|
||||||
|
finished - started );
|
||||||
|
}
|
||||||
|
|
||||||
TimePoint<Clock> started;
|
TimePoint<Clock> started;
|
||||||
TimePoint<Clock> finished;
|
TimePoint<Clock> finished;
|
||||||
|
|
|
@ -11,28 +11,16 @@
|
||||||
#define CATCH_CLOCK_HPP_INCLUDED
|
#define CATCH_CLOCK_HPP_INCLUDED
|
||||||
|
|
||||||
#include <chrono>
|
#include <chrono>
|
||||||
#include <ratio>
|
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
template <typename Clock>
|
using IDuration = std::chrono::nanoseconds;
|
||||||
using ClockDuration = typename Clock::duration;
|
using FDuration = std::chrono::duration<double, std::nano>;
|
||||||
template <typename Clock>
|
|
||||||
using FloatDuration = std::chrono::duration<double, typename Clock::period>;
|
|
||||||
|
|
||||||
template <typename Clock>
|
template <typename Clock>
|
||||||
using TimePoint = typename Clock::time_point;
|
using TimePoint = typename Clock::time_point;
|
||||||
|
|
||||||
using default_clock = std::chrono::steady_clock;
|
using default_clock = std::chrono::steady_clock;
|
||||||
|
|
||||||
template <typename Clock>
|
|
||||||
struct now {
|
|
||||||
TimePoint<Clock> operator()() const {
|
|
||||||
return Clock::now();
|
|
||||||
}
|
|
||||||
};
|
|
||||||
|
|
||||||
using fp_seconds = std::chrono::duration<double, std::ratio<1>>;
|
|
||||||
} // namespace Benchmark
|
} // namespace Benchmark
|
||||||
} // namespace Catch
|
} // namespace Catch
|
||||||
|
|
||||||
|
|
|
@ -15,21 +15,13 @@
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
template <typename Duration>
|
|
||||||
struct EnvironmentEstimate {
|
struct EnvironmentEstimate {
|
||||||
Duration mean;
|
FDuration mean;
|
||||||
OutlierClassification outliers;
|
OutlierClassification outliers;
|
||||||
|
|
||||||
template <typename Duration2>
|
|
||||||
operator EnvironmentEstimate<Duration2>() const {
|
|
||||||
return { mean, outliers };
|
|
||||||
}
|
|
||||||
};
|
};
|
||||||
template <typename Clock>
|
|
||||||
struct Environment {
|
struct Environment {
|
||||||
using clock_type = Clock;
|
EnvironmentEstimate clock_resolution;
|
||||||
EnvironmentEstimate<FloatDuration<Clock>> clock_resolution;
|
EnvironmentEstimate clock_cost;
|
||||||
EnvironmentEstimate<FloatDuration<Clock>> clock_cost;
|
|
||||||
};
|
};
|
||||||
} // namespace Benchmark
|
} // namespace Benchmark
|
||||||
} // namespace Catch
|
} // namespace Catch
|
||||||
|
|
|
@ -12,17 +12,12 @@
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
template <typename Duration>
|
template <typename Type>
|
||||||
struct Estimate {
|
struct Estimate {
|
||||||
Duration point;
|
Type point;
|
||||||
Duration lower_bound;
|
Type lower_bound;
|
||||||
Duration upper_bound;
|
Type upper_bound;
|
||||||
double confidence_interval;
|
double confidence_interval;
|
||||||
|
|
||||||
template <typename Duration2>
|
|
||||||
operator Estimate<Duration2>() const {
|
|
||||||
return { point, lower_bound, upper_bound, confidence_interval };
|
|
||||||
}
|
|
||||||
};
|
};
|
||||||
} // namespace Benchmark
|
} // namespace Benchmark
|
||||||
} // namespace Catch
|
} // namespace Catch
|
||||||
|
|
|
@ -17,38 +17,38 @@
|
||||||
#include <catch2/benchmark/detail/catch_repeat.hpp>
|
#include <catch2/benchmark/detail/catch_repeat.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_run_for_at_least.hpp>
|
#include <catch2/benchmark/detail/catch_run_for_at_least.hpp>
|
||||||
|
|
||||||
#include <algorithm>
|
#include <vector>
|
||||||
#include <iterator>
|
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
template <typename Duration>
|
|
||||||
struct ExecutionPlan {
|
struct ExecutionPlan {
|
||||||
int iterations_per_sample;
|
int iterations_per_sample;
|
||||||
Duration estimated_duration;
|
FDuration estimated_duration;
|
||||||
Detail::BenchmarkFunction benchmark;
|
Detail::BenchmarkFunction benchmark;
|
||||||
Duration warmup_time;
|
FDuration warmup_time;
|
||||||
int warmup_iterations;
|
int warmup_iterations;
|
||||||
|
|
||||||
template <typename Duration2>
|
|
||||||
operator ExecutionPlan<Duration2>() const {
|
|
||||||
return { iterations_per_sample, estimated_duration, benchmark, warmup_time, warmup_iterations };
|
|
||||||
}
|
|
||||||
|
|
||||||
template <typename Clock>
|
template <typename Clock>
|
||||||
std::vector<FloatDuration<Clock>> run(const IConfig &cfg, Environment<FloatDuration<Clock>> env) const {
|
std::vector<FDuration> run(const IConfig &cfg, Environment env) const {
|
||||||
// warmup a bit
|
// warmup a bit
|
||||||
Detail::run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(warmup_time), warmup_iterations, Detail::repeat(now<Clock>{}));
|
Detail::run_for_at_least<Clock>(
|
||||||
|
std::chrono::duration_cast<IDuration>( warmup_time ),
|
||||||
|
warmup_iterations,
|
||||||
|
Detail::repeat( []() { return Clock::now(); } )
|
||||||
|
);
|
||||||
|
|
||||||
std::vector<FloatDuration<Clock>> times;
|
std::vector<FDuration> times;
|
||||||
times.reserve(cfg.benchmarkSamples());
|
const auto num_samples = cfg.benchmarkSamples();
|
||||||
std::generate_n(std::back_inserter(times), cfg.benchmarkSamples(), [this, env] {
|
times.reserve( num_samples );
|
||||||
|
for ( size_t i = 0; i < num_samples; ++i ) {
|
||||||
Detail::ChronometerModel<Clock> model;
|
Detail::ChronometerModel<Clock> model;
|
||||||
this->benchmark(Chronometer(model, iterations_per_sample));
|
this->benchmark( Chronometer( model, iterations_per_sample ) );
|
||||||
auto sample_time = model.elapsed() - env.clock_cost.mean;
|
auto sample_time = model.elapsed() - env.clock_cost.mean;
|
||||||
if (sample_time < FloatDuration<Clock>::zero()) sample_time = FloatDuration<Clock>::zero();
|
if ( sample_time < FDuration::zero() ) {
|
||||||
return sample_time / iterations_per_sample;
|
sample_time = FDuration::zero();
|
||||||
});
|
}
|
||||||
|
times.push_back(sample_time / iterations_per_sample);
|
||||||
|
}
|
||||||
return times;
|
return times;
|
||||||
}
|
}
|
||||||
};
|
};
|
||||||
|
|
|
@ -10,7 +10,7 @@
|
||||||
#ifndef CATCH_OPTIMIZER_HPP_INCLUDED
|
#ifndef CATCH_OPTIMIZER_HPP_INCLUDED
|
||||||
#define CATCH_OPTIMIZER_HPP_INCLUDED
|
#define CATCH_OPTIMIZER_HPP_INCLUDED
|
||||||
|
|
||||||
#if defined(_MSC_VER)
|
#if defined(_MSC_VER) || defined(__IAR_SYSTEMS_ICC__)
|
||||||
# include <atomic> // atomic_thread_fence
|
# include <atomic> // atomic_thread_fence
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
|
@ -32,16 +32,23 @@ namespace Catch {
|
||||||
namespace Detail {
|
namespace Detail {
|
||||||
inline void optimizer_barrier() { keep_memory(); }
|
inline void optimizer_barrier() { keep_memory(); }
|
||||||
} // namespace Detail
|
} // namespace Detail
|
||||||
#elif defined(_MSC_VER)
|
#elif defined(_MSC_VER) || defined(__IAR_SYSTEMS_ICC__)
|
||||||
|
|
||||||
|
#if defined(_MSVC_VER)
|
||||||
#pragma optimize("", off)
|
#pragma optimize("", off)
|
||||||
|
#elif defined(__IAR_SYSTEMS_ICC__)
|
||||||
|
// For IAR the pragma only affects the following function
|
||||||
|
#pragma optimize=disable
|
||||||
|
#endif
|
||||||
template <typename T>
|
template <typename T>
|
||||||
inline void keep_memory(T* p) {
|
inline void keep_memory(T* p) {
|
||||||
// thanks @milleniumbug
|
// thanks @milleniumbug
|
||||||
*reinterpret_cast<char volatile*>(p) = *reinterpret_cast<char const volatile*>(p);
|
*reinterpret_cast<char volatile*>(p) = *reinterpret_cast<char const volatile*>(p);
|
||||||
}
|
}
|
||||||
// TODO equivalent keep_memory()
|
// TODO equivalent keep_memory()
|
||||||
|
#if defined(_MSVC_VER)
|
||||||
#pragma optimize("", on)
|
#pragma optimize("", on)
|
||||||
|
#endif
|
||||||
|
|
||||||
namespace Detail {
|
namespace Detail {
|
||||||
inline void optimizer_barrier() {
|
inline void optimizer_barrier() {
|
||||||
|
@ -63,7 +70,7 @@ namespace Catch {
|
||||||
|
|
||||||
template <typename Fn, typename... Args>
|
template <typename Fn, typename... Args>
|
||||||
inline auto invoke_deoptimized(Fn&& fn, Args&&... args) -> std::enable_if_t<std::is_same<void, decltype(fn(args...))>::value> {
|
inline auto invoke_deoptimized(Fn&& fn, Args&&... args) -> std::enable_if_t<std::is_same<void, decltype(fn(args...))>::value> {
|
||||||
CATCH_FORWARD(fn) (CATCH_FORWARD(args)...);
|
CATCH_FORWARD((fn)) (CATCH_FORWARD(args)...);
|
||||||
}
|
}
|
||||||
} // namespace Benchmark
|
} // namespace Benchmark
|
||||||
} // namespace Catch
|
} // namespace Catch
|
||||||
|
|
|
@ -10,38 +10,20 @@
|
||||||
#ifndef CATCH_SAMPLE_ANALYSIS_HPP_INCLUDED
|
#ifndef CATCH_SAMPLE_ANALYSIS_HPP_INCLUDED
|
||||||
#define CATCH_SAMPLE_ANALYSIS_HPP_INCLUDED
|
#define CATCH_SAMPLE_ANALYSIS_HPP_INCLUDED
|
||||||
|
|
||||||
#include <catch2/benchmark/catch_clock.hpp>
|
|
||||||
#include <catch2/benchmark/catch_estimate.hpp>
|
#include <catch2/benchmark/catch_estimate.hpp>
|
||||||
#include <catch2/benchmark/catch_outlier_classification.hpp>
|
#include <catch2/benchmark/catch_outlier_classification.hpp>
|
||||||
#include <catch2/internal/catch_move_and_forward.hpp>
|
#include <catch2/benchmark/catch_clock.hpp>
|
||||||
|
|
||||||
#include <algorithm>
|
|
||||||
#include <vector>
|
#include <vector>
|
||||||
#include <iterator>
|
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
template <typename Duration>
|
|
||||||
struct SampleAnalysis {
|
struct SampleAnalysis {
|
||||||
std::vector<Duration> samples;
|
std::vector<FDuration> samples;
|
||||||
Estimate<Duration> mean;
|
Estimate<FDuration> mean;
|
||||||
Estimate<Duration> standard_deviation;
|
Estimate<FDuration> standard_deviation;
|
||||||
OutlierClassification outliers;
|
OutlierClassification outliers;
|
||||||
double outlier_variance;
|
double outlier_variance;
|
||||||
|
|
||||||
template <typename Duration2>
|
|
||||||
operator SampleAnalysis<Duration2>() const {
|
|
||||||
std::vector<Duration2> samples2;
|
|
||||||
samples2.reserve(samples.size());
|
|
||||||
std::transform(samples.begin(), samples.end(), std::back_inserter(samples2), [](Duration d) { return Duration2(d); });
|
|
||||||
return {
|
|
||||||
CATCH_MOVE(samples2),
|
|
||||||
mean,
|
|
||||||
standard_deviation,
|
|
||||||
outliers,
|
|
||||||
outlier_variance,
|
|
||||||
};
|
|
||||||
}
|
|
||||||
};
|
};
|
||||||
} // namespace Benchmark
|
} // namespace Benchmark
|
||||||
} // namespace Catch
|
} // namespace Catch
|
||||||
|
|
85
externals/catch/src/catch2/benchmark/detail/catch_analyse.cpp
vendored
Normal file
85
externals/catch/src/catch2/benchmark/detail/catch_analyse.cpp
vendored
Normal file
|
@ -0,0 +1,85 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
// Adapted from donated nonius code.
|
||||||
|
|
||||||
|
#include <catch2/benchmark/detail/catch_analyse.hpp>
|
||||||
|
#include <catch2/benchmark/catch_clock.hpp>
|
||||||
|
#include <catch2/benchmark/catch_sample_analysis.hpp>
|
||||||
|
#include <catch2/benchmark/detail/catch_stats.hpp>
|
||||||
|
#include <catch2/interfaces/catch_interfaces_config.hpp>
|
||||||
|
#include <catch2/internal/catch_move_and_forward.hpp>
|
||||||
|
|
||||||
|
#include <vector>
|
||||||
|
|
||||||
|
namespace Catch {
|
||||||
|
namespace Benchmark {
|
||||||
|
namespace Detail {
|
||||||
|
SampleAnalysis analyse(const IConfig &cfg, FDuration* first, FDuration* last) {
|
||||||
|
if (!cfg.benchmarkNoAnalysis()) {
|
||||||
|
std::vector<double> samples;
|
||||||
|
samples.reserve(static_cast<size_t>(last - first));
|
||||||
|
for (auto current = first; current != last; ++current) {
|
||||||
|
samples.push_back( current->count() );
|
||||||
|
}
|
||||||
|
|
||||||
|
auto analysis = Catch::Benchmark::Detail::analyse_samples(
|
||||||
|
cfg.benchmarkConfidenceInterval(),
|
||||||
|
cfg.benchmarkResamples(),
|
||||||
|
samples.data(),
|
||||||
|
samples.data() + samples.size() );
|
||||||
|
auto outliers = Catch::Benchmark::Detail::classify_outliers(
|
||||||
|
samples.data(), samples.data() + samples.size() );
|
||||||
|
|
||||||
|
auto wrap_estimate = [](Estimate<double> e) {
|
||||||
|
return Estimate<FDuration> {
|
||||||
|
FDuration(e.point),
|
||||||
|
FDuration(e.lower_bound),
|
||||||
|
FDuration(e.upper_bound),
|
||||||
|
e.confidence_interval,
|
||||||
|
};
|
||||||
|
};
|
||||||
|
std::vector<FDuration> samples2;
|
||||||
|
samples2.reserve(samples.size());
|
||||||
|
for (auto s : samples) {
|
||||||
|
samples2.push_back( FDuration( s ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
CATCH_MOVE(samples2),
|
||||||
|
wrap_estimate(analysis.mean),
|
||||||
|
wrap_estimate(analysis.standard_deviation),
|
||||||
|
outliers,
|
||||||
|
analysis.outlier_variance,
|
||||||
|
};
|
||||||
|
} else {
|
||||||
|
std::vector<FDuration> samples;
|
||||||
|
samples.reserve(static_cast<size_t>(last - first));
|
||||||
|
|
||||||
|
FDuration mean = FDuration(0);
|
||||||
|
int i = 0;
|
||||||
|
for (auto it = first; it < last; ++it, ++i) {
|
||||||
|
samples.push_back(FDuration(*it));
|
||||||
|
mean += FDuration(*it);
|
||||||
|
}
|
||||||
|
mean /= i;
|
||||||
|
|
||||||
|
return SampleAnalysis{
|
||||||
|
CATCH_MOVE(samples),
|
||||||
|
Estimate<FDuration>{ mean, mean, mean, 0.0 },
|
||||||
|
Estimate<FDuration>{ FDuration( 0 ),
|
||||||
|
FDuration( 0 ),
|
||||||
|
FDuration( 0 ),
|
||||||
|
0.0 },
|
||||||
|
OutlierClassification{},
|
||||||
|
0.0
|
||||||
|
};
|
||||||
|
}
|
||||||
|
}
|
||||||
|
} // namespace Detail
|
||||||
|
} // namespace Benchmark
|
||||||
|
} // namespace Catch
|
|
@ -11,68 +11,15 @@
|
||||||
#define CATCH_ANALYSE_HPP_INCLUDED
|
#define CATCH_ANALYSE_HPP_INCLUDED
|
||||||
|
|
||||||
#include <catch2/benchmark/catch_clock.hpp>
|
#include <catch2/benchmark/catch_clock.hpp>
|
||||||
#include <catch2/benchmark/catch_environment.hpp>
|
|
||||||
#include <catch2/benchmark/catch_sample_analysis.hpp>
|
#include <catch2/benchmark/catch_sample_analysis.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_stats.hpp>
|
|
||||||
#include <catch2/interfaces/catch_interfaces_config.hpp>
|
|
||||||
#include <catch2/internal/catch_move_and_forward.hpp>
|
|
||||||
|
|
||||||
#include <algorithm>
|
|
||||||
#include <iterator>
|
|
||||||
#include <vector>
|
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
|
class IConfig;
|
||||||
|
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
namespace Detail {
|
namespace Detail {
|
||||||
template <typename Duration, typename Iterator>
|
SampleAnalysis analyse(const IConfig &cfg, FDuration* first, FDuration* last);
|
||||||
SampleAnalysis<Duration> analyse(const IConfig &cfg, Environment<Duration>, Iterator first, Iterator last) {
|
|
||||||
if (!cfg.benchmarkNoAnalysis()) {
|
|
||||||
std::vector<double> samples;
|
|
||||||
samples.reserve(static_cast<size_t>(last - first));
|
|
||||||
std::transform(first, last, std::back_inserter(samples), [](Duration d) { return d.count(); });
|
|
||||||
|
|
||||||
auto analysis = Catch::Benchmark::Detail::analyse_samples(cfg.benchmarkConfidenceInterval(), cfg.benchmarkResamples(), samples.begin(), samples.end());
|
|
||||||
auto outliers = Catch::Benchmark::Detail::classify_outliers(samples.begin(), samples.end());
|
|
||||||
|
|
||||||
auto wrap_estimate = [](Estimate<double> e) {
|
|
||||||
return Estimate<Duration> {
|
|
||||||
Duration(e.point),
|
|
||||||
Duration(e.lower_bound),
|
|
||||||
Duration(e.upper_bound),
|
|
||||||
e.confidence_interval,
|
|
||||||
};
|
|
||||||
};
|
|
||||||
std::vector<Duration> samples2;
|
|
||||||
samples2.reserve(samples.size());
|
|
||||||
std::transform(samples.begin(), samples.end(), std::back_inserter(samples2), [](double d) { return Duration(d); });
|
|
||||||
return {
|
|
||||||
CATCH_MOVE(samples2),
|
|
||||||
wrap_estimate(analysis.mean),
|
|
||||||
wrap_estimate(analysis.standard_deviation),
|
|
||||||
outliers,
|
|
||||||
analysis.outlier_variance,
|
|
||||||
};
|
|
||||||
} else {
|
|
||||||
std::vector<Duration> samples;
|
|
||||||
samples.reserve(static_cast<size_t>(last - first));
|
|
||||||
|
|
||||||
Duration mean = Duration(0);
|
|
||||||
int i = 0;
|
|
||||||
for (auto it = first; it < last; ++it, ++i) {
|
|
||||||
samples.push_back(Duration(*it));
|
|
||||||
mean += Duration(*it);
|
|
||||||
}
|
|
||||||
mean /= i;
|
|
||||||
|
|
||||||
return {
|
|
||||||
CATCH_MOVE(samples),
|
|
||||||
Estimate<Duration>{mean, mean, mean, 0.0},
|
|
||||||
Estimate<Duration>{Duration(0), Duration(0), Duration(0), 0.0},
|
|
||||||
OutlierClassification{},
|
|
||||||
0.0
|
|
||||||
};
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} // namespace Detail
|
} // namespace Detail
|
||||||
} // namespace Benchmark
|
} // namespace Benchmark
|
||||||
} // namespace Catch
|
} // namespace Catch
|
||||||
|
|
|
@ -11,7 +11,6 @@
|
||||||
#define CATCH_BENCHMARK_FUNCTION_HPP_INCLUDED
|
#define CATCH_BENCHMARK_FUNCTION_HPP_INCLUDED
|
||||||
|
|
||||||
#include <catch2/benchmark/catch_chronometer.hpp>
|
#include <catch2/benchmark/catch_chronometer.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_complete_invoke.hpp>
|
|
||||||
#include <catch2/internal/catch_meta.hpp>
|
#include <catch2/internal/catch_meta.hpp>
|
||||||
#include <catch2/internal/catch_unique_ptr.hpp>
|
#include <catch2/internal/catch_unique_ptr.hpp>
|
||||||
#include <catch2/internal/catch_move_and_forward.hpp>
|
#include <catch2/internal/catch_move_and_forward.hpp>
|
||||||
|
|
48
externals/catch/src/catch2/benchmark/detail/catch_benchmark_stats.hpp
vendored
Normal file
48
externals/catch/src/catch2/benchmark/detail/catch_benchmark_stats.hpp
vendored
Normal file
|
@ -0,0 +1,48 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
#ifndef CATCH_BENCHMARK_STATS_HPP_INCLUDED
|
||||||
|
#define CATCH_BENCHMARK_STATS_HPP_INCLUDED
|
||||||
|
|
||||||
|
#include <catch2/benchmark/catch_estimate.hpp>
|
||||||
|
#include <catch2/benchmark/catch_outlier_classification.hpp>
|
||||||
|
// The fwd decl & default specialization needs to be seen by VS2017 before
|
||||||
|
// BenchmarkStats itself, or VS2017 will report compilation error.
|
||||||
|
#include <catch2/benchmark/detail/catch_benchmark_stats_fwd.hpp>
|
||||||
|
|
||||||
|
#include <string>
|
||||||
|
#include <vector>
|
||||||
|
|
||||||
|
namespace Catch {
|
||||||
|
|
||||||
|
struct BenchmarkInfo {
|
||||||
|
std::string name;
|
||||||
|
double estimatedDuration;
|
||||||
|
int iterations;
|
||||||
|
unsigned int samples;
|
||||||
|
unsigned int resamples;
|
||||||
|
double clockResolution;
|
||||||
|
double clockCost;
|
||||||
|
};
|
||||||
|
|
||||||
|
// We need to keep template parameter for backwards compatibility,
|
||||||
|
// but we also do not want to use the template paraneter.
|
||||||
|
template <class Dummy>
|
||||||
|
struct BenchmarkStats {
|
||||||
|
BenchmarkInfo info;
|
||||||
|
|
||||||
|
std::vector<Benchmark::FDuration> samples;
|
||||||
|
Benchmark::Estimate<Benchmark::FDuration> mean;
|
||||||
|
Benchmark::Estimate<Benchmark::FDuration> standardDeviation;
|
||||||
|
Benchmark::OutlierClassification outliers;
|
||||||
|
double outlierVariance;
|
||||||
|
};
|
||||||
|
|
||||||
|
|
||||||
|
} // end namespace Catch
|
||||||
|
|
||||||
|
#endif // CATCH_BENCHMARK_STATS_HPP_INCLUDED
|
23
externals/catch/src/catch2/benchmark/detail/catch_benchmark_stats_fwd.hpp
vendored
Normal file
23
externals/catch/src/catch2/benchmark/detail/catch_benchmark_stats_fwd.hpp
vendored
Normal file
|
@ -0,0 +1,23 @@
|
||||||
|
|
||||||
|
// Copyright Catch2 Authors
|
||||||
|
// Distributed under the Boost Software License, Version 1.0.
|
||||||
|
// (See accompanying file LICENSE.txt or copy at
|
||||||
|
// https://www.boost.org/LICENSE_1_0.txt)
|
||||||
|
|
||||||
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
#ifndef CATCH_BENCHMARK_STATS_FWD_HPP_INCLUDED
|
||||||
|
#define CATCH_BENCHMARK_STATS_FWD_HPP_INCLUDED
|
||||||
|
|
||||||
|
#include <catch2/benchmark/catch_clock.hpp>
|
||||||
|
|
||||||
|
namespace Catch {
|
||||||
|
|
||||||
|
// We cannot forward declare the type with default template argument
|
||||||
|
// multiple times, so it is split out into a separate header so that
|
||||||
|
// we can prevent multiple declarations in dependees
|
||||||
|
template <typename Duration = Benchmark::FDuration>
|
||||||
|
struct BenchmarkStats;
|
||||||
|
|
||||||
|
} // end namespace Catch
|
||||||
|
|
||||||
|
#endif // CATCH_BENCHMARK_STATS_FWD_HPP_INCLUDED
|
|
@ -10,14 +10,9 @@
|
||||||
#ifndef CATCH_COMPLETE_INVOKE_HPP_INCLUDED
|
#ifndef CATCH_COMPLETE_INVOKE_HPP_INCLUDED
|
||||||
#define CATCH_COMPLETE_INVOKE_HPP_INCLUDED
|
#define CATCH_COMPLETE_INVOKE_HPP_INCLUDED
|
||||||
|
|
||||||
#include <catch2/internal/catch_test_failure_exception.hpp>
|
|
||||||
#include <catch2/internal/catch_meta.hpp>
|
#include <catch2/internal/catch_meta.hpp>
|
||||||
#include <catch2/interfaces/catch_interfaces_capture.hpp>
|
|
||||||
#include <catch2/interfaces/catch_interfaces_registry_hub.hpp>
|
|
||||||
#include <catch2/internal/catch_move_and_forward.hpp>
|
#include <catch2/internal/catch_move_and_forward.hpp>
|
||||||
|
|
||||||
#include <type_traits>
|
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
namespace Detail {
|
namespace Detail {
|
||||||
|
|
|
@ -19,7 +19,6 @@
|
||||||
#include <catch2/internal/catch_unique_ptr.hpp>
|
#include <catch2/internal/catch_unique_ptr.hpp>
|
||||||
|
|
||||||
#include <algorithm>
|
#include <algorithm>
|
||||||
#include <iterator>
|
|
||||||
#include <vector>
|
#include <vector>
|
||||||
#include <cmath>
|
#include <cmath>
|
||||||
|
|
||||||
|
@ -30,46 +29,49 @@ namespace Catch {
|
||||||
std::vector<double> resolution(int k) {
|
std::vector<double> resolution(int k) {
|
||||||
std::vector<TimePoint<Clock>> times;
|
std::vector<TimePoint<Clock>> times;
|
||||||
times.reserve(static_cast<size_t>(k + 1));
|
times.reserve(static_cast<size_t>(k + 1));
|
||||||
std::generate_n(std::back_inserter(times), k + 1, now<Clock>{});
|
for ( int i = 0; i < k + 1; ++i ) {
|
||||||
|
times.push_back( Clock::now() );
|
||||||
|
}
|
||||||
|
|
||||||
std::vector<double> deltas;
|
std::vector<double> deltas;
|
||||||
deltas.reserve(static_cast<size_t>(k));
|
deltas.reserve(static_cast<size_t>(k));
|
||||||
std::transform(std::next(times.begin()), times.end(), times.begin(),
|
for ( size_t idx = 1; idx < times.size(); ++idx ) {
|
||||||
std::back_inserter(deltas),
|
deltas.push_back( static_cast<double>(
|
||||||
[](TimePoint<Clock> a, TimePoint<Clock> b) { return static_cast<double>((a - b).count()); });
|
( times[idx] - times[idx - 1] ).count() ) );
|
||||||
|
}
|
||||||
|
|
||||||
return deltas;
|
return deltas;
|
||||||
}
|
}
|
||||||
|
|
||||||
const auto warmup_iterations = 10000;
|
constexpr auto warmup_iterations = 10000;
|
||||||
const auto warmup_time = std::chrono::milliseconds(100);
|
constexpr auto warmup_time = std::chrono::milliseconds(100);
|
||||||
const auto minimum_ticks = 1000;
|
constexpr auto minimum_ticks = 1000;
|
||||||
const auto warmup_seed = 10000;
|
constexpr auto warmup_seed = 10000;
|
||||||
const auto clock_resolution_estimation_time = std::chrono::milliseconds(500);
|
constexpr auto clock_resolution_estimation_time = std::chrono::milliseconds(500);
|
||||||
const auto clock_cost_estimation_time_limit = std::chrono::seconds(1);
|
constexpr auto clock_cost_estimation_time_limit = std::chrono::seconds(1);
|
||||||
const auto clock_cost_estimation_tick_limit = 100000;
|
constexpr auto clock_cost_estimation_tick_limit = 100000;
|
||||||
const auto clock_cost_estimation_time = std::chrono::milliseconds(10);
|
constexpr auto clock_cost_estimation_time = std::chrono::milliseconds(10);
|
||||||
const auto clock_cost_estimation_iterations = 10000;
|
constexpr auto clock_cost_estimation_iterations = 10000;
|
||||||
|
|
||||||
template <typename Clock>
|
template <typename Clock>
|
||||||
int warmup() {
|
int warmup() {
|
||||||
return run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(warmup_time), warmup_seed, &resolution<Clock>)
|
return run_for_at_least<Clock>(std::chrono::duration_cast<IDuration>(warmup_time), warmup_seed, &resolution<Clock>)
|
||||||
.iterations;
|
.iterations;
|
||||||
}
|
}
|
||||||
template <typename Clock>
|
template <typename Clock>
|
||||||
EnvironmentEstimate<FloatDuration<Clock>> estimate_clock_resolution(int iterations) {
|
EnvironmentEstimate estimate_clock_resolution(int iterations) {
|
||||||
auto r = run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(clock_resolution_estimation_time), iterations, &resolution<Clock>)
|
auto r = run_for_at_least<Clock>(std::chrono::duration_cast<IDuration>(clock_resolution_estimation_time), iterations, &resolution<Clock>)
|
||||||
.result;
|
.result;
|
||||||
return {
|
return {
|
||||||
FloatDuration<Clock>(mean(r.begin(), r.end())),
|
FDuration(mean(r.data(), r.data() + r.size())),
|
||||||
classify_outliers(r.begin(), r.end()),
|
classify_outliers(r.data(), r.data() + r.size()),
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
template <typename Clock>
|
template <typename Clock>
|
||||||
EnvironmentEstimate<FloatDuration<Clock>> estimate_clock_cost(FloatDuration<Clock> resolution) {
|
EnvironmentEstimate estimate_clock_cost(FDuration resolution) {
|
||||||
auto time_limit = (std::min)(
|
auto time_limit = (std::min)(
|
||||||
resolution * clock_cost_estimation_tick_limit,
|
resolution * clock_cost_estimation_tick_limit,
|
||||||
FloatDuration<Clock>(clock_cost_estimation_time_limit));
|
FDuration(clock_cost_estimation_time_limit));
|
||||||
auto time_clock = [](int k) {
|
auto time_clock = [](int k) {
|
||||||
return Detail::measure<Clock>([k] {
|
return Detail::measure<Clock>([k] {
|
||||||
for (int i = 0; i < k; ++i) {
|
for (int i = 0; i < k; ++i) {
|
||||||
|
@ -80,26 +82,28 @@ namespace Catch {
|
||||||
};
|
};
|
||||||
time_clock(1);
|
time_clock(1);
|
||||||
int iters = clock_cost_estimation_iterations;
|
int iters = clock_cost_estimation_iterations;
|
||||||
auto&& r = run_for_at_least<Clock>(std::chrono::duration_cast<ClockDuration<Clock>>(clock_cost_estimation_time), iters, time_clock);
|
auto&& r = run_for_at_least<Clock>(std::chrono::duration_cast<IDuration>(clock_cost_estimation_time), iters, time_clock);
|
||||||
std::vector<double> times;
|
std::vector<double> times;
|
||||||
int nsamples = static_cast<int>(std::ceil(time_limit / r.elapsed));
|
int nsamples = static_cast<int>(std::ceil(time_limit / r.elapsed));
|
||||||
times.reserve(static_cast<size_t>(nsamples));
|
times.reserve(static_cast<size_t>(nsamples));
|
||||||
std::generate_n(std::back_inserter(times), nsamples, [time_clock, &r] {
|
for ( int s = 0; s < nsamples; ++s ) {
|
||||||
return static_cast<double>((time_clock(r.iterations) / r.iterations).count());
|
times.push_back( static_cast<double>(
|
||||||
});
|
( time_clock( r.iterations ) / r.iterations )
|
||||||
|
.count() ) );
|
||||||
|
}
|
||||||
return {
|
return {
|
||||||
FloatDuration<Clock>(mean(times.begin(), times.end())),
|
FDuration(mean(times.data(), times.data() + times.size())),
|
||||||
classify_outliers(times.begin(), times.end()),
|
classify_outliers(times.data(), times.data() + times.size()),
|
||||||
};
|
};
|
||||||
}
|
}
|
||||||
|
|
||||||
template <typename Clock>
|
template <typename Clock>
|
||||||
Environment<FloatDuration<Clock>> measure_environment() {
|
Environment measure_environment() {
|
||||||
#if defined(__clang__)
|
#if defined(__clang__)
|
||||||
# pragma clang diagnostic push
|
# pragma clang diagnostic push
|
||||||
# pragma clang diagnostic ignored "-Wexit-time-destructors"
|
# pragma clang diagnostic ignored "-Wexit-time-destructors"
|
||||||
#endif
|
#endif
|
||||||
static Catch::Detail::unique_ptr<Environment<FloatDuration<Clock>>> env;
|
static Catch::Detail::unique_ptr<Environment> env;
|
||||||
#if defined(__clang__)
|
#if defined(__clang__)
|
||||||
# pragma clang diagnostic pop
|
# pragma clang diagnostic pop
|
||||||
#endif
|
#endif
|
||||||
|
@ -111,7 +115,7 @@ namespace Catch {
|
||||||
auto resolution = Detail::estimate_clock_resolution<Clock>(iters);
|
auto resolution = Detail::estimate_clock_resolution<Clock>(iters);
|
||||||
auto cost = Detail::estimate_clock_cost<Clock>(resolution.mean);
|
auto cost = Detail::estimate_clock_cost<Clock>(resolution.mean);
|
||||||
|
|
||||||
env = Catch::Detail::make_unique<Environment<FloatDuration<Clock>>>( Environment<FloatDuration<Clock>>{resolution, cost} );
|
env = Catch::Detail::make_unique<Environment>( Environment{resolution, cost} );
|
||||||
return *env;
|
return *env;
|
||||||
}
|
}
|
||||||
} // namespace Detail
|
} // namespace Detail
|
||||||
|
|
|
@ -10,7 +10,6 @@
|
||||||
#ifndef CATCH_MEASURE_HPP_INCLUDED
|
#ifndef CATCH_MEASURE_HPP_INCLUDED
|
||||||
#define CATCH_MEASURE_HPP_INCLUDED
|
#define CATCH_MEASURE_HPP_INCLUDED
|
||||||
|
|
||||||
#include <catch2/benchmark/catch_clock.hpp>
|
|
||||||
#include <catch2/benchmark/detail/catch_complete_invoke.hpp>
|
#include <catch2/benchmark/detail/catch_complete_invoke.hpp>
|
||||||
#include <catch2/benchmark/detail/catch_timing.hpp>
|
#include <catch2/benchmark/detail/catch_timing.hpp>
|
||||||
#include <catch2/internal/catch_move_and_forward.hpp>
|
#include <catch2/internal/catch_move_and_forward.hpp>
|
||||||
|
@ -19,7 +18,7 @@ namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
namespace Detail {
|
namespace Detail {
|
||||||
template <typename Clock, typename Fun, typename... Args>
|
template <typename Clock, typename Fun, typename... Args>
|
||||||
TimingOf<Clock, Fun, Args...> measure(Fun&& fun, Args&&... args) {
|
TimingOf<Fun, Args...> measure(Fun&& fun, Args&&... args) {
|
||||||
auto start = Clock::now();
|
auto start = Clock::now();
|
||||||
auto&& r = Detail::complete_invoke(fun, CATCH_FORWARD(args)...);
|
auto&& r = Detail::complete_invoke(fun, CATCH_FORWARD(args)...);
|
||||||
auto end = Clock::now();
|
auto end = Clock::now();
|
||||||
|
|
|
@ -7,9 +7,10 @@
|
||||||
// SPDX-License-Identifier: BSL-1.0
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
|
|
||||||
#include <catch2/benchmark/detail/catch_run_for_at_least.hpp>
|
#include <catch2/benchmark/detail/catch_run_for_at_least.hpp>
|
||||||
#include <exception>
|
|
||||||
#include <catch2/internal/catch_enforce.hpp>
|
#include <catch2/internal/catch_enforce.hpp>
|
||||||
|
|
||||||
|
#include <exception>
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
namespace Detail {
|
namespace Detail {
|
||||||
|
|
|
@ -24,11 +24,11 @@ namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
namespace Detail {
|
namespace Detail {
|
||||||
template <typename Clock, typename Fun>
|
template <typename Clock, typename Fun>
|
||||||
TimingOf<Clock, Fun, int> measure_one(Fun&& fun, int iters, std::false_type) {
|
TimingOf<Fun, int> measure_one(Fun&& fun, int iters, std::false_type) {
|
||||||
return Detail::measure<Clock>(fun, iters);
|
return Detail::measure<Clock>(fun, iters);
|
||||||
}
|
}
|
||||||
template <typename Clock, typename Fun>
|
template <typename Clock, typename Fun>
|
||||||
TimingOf<Clock, Fun, Chronometer> measure_one(Fun&& fun, int iters, std::true_type) {
|
TimingOf<Fun, Chronometer> measure_one(Fun&& fun, int iters, std::true_type) {
|
||||||
Detail::ChronometerModel<Clock> meter;
|
Detail::ChronometerModel<Clock> meter;
|
||||||
auto&& result = Detail::complete_invoke(fun, Chronometer(meter, iters));
|
auto&& result = Detail::complete_invoke(fun, Chronometer(meter, iters));
|
||||||
|
|
||||||
|
@ -43,8 +43,8 @@ namespace Catch {
|
||||||
void throw_optimized_away_error();
|
void throw_optimized_away_error();
|
||||||
|
|
||||||
template <typename Clock, typename Fun>
|
template <typename Clock, typename Fun>
|
||||||
TimingOf<Clock, Fun, run_for_at_least_argument_t<Clock, Fun>>
|
TimingOf<Fun, run_for_at_least_argument_t<Clock, Fun>>
|
||||||
run_for_at_least(ClockDuration<Clock> how_long,
|
run_for_at_least(IDuration how_long,
|
||||||
const int initial_iterations,
|
const int initial_iterations,
|
||||||
Fun&& fun) {
|
Fun&& fun) {
|
||||||
auto iters = initial_iterations;
|
auto iters = initial_iterations;
|
||||||
|
|
|
@ -10,10 +10,14 @@
|
||||||
#include <catch2/benchmark/detail/catch_stats.hpp>
|
#include <catch2/benchmark/detail/catch_stats.hpp>
|
||||||
|
|
||||||
#include <catch2/internal/catch_compiler_capabilities.hpp>
|
#include <catch2/internal/catch_compiler_capabilities.hpp>
|
||||||
|
#include <catch2/internal/catch_floating_point_helpers.hpp>
|
||||||
|
#include <catch2/internal/catch_random_number_generator.hpp>
|
||||||
|
|
||||||
|
#include <algorithm>
|
||||||
#include <cassert>
|
#include <cassert>
|
||||||
|
#include <cmath>
|
||||||
#include <cstddef>
|
#include <cstddef>
|
||||||
#include <iterator>
|
#include <numeric>
|
||||||
#include <random>
|
#include <random>
|
||||||
|
|
||||||
|
|
||||||
|
@ -21,35 +25,84 @@
|
||||||
#include <future>
|
#include <future>
|
||||||
#endif
|
#endif
|
||||||
|
|
||||||
namespace {
|
namespace Catch {
|
||||||
|
namespace Benchmark {
|
||||||
using Catch::Benchmark::Detail::sample;
|
namespace Detail {
|
||||||
|
namespace {
|
||||||
|
|
||||||
template <typename URng, typename Estimator>
|
template <typename URng, typename Estimator>
|
||||||
sample resample(URng& rng, unsigned int resamples, std::vector<double>::iterator first, std::vector<double>::iterator last, Estimator& estimator) {
|
static sample
|
||||||
auto n = static_cast<size_t>(last - first);
|
resample( URng& rng,
|
||||||
std::uniform_int_distribution<decltype(n)> dist(0, n - 1);
|
unsigned int resamples,
|
||||||
|
double const* first,
|
||||||
|
double const* last,
|
||||||
|
Estimator& estimator ) {
|
||||||
|
auto n = static_cast<size_t>( last - first );
|
||||||
|
std::uniform_int_distribution<decltype( n )> dist( 0,
|
||||||
|
n - 1 );
|
||||||
|
|
||||||
sample out;
|
sample out;
|
||||||
out.reserve(resamples);
|
out.reserve( resamples );
|
||||||
std::generate_n(std::back_inserter(out), resamples, [n, first, &estimator, &dist, &rng] {
|
// We allocate the vector outside the loop to avoid realloc
|
||||||
|
// per resample
|
||||||
std::vector<double> resampled;
|
std::vector<double> resampled;
|
||||||
resampled.reserve(n);
|
resampled.reserve( n );
|
||||||
std::generate_n(std::back_inserter(resampled), n, [first, &dist, &rng] { return first[static_cast<std::ptrdiff_t>(dist(rng))]; });
|
for ( size_t i = 0; i < resamples; ++i ) {
|
||||||
return estimator(resampled.begin(), resampled.end());
|
resampled.clear();
|
||||||
});
|
for ( size_t s = 0; s < n; ++s ) {
|
||||||
std::sort(out.begin(), out.end());
|
resampled.push_back(
|
||||||
|
first[static_cast<std::ptrdiff_t>(
|
||||||
|
dist( rng ) )] );
|
||||||
|
}
|
||||||
|
const auto estimate =
|
||||||
|
estimator( resampled.data(), resampled.data() + resampled.size() );
|
||||||
|
out.push_back( estimate );
|
||||||
|
}
|
||||||
|
std::sort( out.begin(), out.end() );
|
||||||
return out;
|
return out;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
static double outlier_variance( Estimate<double> mean,
|
||||||
|
Estimate<double> stddev,
|
||||||
|
int n ) {
|
||||||
|
double sb = stddev.point;
|
||||||
|
double mn = mean.point / n;
|
||||||
|
double mg_min = mn / 2.;
|
||||||
|
double sg = (std::min)( mg_min / 4., sb / std::sqrt( n ) );
|
||||||
|
double sg2 = sg * sg;
|
||||||
|
double sb2 = sb * sb;
|
||||||
|
|
||||||
double erf_inv(double x) {
|
auto c_max = [n, mn, sb2, sg2]( double x ) -> double {
|
||||||
// Code accompanying the article "Approximating the erfinv function" in GPU Computing Gems, Volume 2
|
double k = mn - x;
|
||||||
|
double d = k * k;
|
||||||
|
double nd = n * d;
|
||||||
|
double k0 = -n * nd;
|
||||||
|
double k1 = sb2 - n * sg2 + nd;
|
||||||
|
double det = k1 * k1 - 4 * sg2 * k0;
|
||||||
|
return static_cast<int>( -2. * k0 /
|
||||||
|
( k1 + std::sqrt( det ) ) );
|
||||||
|
};
|
||||||
|
|
||||||
|
auto var_out = [n, sb2, sg2]( double c ) {
|
||||||
|
double nc = n - c;
|
||||||
|
return ( nc / n ) * ( sb2 - nc * sg2 );
|
||||||
|
};
|
||||||
|
|
||||||
|
return (std::min)( var_out( 1 ),
|
||||||
|
var_out(
|
||||||
|
(std::min)( c_max( 0. ),
|
||||||
|
c_max( mg_min ) ) ) ) /
|
||||||
|
sb2;
|
||||||
|
}
|
||||||
|
|
||||||
|
static double erf_inv( double x ) {
|
||||||
|
// Code accompanying the article "Approximating the erfinv
|
||||||
|
// function" in GPU Computing Gems, Volume 2
|
||||||
double w, p;
|
double w, p;
|
||||||
|
|
||||||
w = -log((1.0 - x) * (1.0 + x));
|
w = -log( ( 1.0 - x ) * ( 1.0 + x ) );
|
||||||
|
|
||||||
if (w < 6.250000) {
|
if ( w < 6.250000 ) {
|
||||||
w = w - 3.125000;
|
w = w - 3.125000;
|
||||||
p = -3.6444120640178196996e-21;
|
p = -3.6444120640178196996e-21;
|
||||||
p = -1.685059138182016589e-19 + p * w;
|
p = -1.685059138182016589e-19 + p * w;
|
||||||
|
@ -74,8 +127,8 @@ using Catch::Benchmark::Detail::sample;
|
||||||
p = -0.0060336708714301490533 + p * w;
|
p = -0.0060336708714301490533 + p * w;
|
||||||
p = 0.24015818242558961693 + p * w;
|
p = 0.24015818242558961693 + p * w;
|
||||||
p = 1.6536545626831027356 + p * w;
|
p = 1.6536545626831027356 + p * w;
|
||||||
} else if (w < 16.000000) {
|
} else if ( w < 16.000000 ) {
|
||||||
w = sqrt(w) - 3.250000;
|
w = sqrt( w ) - 3.250000;
|
||||||
p = 2.2137376921775787049e-09;
|
p = 2.2137376921775787049e-09;
|
||||||
p = 9.0756561938885390979e-08 + p * w;
|
p = 9.0756561938885390979e-08 + p * w;
|
||||||
p = -2.7517406297064545428e-07 + p * w;
|
p = -2.7517406297064545428e-07 + p * w;
|
||||||
|
@ -96,7 +149,7 @@ using Catch::Benchmark::Detail::sample;
|
||||||
p = 1.0052589676941592334 + p * w;
|
p = 1.0052589676941592334 + p * w;
|
||||||
p = 3.0838856104922207635 + p * w;
|
p = 3.0838856104922207635 + p * w;
|
||||||
} else {
|
} else {
|
||||||
w = sqrt(w) - 5.000000;
|
w = sqrt( w ) - 5.000000;
|
||||||
p = -2.7109920616438573243e-11;
|
p = -2.7109920616438573243e-11;
|
||||||
p = -2.5556418169965252055e-10 + p * w;
|
p = -2.5556418169965252055e-10 + p * w;
|
||||||
p = 1.5076572693500548083e-09 + p * w;
|
p = 1.5076572693500548083e-09 + p * w;
|
||||||
|
@ -118,9 +171,11 @@ using Catch::Benchmark::Detail::sample;
|
||||||
return p * x;
|
return p * x;
|
||||||
}
|
}
|
||||||
|
|
||||||
double standard_deviation(std::vector<double>::iterator first, std::vector<double>::iterator last) {
|
static double
|
||||||
auto m = Catch::Benchmark::Detail::mean(first, last);
|
standard_deviation( double const* first, double const* last ) {
|
||||||
double variance = std::accumulate( first,
|
auto m = Catch::Benchmark::Detail::mean( first, last );
|
||||||
|
double variance =
|
||||||
|
std::accumulate( first,
|
||||||
last,
|
last,
|
||||||
0.,
|
0.,
|
||||||
[m]( double a, double b ) {
|
[m]( double a, double b ) {
|
||||||
|
@ -131,29 +186,43 @@ using Catch::Benchmark::Detail::sample;
|
||||||
return std::sqrt( variance );
|
return std::sqrt( variance );
|
||||||
}
|
}
|
||||||
|
|
||||||
}
|
static sample jackknife( double ( *estimator )( double const*,
|
||||||
|
double const* ),
|
||||||
|
double* first,
|
||||||
|
double* last ) {
|
||||||
|
const auto second = first + 1;
|
||||||
|
sample results;
|
||||||
|
results.reserve( static_cast<size_t>( last - first ) );
|
||||||
|
|
||||||
|
for ( auto it = first; it != last; ++it ) {
|
||||||
|
std::iter_swap( it, first );
|
||||||
|
results.push_back( estimator( second, last ) );
|
||||||
|
}
|
||||||
|
|
||||||
|
return results;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
} // namespace
|
||||||
|
} // namespace Detail
|
||||||
|
} // namespace Benchmark
|
||||||
|
} // namespace Catch
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
namespace Detail {
|
namespace Detail {
|
||||||
|
|
||||||
#if defined( __GNUC__ ) || defined( __clang__ )
|
double weighted_average_quantile( int k,
|
||||||
# pragma GCC diagnostic push
|
int q,
|
||||||
# pragma GCC diagnostic ignored "-Wfloat-equal"
|
double* first,
|
||||||
#endif
|
double* last ) {
|
||||||
bool directCompare( double lhs, double rhs ) { return lhs == rhs; }
|
|
||||||
#if defined( __GNUC__ ) || defined( __clang__ )
|
|
||||||
# pragma GCC diagnostic pop
|
|
||||||
#endif
|
|
||||||
|
|
||||||
double weighted_average_quantile(int k, int q, std::vector<double>::iterator first, std::vector<double>::iterator last) {
|
|
||||||
auto count = last - first;
|
auto count = last - first;
|
||||||
double idx = (count - 1) * k / static_cast<double>(q);
|
double idx = (count - 1) * k / static_cast<double>(q);
|
||||||
int j = static_cast<int>(idx);
|
int j = static_cast<int>(idx);
|
||||||
double g = idx - j;
|
double g = idx - j;
|
||||||
std::nth_element(first, first + j, last);
|
std::nth_element(first, first + j, last);
|
||||||
auto xj = first[j];
|
auto xj = first[j];
|
||||||
if ( directCompare( g, 0 ) ) {
|
if ( Catch::Detail::directCompare( g, 0 ) ) {
|
||||||
return xj;
|
return xj;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@ -161,6 +230,48 @@ namespace Catch {
|
||||||
return xj + g * (xj1 - xj);
|
return xj + g * (xj1 - xj);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
OutlierClassification
|
||||||
|
classify_outliers( double const* first, double const* last ) {
|
||||||
|
std::vector<double> copy( first, last );
|
||||||
|
|
||||||
|
auto q1 = weighted_average_quantile( 1, 4, copy.data(), copy.data() + copy.size() );
|
||||||
|
auto q3 = weighted_average_quantile( 3, 4, copy.data(), copy.data() + copy.size() );
|
||||||
|
auto iqr = q3 - q1;
|
||||||
|
auto los = q1 - ( iqr * 3. );
|
||||||
|
auto lom = q1 - ( iqr * 1.5 );
|
||||||
|
auto him = q3 + ( iqr * 1.5 );
|
||||||
|
auto his = q3 + ( iqr * 3. );
|
||||||
|
|
||||||
|
OutlierClassification o;
|
||||||
|
for ( ; first != last; ++first ) {
|
||||||
|
const double t = *first;
|
||||||
|
if ( t < los ) {
|
||||||
|
++o.low_severe;
|
||||||
|
} else if ( t < lom ) {
|
||||||
|
++o.low_mild;
|
||||||
|
} else if ( t > his ) {
|
||||||
|
++o.high_severe;
|
||||||
|
} else if ( t > him ) {
|
||||||
|
++o.high_mild;
|
||||||
|
}
|
||||||
|
++o.samples_seen;
|
||||||
|
}
|
||||||
|
return o;
|
||||||
|
}
|
||||||
|
|
||||||
|
double mean( double const* first, double const* last ) {
|
||||||
|
auto count = last - first;
|
||||||
|
double sum = 0.;
|
||||||
|
while (first != last) {
|
||||||
|
sum += *first;
|
||||||
|
++first;
|
||||||
|
}
|
||||||
|
return sum / static_cast<double>(count);
|
||||||
|
}
|
||||||
|
|
||||||
|
double normal_cdf( double x ) {
|
||||||
|
return std::erfc( -x / std::sqrt( 2.0 ) ) / 2.0;
|
||||||
|
}
|
||||||
|
|
||||||
double erfc_inv(double x) {
|
double erfc_inv(double x) {
|
||||||
return erf_inv(1.0 - x);
|
return erf_inv(1.0 - x);
|
||||||
|
@ -182,50 +293,77 @@ namespace Catch {
|
||||||
return result;
|
return result;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
Estimate<double>
|
||||||
|
bootstrap( double confidence_level,
|
||||||
|
double* first,
|
||||||
|
double* last,
|
||||||
|
sample const& resample,
|
||||||
|
double ( *estimator )( double const*, double const* ) ) {
|
||||||
|
auto n_samples = last - first;
|
||||||
|
|
||||||
double outlier_variance(Estimate<double> mean, Estimate<double> stddev, int n) {
|
double point = estimator( first, last );
|
||||||
double sb = stddev.point;
|
// Degenerate case with a single sample
|
||||||
double mn = mean.point / n;
|
if ( n_samples == 1 )
|
||||||
double mg_min = mn / 2.;
|
return { point, point, point, confidence_level };
|
||||||
double sg = (std::min)(mg_min / 4., sb / std::sqrt(n));
|
|
||||||
double sg2 = sg * sg;
|
|
||||||
double sb2 = sb * sb;
|
|
||||||
|
|
||||||
auto c_max = [n, mn, sb2, sg2](double x) -> double {
|
sample jack = jackknife( estimator, first, last );
|
||||||
double k = mn - x;
|
double jack_mean =
|
||||||
double d = k * k;
|
mean( jack.data(), jack.data() + jack.size() );
|
||||||
double nd = n * d;
|
double sum_squares = 0, sum_cubes = 0;
|
||||||
double k0 = -n * nd;
|
for ( double x : jack ) {
|
||||||
double k1 = sb2 - n * sg2 + nd;
|
auto difference = jack_mean - x;
|
||||||
double det = k1 * k1 - 4 * sg2 * k0;
|
auto square = difference * difference;
|
||||||
return static_cast<int>(-2. * k0 / (k1 + std::sqrt(det)));
|
auto cube = square * difference;
|
||||||
};
|
sum_squares += square;
|
||||||
|
sum_cubes += cube;
|
||||||
auto var_out = [n, sb2, sg2](double c) {
|
|
||||||
double nc = n - c;
|
|
||||||
return (nc / n) * (sb2 - nc * sg2);
|
|
||||||
};
|
|
||||||
|
|
||||||
return (std::min)(var_out(1), var_out((std::min)(c_max(0.), c_max(mg_min)))) / sb2;
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
double accel = sum_cubes / ( 6 * std::pow( sum_squares, 1.5 ) );
|
||||||
|
long n = static_cast<long>( resample.size() );
|
||||||
|
double prob_n =
|
||||||
|
std::count_if( resample.begin(),
|
||||||
|
resample.end(),
|
||||||
|
[point]( double x ) { return x < point; } ) /
|
||||||
|
static_cast<double>( n );
|
||||||
|
// degenerate case with uniform samples
|
||||||
|
if ( Catch::Detail::directCompare( prob_n, 0. ) ) {
|
||||||
|
return { point, point, point, confidence_level };
|
||||||
|
}
|
||||||
|
|
||||||
bootstrap_analysis analyse_samples(double confidence_level, unsigned int n_resamples, std::vector<double>::iterator first, std::vector<double>::iterator last) {
|
double bias = normal_quantile( prob_n );
|
||||||
CATCH_INTERNAL_START_WARNINGS_SUPPRESSION
|
double z1 = normal_quantile( ( 1. - confidence_level ) / 2. );
|
||||||
CATCH_INTERNAL_SUPPRESS_GLOBALS_WARNINGS
|
|
||||||
static std::random_device entropy;
|
|
||||||
CATCH_INTERNAL_STOP_WARNINGS_SUPPRESSION
|
|
||||||
|
|
||||||
auto n = static_cast<int>(last - first); // seriously, one can't use integral types without hell in C++
|
auto cumn = [n]( double x ) -> long {
|
||||||
|
return std::lround( normal_cdf( x ) *
|
||||||
|
static_cast<double>( n ) );
|
||||||
|
};
|
||||||
|
auto a = [bias, accel]( double b ) {
|
||||||
|
return bias + b / ( 1. - accel * b );
|
||||||
|
};
|
||||||
|
double b1 = bias + z1;
|
||||||
|
double b2 = bias - z1;
|
||||||
|
double a1 = a( b1 );
|
||||||
|
double a2 = a( b2 );
|
||||||
|
auto lo = static_cast<size_t>( (std::max)( cumn( a1 ), 0l ) );
|
||||||
|
auto hi =
|
||||||
|
static_cast<size_t>( (std::min)( cumn( a2 ), n - 1 ) );
|
||||||
|
|
||||||
auto mean = &Detail::mean<std::vector<double>::iterator>;
|
return { point, resample[lo], resample[hi], confidence_level };
|
||||||
|
}
|
||||||
|
|
||||||
|
bootstrap_analysis analyse_samples(double confidence_level,
|
||||||
|
unsigned int n_resamples,
|
||||||
|
double* first,
|
||||||
|
double* last) {
|
||||||
|
auto mean = &Detail::mean;
|
||||||
auto stddev = &standard_deviation;
|
auto stddev = &standard_deviation;
|
||||||
|
|
||||||
#if defined(CATCH_CONFIG_USE_ASYNC)
|
#if defined(CATCH_CONFIG_USE_ASYNC)
|
||||||
auto Estimate = [=](double(*f)(std::vector<double>::iterator, std::vector<double>::iterator)) {
|
auto Estimate = [=](double(*f)(double const*, double const*)) {
|
||||||
auto seed = entropy();
|
std::random_device rd;
|
||||||
|
auto seed = rd();
|
||||||
return std::async(std::launch::async, [=] {
|
return std::async(std::launch::async, [=] {
|
||||||
std::mt19937 rng(seed);
|
SimplePcg32 rng( seed );
|
||||||
auto resampled = resample(rng, n_resamples, first, last, f);
|
auto resampled = resample(rng, n_resamples, first, last, f);
|
||||||
return bootstrap(confidence_level, first, last, resampled, f);
|
return bootstrap(confidence_level, first, last, resampled, f);
|
||||||
});
|
});
|
||||||
|
@ -237,9 +375,10 @@ namespace Catch {
|
||||||
auto mean_estimate = mean_future.get();
|
auto mean_estimate = mean_future.get();
|
||||||
auto stddev_estimate = stddev_future.get();
|
auto stddev_estimate = stddev_future.get();
|
||||||
#else
|
#else
|
||||||
auto Estimate = [=](double(*f)(std::vector<double>::iterator, std::vector<double>::iterator)) {
|
auto Estimate = [=](double(*f)(double const* , double const*)) {
|
||||||
auto seed = entropy();
|
std::random_device rd;
|
||||||
std::mt19937 rng(seed);
|
auto seed = rd();
|
||||||
|
SimplePcg32 rng( seed );
|
||||||
auto resampled = resample(rng, n_resamples, first, last, f);
|
auto resampled = resample(rng, n_resamples, first, last, f);
|
||||||
return bootstrap(confidence_level, first, last, resampled, f);
|
return bootstrap(confidence_level, first, last, resampled, f);
|
||||||
};
|
};
|
||||||
|
@ -248,6 +387,7 @@ namespace Catch {
|
||||||
auto stddev_estimate = Estimate(stddev);
|
auto stddev_estimate = Estimate(stddev);
|
||||||
#endif // CATCH_USE_ASYNC
|
#endif // CATCH_USE_ASYNC
|
||||||
|
|
||||||
|
auto n = static_cast<int>(last - first); // seriously, one can't use integral types without hell in C++
|
||||||
double outlier_variance = Detail::outlier_variance(mean_estimate, stddev_estimate, n);
|
double outlier_variance = Detail::outlier_variance(mean_estimate, stddev_estimate, n);
|
||||||
|
|
||||||
return { mean_estimate, stddev_estimate, outlier_variance };
|
return { mean_estimate, stddev_estimate, outlier_variance };
|
||||||
|
|
|
@ -13,122 +13,35 @@
|
||||||
#include <catch2/benchmark/catch_estimate.hpp>
|
#include <catch2/benchmark/catch_estimate.hpp>
|
||||||
#include <catch2/benchmark/catch_outlier_classification.hpp>
|
#include <catch2/benchmark/catch_outlier_classification.hpp>
|
||||||
|
|
||||||
#include <algorithm>
|
|
||||||
#include <vector>
|
#include <vector>
|
||||||
#include <numeric>
|
|
||||||
#include <tuple>
|
|
||||||
#include <cmath>
|
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
namespace Detail {
|
namespace Detail {
|
||||||
using sample = std::vector<double>;
|
using sample = std::vector<double>;
|
||||||
|
|
||||||
// Used when we know we want == comparison of two doubles
|
double weighted_average_quantile( int k,
|
||||||
// to centralize warning suppression
|
int q,
|
||||||
bool directCompare( double lhs, double rhs );
|
double* first,
|
||||||
|
double* last );
|
||||||
|
|
||||||
double weighted_average_quantile(int k, int q, std::vector<double>::iterator first, std::vector<double>::iterator last);
|
OutlierClassification
|
||||||
|
classify_outliers( double const* first, double const* last );
|
||||||
|
|
||||||
template <typename Iterator>
|
double mean( double const* first, double const* last );
|
||||||
OutlierClassification classify_outliers(Iterator first, Iterator last) {
|
|
||||||
std::vector<double> copy(first, last);
|
|
||||||
|
|
||||||
auto q1 = weighted_average_quantile(1, 4, copy.begin(), copy.end());
|
double normal_cdf( double x );
|
||||||
auto q3 = weighted_average_quantile(3, 4, copy.begin(), copy.end());
|
|
||||||
auto iqr = q3 - q1;
|
|
||||||
auto los = q1 - (iqr * 3.);
|
|
||||||
auto lom = q1 - (iqr * 1.5);
|
|
||||||
auto him = q3 + (iqr * 1.5);
|
|
||||||
auto his = q3 + (iqr * 3.);
|
|
||||||
|
|
||||||
OutlierClassification o;
|
|
||||||
for (; first != last; ++first) {
|
|
||||||
auto&& t = *first;
|
|
||||||
if (t < los) ++o.low_severe;
|
|
||||||
else if (t < lom) ++o.low_mild;
|
|
||||||
else if (t > his) ++o.high_severe;
|
|
||||||
else if (t > him) ++o.high_mild;
|
|
||||||
++o.samples_seen;
|
|
||||||
}
|
|
||||||
return o;
|
|
||||||
}
|
|
||||||
|
|
||||||
template <typename Iterator>
|
|
||||||
double mean(Iterator first, Iterator last) {
|
|
||||||
auto count = last - first;
|
|
||||||
double sum = std::accumulate(first, last, 0.);
|
|
||||||
return sum / static_cast<double>(count);
|
|
||||||
}
|
|
||||||
|
|
||||||
template <typename Estimator, typename Iterator>
|
|
||||||
sample jackknife(Estimator&& estimator, Iterator first, Iterator last) {
|
|
||||||
auto n = static_cast<size_t>(last - first);
|
|
||||||
auto second = first;
|
|
||||||
++second;
|
|
||||||
sample results;
|
|
||||||
results.reserve(n);
|
|
||||||
|
|
||||||
for (auto it = first; it != last; ++it) {
|
|
||||||
std::iter_swap(it, first);
|
|
||||||
results.push_back(estimator(second, last));
|
|
||||||
}
|
|
||||||
|
|
||||||
return results;
|
|
||||||
}
|
|
||||||
|
|
||||||
inline double normal_cdf(double x) {
|
|
||||||
return std::erfc(-x / std::sqrt(2.0)) / 2.0;
|
|
||||||
}
|
|
||||||
|
|
||||||
double erfc_inv(double x);
|
double erfc_inv(double x);
|
||||||
|
|
||||||
double normal_quantile(double p);
|
double normal_quantile(double p);
|
||||||
|
|
||||||
template <typename Iterator, typename Estimator>
|
Estimate<double>
|
||||||
Estimate<double> bootstrap(double confidence_level, Iterator first, Iterator last, sample const& resample, Estimator&& estimator) {
|
bootstrap( double confidence_level,
|
||||||
auto n_samples = last - first;
|
double* first,
|
||||||
|
double* last,
|
||||||
double point = estimator(first, last);
|
sample const& resample,
|
||||||
// Degenerate case with a single sample
|
double ( *estimator )( double const*, double const* ) );
|
||||||
if (n_samples == 1) return { point, point, point, confidence_level };
|
|
||||||
|
|
||||||
sample jack = jackknife(estimator, first, last);
|
|
||||||
double jack_mean = mean(jack.begin(), jack.end());
|
|
||||||
double sum_squares, sum_cubes;
|
|
||||||
std::tie(sum_squares, sum_cubes) = std::accumulate(jack.begin(), jack.end(), std::make_pair(0., 0.), [jack_mean](std::pair<double, double> sqcb, double x) -> std::pair<double, double> {
|
|
||||||
auto d = jack_mean - x;
|
|
||||||
auto d2 = d * d;
|
|
||||||
auto d3 = d2 * d;
|
|
||||||
return { sqcb.first + d2, sqcb.second + d3 };
|
|
||||||
});
|
|
||||||
|
|
||||||
double accel = sum_cubes / (6 * std::pow(sum_squares, 1.5));
|
|
||||||
long n = static_cast<long>(resample.size());
|
|
||||||
double prob_n = std::count_if(resample.begin(), resample.end(), [point](double x) { return x < point; }) / static_cast<double>(n);
|
|
||||||
// degenerate case with uniform samples
|
|
||||||
if ( directCompare( prob_n, 0. ) ) {
|
|
||||||
return { point, point, point, confidence_level };
|
|
||||||
}
|
|
||||||
|
|
||||||
double bias = normal_quantile(prob_n);
|
|
||||||
double z1 = normal_quantile((1. - confidence_level) / 2.);
|
|
||||||
|
|
||||||
auto cumn = [n]( double x ) -> long {
|
|
||||||
return std::lround( normal_cdf( x ) * static_cast<double>(n) );
|
|
||||||
};
|
|
||||||
auto a = [bias, accel](double b) { return bias + b / (1. - accel * b); };
|
|
||||||
double b1 = bias + z1;
|
|
||||||
double b2 = bias - z1;
|
|
||||||
double a1 = a(b1);
|
|
||||||
double a2 = a(b2);
|
|
||||||
auto lo = static_cast<size_t>((std::max)(cumn(a1), 0l));
|
|
||||||
auto hi = static_cast<size_t>((std::min)(cumn(a2), n - 1));
|
|
||||||
|
|
||||||
return { point, resample[lo], resample[hi], confidence_level };
|
|
||||||
}
|
|
||||||
|
|
||||||
double outlier_variance(Estimate<double> mean, Estimate<double> stddev, int n);
|
|
||||||
|
|
||||||
struct bootstrap_analysis {
|
struct bootstrap_analysis {
|
||||||
Estimate<double> mean;
|
Estimate<double> mean;
|
||||||
|
@ -136,7 +49,10 @@ namespace Catch {
|
||||||
double outlier_variance;
|
double outlier_variance;
|
||||||
};
|
};
|
||||||
|
|
||||||
bootstrap_analysis analyse_samples(double confidence_level, unsigned int n_resamples, std::vector<double>::iterator first, std::vector<double>::iterator last);
|
bootstrap_analysis analyse_samples(double confidence_level,
|
||||||
|
unsigned int n_resamples,
|
||||||
|
double* first,
|
||||||
|
double* last);
|
||||||
} // namespace Detail
|
} // namespace Detail
|
||||||
} // namespace Benchmark
|
} // namespace Benchmark
|
||||||
} // namespace Catch
|
} // namespace Catch
|
||||||
|
|
|
@ -17,14 +17,14 @@
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
namespace Benchmark {
|
namespace Benchmark {
|
||||||
template <typename Duration, typename Result>
|
template <typename Result>
|
||||||
struct Timing {
|
struct Timing {
|
||||||
Duration elapsed;
|
IDuration elapsed;
|
||||||
Result result;
|
Result result;
|
||||||
int iterations;
|
int iterations;
|
||||||
};
|
};
|
||||||
template <typename Clock, typename Func, typename... Args>
|
template <typename Func, typename... Args>
|
||||||
using TimingOf = Timing<ClockDuration<Clock>, Detail::CompleteType_t<FunctionReturnType<Func, Args...>>>;
|
using TimingOf = Timing<Detail::CompleteType_t<FunctionReturnType<Func, Args...>>>;
|
||||||
} // namespace Benchmark
|
} // namespace Benchmark
|
||||||
} // namespace Catch
|
} // namespace Catch
|
||||||
|
|
||||||
|
|
10
externals/catch/src/catch2/catch_all.hpp
vendored
10
externals/catch/src/catch2/catch_all.hpp
vendored
|
@ -54,6 +54,8 @@
|
||||||
#include <catch2/internal/catch_compiler_capabilities.hpp>
|
#include <catch2/internal/catch_compiler_capabilities.hpp>
|
||||||
#include <catch2/internal/catch_config_android_logwrite.hpp>
|
#include <catch2/internal/catch_config_android_logwrite.hpp>
|
||||||
#include <catch2/internal/catch_config_counter.hpp>
|
#include <catch2/internal/catch_config_counter.hpp>
|
||||||
|
#include <catch2/internal/catch_config_prefix_messages.hpp>
|
||||||
|
#include <catch2/internal/catch_config_static_analysis_support.hpp>
|
||||||
#include <catch2/internal/catch_config_uncaught_exceptions.hpp>
|
#include <catch2/internal/catch_config_uncaught_exceptions.hpp>
|
||||||
#include <catch2/internal/catch_config_wchar.hpp>
|
#include <catch2/internal/catch_config_wchar.hpp>
|
||||||
#include <catch2/internal/catch_console_colour.hpp>
|
#include <catch2/internal/catch_console_colour.hpp>
|
||||||
|
@ -70,7 +72,9 @@
|
||||||
#include <catch2/internal/catch_fatal_condition_handler.hpp>
|
#include <catch2/internal/catch_fatal_condition_handler.hpp>
|
||||||
#include <catch2/internal/catch_floating_point_helpers.hpp>
|
#include <catch2/internal/catch_floating_point_helpers.hpp>
|
||||||
#include <catch2/internal/catch_getenv.hpp>
|
#include <catch2/internal/catch_getenv.hpp>
|
||||||
|
#include <catch2/internal/catch_is_permutation.hpp>
|
||||||
#include <catch2/internal/catch_istream.hpp>
|
#include <catch2/internal/catch_istream.hpp>
|
||||||
|
#include <catch2/internal/catch_jsonwriter.hpp>
|
||||||
#include <catch2/internal/catch_lazy_expr.hpp>
|
#include <catch2/internal/catch_lazy_expr.hpp>
|
||||||
#include <catch2/internal/catch_leak_detector.hpp>
|
#include <catch2/internal/catch_leak_detector.hpp>
|
||||||
#include <catch2/internal/catch_list.hpp>
|
#include <catch2/internal/catch_list.hpp>
|
||||||
|
@ -85,7 +89,10 @@
|
||||||
#include <catch2/internal/catch_platform.hpp>
|
#include <catch2/internal/catch_platform.hpp>
|
||||||
#include <catch2/internal/catch_polyfills.hpp>
|
#include <catch2/internal/catch_polyfills.hpp>
|
||||||
#include <catch2/internal/catch_preprocessor.hpp>
|
#include <catch2/internal/catch_preprocessor.hpp>
|
||||||
|
#include <catch2/internal/catch_preprocessor_internal_stringify.hpp>
|
||||||
#include <catch2/internal/catch_preprocessor_remove_parens.hpp>
|
#include <catch2/internal/catch_preprocessor_remove_parens.hpp>
|
||||||
|
#include <catch2/internal/catch_random_floating_point_helpers.hpp>
|
||||||
|
#include <catch2/internal/catch_random_integer_helpers.hpp>
|
||||||
#include <catch2/internal/catch_random_number_generator.hpp>
|
#include <catch2/internal/catch_random_number_generator.hpp>
|
||||||
#include <catch2/internal/catch_random_seed_generation.hpp>
|
#include <catch2/internal/catch_random_seed_generation.hpp>
|
||||||
#include <catch2/internal/catch_reporter_registry.hpp>
|
#include <catch2/internal/catch_reporter_registry.hpp>
|
||||||
|
@ -110,10 +117,13 @@
|
||||||
#include <catch2/internal/catch_test_failure_exception.hpp>
|
#include <catch2/internal/catch_test_failure_exception.hpp>
|
||||||
#include <catch2/internal/catch_test_macro_impl.hpp>
|
#include <catch2/internal/catch_test_macro_impl.hpp>
|
||||||
#include <catch2/internal/catch_test_registry.hpp>
|
#include <catch2/internal/catch_test_registry.hpp>
|
||||||
|
#include <catch2/internal/catch_test_run_info.hpp>
|
||||||
#include <catch2/internal/catch_test_spec_parser.hpp>
|
#include <catch2/internal/catch_test_spec_parser.hpp>
|
||||||
#include <catch2/internal/catch_textflow.hpp>
|
#include <catch2/internal/catch_textflow.hpp>
|
||||||
#include <catch2/internal/catch_to_string.hpp>
|
#include <catch2/internal/catch_to_string.hpp>
|
||||||
#include <catch2/internal/catch_uncaught_exceptions.hpp>
|
#include <catch2/internal/catch_uncaught_exceptions.hpp>
|
||||||
|
#include <catch2/internal/catch_uniform_floating_point_distribution.hpp>
|
||||||
|
#include <catch2/internal/catch_uniform_integer_distribution.hpp>
|
||||||
#include <catch2/internal/catch_unique_name.hpp>
|
#include <catch2/internal/catch_unique_name.hpp>
|
||||||
#include <catch2/internal/catch_unique_ptr.hpp>
|
#include <catch2/internal/catch_unique_ptr.hpp>
|
||||||
#include <catch2/internal/catch_void_type.hpp>
|
#include <catch2/internal/catch_void_type.hpp>
|
||||||
|
|
4
externals/catch/src/catch2/catch_approx.cpp
vendored
4
externals/catch/src/catch2/catch_approx.cpp
vendored
|
@ -70,10 +70,10 @@ namespace Catch {
|
||||||
}
|
}
|
||||||
|
|
||||||
namespace literals {
|
namespace literals {
|
||||||
Approx operator "" _a(long double val) {
|
Approx operator ""_a(long double val) {
|
||||||
return Approx(val);
|
return Approx(val);
|
||||||
}
|
}
|
||||||
Approx operator "" _a(unsigned long long val) {
|
Approx operator ""_a(unsigned long long val) {
|
||||||
return Approx(val);
|
return Approx(val);
|
||||||
}
|
}
|
||||||
} // end namespace literals
|
} // end namespace literals
|
||||||
|
|
|
@ -7,6 +7,7 @@
|
||||||
// SPDX-License-Identifier: BSL-1.0
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
#include <catch2/catch_assertion_result.hpp>
|
#include <catch2/catch_assertion_result.hpp>
|
||||||
#include <catch2/internal/catch_reusable_string_stream.hpp>
|
#include <catch2/internal/catch_reusable_string_stream.hpp>
|
||||||
|
#include <catch2/internal/catch_move_and_forward.hpp>
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
|
|
||||||
|
@ -26,9 +27,9 @@ namespace Catch {
|
||||||
return reconstructedExpression;
|
return reconstructedExpression;
|
||||||
}
|
}
|
||||||
|
|
||||||
AssertionResult::AssertionResult( AssertionInfo const& info, AssertionResultData const& data )
|
AssertionResult::AssertionResult( AssertionInfo const& info, AssertionResultData&& data )
|
||||||
: m_info( info ),
|
: m_info( info ),
|
||||||
m_resultData( data )
|
m_resultData( CATCH_MOVE(data) )
|
||||||
{}
|
{}
|
||||||
|
|
||||||
// Result was a success
|
// Result was a success
|
||||||
|
@ -67,16 +68,15 @@ namespace Catch {
|
||||||
}
|
}
|
||||||
|
|
||||||
std::string AssertionResult::getExpressionInMacro() const {
|
std::string AssertionResult::getExpressionInMacro() const {
|
||||||
|
if ( m_info.macroName.empty() ) {
|
||||||
|
return static_cast<std::string>( m_info.capturedExpression );
|
||||||
|
}
|
||||||
std::string expr;
|
std::string expr;
|
||||||
if( m_info.macroName.empty() )
|
|
||||||
expr = static_cast<std::string>(m_info.capturedExpression);
|
|
||||||
else {
|
|
||||||
expr.reserve( m_info.macroName.size() + m_info.capturedExpression.size() + 4 );
|
expr.reserve( m_info.macroName.size() + m_info.capturedExpression.size() + 4 );
|
||||||
expr += m_info.macroName;
|
expr += m_info.macroName;
|
||||||
expr += "( ";
|
expr += "( ";
|
||||||
expr += m_info.capturedExpression;
|
expr += m_info.capturedExpression;
|
||||||
expr += " )";
|
expr += " )";
|
||||||
}
|
|
||||||
return expr;
|
return expr;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
|
@ -35,7 +35,7 @@ namespace Catch {
|
||||||
class AssertionResult {
|
class AssertionResult {
|
||||||
public:
|
public:
|
||||||
AssertionResult() = delete;
|
AssertionResult() = delete;
|
||||||
AssertionResult( AssertionInfo const& info, AssertionResultData const& data );
|
AssertionResult( AssertionInfo const& info, AssertionResultData&& data );
|
||||||
|
|
||||||
bool isOk() const;
|
bool isOk() const;
|
||||||
bool succeeded() const;
|
bool succeeded() const;
|
||||||
|
|
2
externals/catch/src/catch2/catch_config.cpp
vendored
2
externals/catch/src/catch2/catch_config.cpp
vendored
|
@ -105,7 +105,7 @@ namespace Catch {
|
||||||
elem = trim(elem);
|
elem = trim(elem);
|
||||||
}
|
}
|
||||||
|
|
||||||
// Insert the default reporter if user hasn't asked for a specfic one
|
// Insert the default reporter if user hasn't asked for a specific one
|
||||||
if ( m_data.reporterSpecifications.empty() ) {
|
if ( m_data.reporterSpecifications.empty() ) {
|
||||||
m_data.reporterSpecifications.push_back( {
|
m_data.reporterSpecifications.push_back( {
|
||||||
#if defined( CATCH_CONFIG_DEFAULT_REPORTER )
|
#if defined( CATCH_CONFIG_DEFAULT_REPORTER )
|
||||||
|
|
10
externals/catch/src/catch2/catch_message.cpp
vendored
10
externals/catch/src/catch2/catch_message.cpp
vendored
|
@ -19,8 +19,8 @@ namespace Catch {
|
||||||
////////////////////////////////////////////////////////////////////////////
|
////////////////////////////////////////////////////////////////////////////
|
||||||
|
|
||||||
|
|
||||||
ScopedMessage::ScopedMessage( MessageBuilder const& builder ):
|
ScopedMessage::ScopedMessage( MessageBuilder&& builder ):
|
||||||
m_info( builder.m_info ) {
|
m_info( CATCH_MOVE(builder.m_info) ) {
|
||||||
m_info.message = builder.m_stream.str();
|
m_info.message = builder.m_stream.str();
|
||||||
getResultCapture().pushScopedMessage( m_info );
|
getResultCapture().pushScopedMessage( m_info );
|
||||||
}
|
}
|
||||||
|
@ -37,7 +37,11 @@ namespace Catch {
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
Capturer::Capturer( StringRef macroName, SourceLineInfo const& lineInfo, ResultWas::OfType resultType, StringRef names ) {
|
Capturer::Capturer( StringRef macroName,
|
||||||
|
SourceLineInfo const& lineInfo,
|
||||||
|
ResultWas::OfType resultType,
|
||||||
|
StringRef names ):
|
||||||
|
m_resultCapture( getResultCapture() ) {
|
||||||
auto trimmed = [&] (size_t start, size_t end) {
|
auto trimmed = [&] (size_t start, size_t end) {
|
||||||
while (names[start] == ',' || isspace(static_cast<unsigned char>(names[start]))) {
|
while (names[start] == ',' || isspace(static_cast<unsigned char>(names[start]))) {
|
||||||
++start;
|
++start;
|
||||||
|
|
26
externals/catch/src/catch2/catch_message.hpp
vendored
26
externals/catch/src/catch2/catch_message.hpp
vendored
|
@ -8,12 +8,13 @@
|
||||||
#ifndef CATCH_MESSAGE_HPP_INCLUDED
|
#ifndef CATCH_MESSAGE_HPP_INCLUDED
|
||||||
#define CATCH_MESSAGE_HPP_INCLUDED
|
#define CATCH_MESSAGE_HPP_INCLUDED
|
||||||
|
|
||||||
|
#include <catch2/internal/catch_config_prefix_messages.hpp>
|
||||||
#include <catch2/internal/catch_result_type.hpp>
|
#include <catch2/internal/catch_result_type.hpp>
|
||||||
#include <catch2/internal/catch_reusable_string_stream.hpp>
|
#include <catch2/internal/catch_reusable_string_stream.hpp>
|
||||||
#include <catch2/internal/catch_stream_end_stop.hpp>
|
#include <catch2/internal/catch_stream_end_stop.hpp>
|
||||||
#include <catch2/internal/catch_message_info.hpp>
|
#include <catch2/internal/catch_message_info.hpp>
|
||||||
#include <catch2/interfaces/catch_interfaces_capture.hpp>
|
|
||||||
#include <catch2/catch_tostring.hpp>
|
#include <catch2/catch_tostring.hpp>
|
||||||
|
#include <catch2/interfaces/catch_interfaces_capture.hpp>
|
||||||
|
|
||||||
#include <string>
|
#include <string>
|
||||||
#include <vector>
|
#include <vector>
|
||||||
|
@ -21,6 +22,7 @@
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
|
|
||||||
struct SourceLineInfo;
|
struct SourceLineInfo;
|
||||||
|
class IResultCapture;
|
||||||
|
|
||||||
struct MessageStream {
|
struct MessageStream {
|
||||||
|
|
||||||
|
@ -39,11 +41,10 @@ namespace Catch {
|
||||||
ResultWas::OfType type ):
|
ResultWas::OfType type ):
|
||||||
m_info(macroName, lineInfo, type) {}
|
m_info(macroName, lineInfo, type) {}
|
||||||
|
|
||||||
|
|
||||||
template<typename T>
|
template<typename T>
|
||||||
MessageBuilder& operator << ( T const& value ) {
|
MessageBuilder&& operator << ( T const& value ) && {
|
||||||
m_stream << value;
|
m_stream << value;
|
||||||
return *this;
|
return CATCH_MOVE(*this);
|
||||||
}
|
}
|
||||||
|
|
||||||
MessageInfo m_info;
|
MessageInfo m_info;
|
||||||
|
@ -51,7 +52,7 @@ namespace Catch {
|
||||||
|
|
||||||
class ScopedMessage {
|
class ScopedMessage {
|
||||||
public:
|
public:
|
||||||
explicit ScopedMessage( MessageBuilder const& builder );
|
explicit ScopedMessage( MessageBuilder&& builder );
|
||||||
ScopedMessage( ScopedMessage& duplicate ) = delete;
|
ScopedMessage( ScopedMessage& duplicate ) = delete;
|
||||||
ScopedMessage( ScopedMessage&& old ) noexcept;
|
ScopedMessage( ScopedMessage&& old ) noexcept;
|
||||||
~ScopedMessage();
|
~ScopedMessage();
|
||||||
|
@ -62,7 +63,7 @@ namespace Catch {
|
||||||
|
|
||||||
class Capturer {
|
class Capturer {
|
||||||
std::vector<MessageInfo> m_messages;
|
std::vector<MessageInfo> m_messages;
|
||||||
IResultCapture& m_resultCapture = getResultCapture();
|
IResultCapture& m_resultCapture;
|
||||||
size_t m_captured = 0;
|
size_t m_captured = 0;
|
||||||
public:
|
public:
|
||||||
Capturer( StringRef macroName, SourceLineInfo const& lineInfo, ResultWas::OfType resultType, StringRef names );
|
Capturer( StringRef macroName, SourceLineInfo const& lineInfo, ResultWas::OfType resultType, StringRef names );
|
||||||
|
@ -98,7 +99,10 @@ namespace Catch {
|
||||||
|
|
||||||
///////////////////////////////////////////////////////////////////////////////
|
///////////////////////////////////////////////////////////////////////////////
|
||||||
#define INTERNAL_CATCH_CAPTURE( varName, macroName, ... ) \
|
#define INTERNAL_CATCH_CAPTURE( varName, macroName, ... ) \
|
||||||
Catch::Capturer varName( macroName, CATCH_INTERNAL_LINEINFO, Catch::ResultWas::Info, #__VA_ARGS__ ); \
|
Catch::Capturer varName( macroName##_catch_sr, \
|
||||||
|
CATCH_INTERNAL_LINEINFO, \
|
||||||
|
Catch::ResultWas::Info, \
|
||||||
|
#__VA_ARGS__##_catch_sr ); \
|
||||||
varName.captureValues( 0, __VA_ARGS__ )
|
varName.captureValues( 0, __VA_ARGS__ )
|
||||||
|
|
||||||
///////////////////////////////////////////////////////////////////////////////
|
///////////////////////////////////////////////////////////////////////////////
|
||||||
|
@ -110,28 +114,28 @@ namespace Catch {
|
||||||
Catch::getResultCapture().emplaceUnscopedMessage( Catch::MessageBuilder( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, Catch::ResultWas::Info ) << log )
|
Catch::getResultCapture().emplaceUnscopedMessage( Catch::MessageBuilder( macroName##_catch_sr, CATCH_INTERNAL_LINEINFO, Catch::ResultWas::Info ) << log )
|
||||||
|
|
||||||
|
|
||||||
#if defined(CATCH_CONFIG_PREFIX_ALL) && !defined(CATCH_CONFIG_DISABLE)
|
#if defined(CATCH_CONFIG_PREFIX_MESSAGES) && !defined(CATCH_CONFIG_DISABLE)
|
||||||
|
|
||||||
#define CATCH_INFO( msg ) INTERNAL_CATCH_INFO( "CATCH_INFO", msg )
|
#define CATCH_INFO( msg ) INTERNAL_CATCH_INFO( "CATCH_INFO", msg )
|
||||||
#define CATCH_UNSCOPED_INFO( msg ) INTERNAL_CATCH_UNSCOPED_INFO( "CATCH_UNSCOPED_INFO", msg )
|
#define CATCH_UNSCOPED_INFO( msg ) INTERNAL_CATCH_UNSCOPED_INFO( "CATCH_UNSCOPED_INFO", msg )
|
||||||
#define CATCH_WARN( msg ) INTERNAL_CATCH_MSG( "CATCH_WARN", Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, msg )
|
#define CATCH_WARN( msg ) INTERNAL_CATCH_MSG( "CATCH_WARN", Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, msg )
|
||||||
#define CATCH_CAPTURE( ... ) INTERNAL_CATCH_CAPTURE( INTERNAL_CATCH_UNIQUE_NAME(capturer), "CATCH_CAPTURE", __VA_ARGS__ )
|
#define CATCH_CAPTURE( ... ) INTERNAL_CATCH_CAPTURE( INTERNAL_CATCH_UNIQUE_NAME(capturer), "CATCH_CAPTURE", __VA_ARGS__ )
|
||||||
|
|
||||||
#elif defined(CATCH_CONFIG_PREFIX_ALL) && defined(CATCH_CONFIG_DISABLE)
|
#elif defined(CATCH_CONFIG_PREFIX_MESSAGES) && defined(CATCH_CONFIG_DISABLE)
|
||||||
|
|
||||||
#define CATCH_INFO( msg ) (void)(0)
|
#define CATCH_INFO( msg ) (void)(0)
|
||||||
#define CATCH_UNSCOPED_INFO( msg ) (void)(0)
|
#define CATCH_UNSCOPED_INFO( msg ) (void)(0)
|
||||||
#define CATCH_WARN( msg ) (void)(0)
|
#define CATCH_WARN( msg ) (void)(0)
|
||||||
#define CATCH_CAPTURE( ... ) (void)(0)
|
#define CATCH_CAPTURE( ... ) (void)(0)
|
||||||
|
|
||||||
#elif !defined(CATCH_CONFIG_PREFIX_ALL) && !defined(CATCH_CONFIG_DISABLE)
|
#elif !defined(CATCH_CONFIG_PREFIX_MESSAGES) && !defined(CATCH_CONFIG_DISABLE)
|
||||||
|
|
||||||
#define INFO( msg ) INTERNAL_CATCH_INFO( "INFO", msg )
|
#define INFO( msg ) INTERNAL_CATCH_INFO( "INFO", msg )
|
||||||
#define UNSCOPED_INFO( msg ) INTERNAL_CATCH_UNSCOPED_INFO( "UNSCOPED_INFO", msg )
|
#define UNSCOPED_INFO( msg ) INTERNAL_CATCH_UNSCOPED_INFO( "UNSCOPED_INFO", msg )
|
||||||
#define WARN( msg ) INTERNAL_CATCH_MSG( "WARN", Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, msg )
|
#define WARN( msg ) INTERNAL_CATCH_MSG( "WARN", Catch::ResultWas::Warning, Catch::ResultDisposition::ContinueOnFailure, msg )
|
||||||
#define CAPTURE( ... ) INTERNAL_CATCH_CAPTURE( INTERNAL_CATCH_UNIQUE_NAME(capturer), "CAPTURE", __VA_ARGS__ )
|
#define CAPTURE( ... ) INTERNAL_CATCH_CAPTURE( INTERNAL_CATCH_UNIQUE_NAME(capturer), "CAPTURE", __VA_ARGS__ )
|
||||||
|
|
||||||
#elif !defined(CATCH_CONFIG_PREFIX_ALL) && defined(CATCH_CONFIG_DISABLE)
|
#elif !defined(CATCH_CONFIG_PREFIX_MESSAGES) && defined(CATCH_CONFIG_DISABLE)
|
||||||
|
|
||||||
#define INFO( msg ) (void)(0)
|
#define INFO( msg ) (void)(0)
|
||||||
#define UNSCOPED_INFO( msg ) (void)(0)
|
#define UNSCOPED_INFO( msg ) (void)(0)
|
||||||
|
|
|
@ -20,6 +20,9 @@
|
||||||
#include <catch2/internal/catch_noncopyable.hpp>
|
#include <catch2/internal/catch_noncopyable.hpp>
|
||||||
#include <catch2/interfaces/catch_interfaces_reporter_factory.hpp>
|
#include <catch2/interfaces/catch_interfaces_reporter_factory.hpp>
|
||||||
#include <catch2/internal/catch_move_and_forward.hpp>
|
#include <catch2/internal/catch_move_and_forward.hpp>
|
||||||
|
#include <catch2/internal/catch_reporter_registry.hpp>
|
||||||
|
|
||||||
|
#include <exception>
|
||||||
|
|
||||||
namespace Catch {
|
namespace Catch {
|
||||||
|
|
||||||
|
@ -31,7 +34,7 @@ namespace Catch {
|
||||||
|
|
||||||
public: // IRegistryHub
|
public: // IRegistryHub
|
||||||
RegistryHub() = default;
|
RegistryHub() = default;
|
||||||
IReporterRegistry const& getReporterRegistry() const override {
|
ReporterRegistry const& getReporterRegistry() const override {
|
||||||
return m_reporterRegistry;
|
return m_reporterRegistry;
|
||||||
}
|
}
|
||||||
ITestCaseRegistry const& getTestCaseRegistry() const override {
|
ITestCaseRegistry const& getTestCaseRegistry() const override {
|
||||||
|
|
11
externals/catch/src/catch2/catch_session.cpp
vendored
11
externals/catch/src/catch2/catch_session.cpp
vendored
|
@ -13,13 +13,13 @@
|
||||||
#include <catch2/internal/catch_run_context.hpp>
|
#include <catch2/internal/catch_run_context.hpp>
|
||||||
#include <catch2/catch_test_spec.hpp>
|
#include <catch2/catch_test_spec.hpp>
|
||||||
#include <catch2/catch_version.hpp>
|
#include <catch2/catch_version.hpp>
|
||||||
#include <catch2/interfaces/catch_interfaces_reporter.hpp>
|
|
||||||
#include <catch2/internal/catch_startup_exception_registry.hpp>
|
#include <catch2/internal/catch_startup_exception_registry.hpp>
|
||||||
#include <catch2/internal/catch_sharding.hpp>
|
#include <catch2/internal/catch_sharding.hpp>
|
||||||
|
#include <catch2/internal/catch_test_case_registry_impl.hpp>
|
||||||
#include <catch2/internal/catch_textflow.hpp>
|
#include <catch2/internal/catch_textflow.hpp>
|
||||||
#include <catch2/internal/catch_windows_h_proxy.hpp>
|
#include <catch2/internal/catch_windows_h_proxy.hpp>
|
||||||
#include <catch2/reporters/catch_reporter_multi.hpp>
|
#include <catch2/reporters/catch_reporter_multi.hpp>
|
||||||
#include <catch2/interfaces/catch_interfaces_reporter_registry.hpp>
|
#include <catch2/internal/catch_reporter_registry.hpp>
|
||||||
#include <catch2/interfaces/catch_interfaces_reporter_factory.hpp>
|
#include <catch2/interfaces/catch_interfaces_reporter_factory.hpp>
|
||||||
#include <catch2/internal/catch_move_and_forward.hpp>
|
#include <catch2/internal/catch_move_and_forward.hpp>
|
||||||
#include <catch2/internal/catch_stdstreams.hpp>
|
#include <catch2/internal/catch_stdstreams.hpp>
|
||||||
|
@ -27,6 +27,7 @@
|
||||||
|
|
||||||
#include <algorithm>
|
#include <algorithm>
|
||||||
#include <cassert>
|
#include <cassert>
|
||||||
|
#include <exception>
|
||||||
#include <iomanip>
|
#include <iomanip>
|
||||||
#include <set>
|
#include <set>
|
||||||
|
|
||||||
|
@ -341,6 +342,12 @@ namespace Catch {
|
||||||
return 2;
|
return 2;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
if ( totals.testCases.total() > 0 &&
|
||||||
|
totals.testCases.total() == totals.testCases.skipped
|
||||||
|
&& !m_config->zeroTestsCountAsSuccess() ) {
|
||||||
|
return 4;
|
||||||
|
}
|
||||||
|
|
||||||
// Note that on unices only the lower 8 bits are usually used, clamping
|
// Note that on unices only the lower 8 bits are usually used, clamping
|
||||||
// the return value to 255 prevents false negative when some multiple
|
// the return value to 255 prevents false negative when some multiple
|
||||||
// of 256 tests has failed
|
// of 256 tests has failed
|
||||||
|
|
|
@ -139,12 +139,20 @@ namespace Catch {
|
||||||
for (size_t idx = 0; idx < originalTags.size(); ++idx) {
|
for (size_t idx = 0; idx < originalTags.size(); ++idx) {
|
||||||
auto c = originalTags[idx];
|
auto c = originalTags[idx];
|
||||||
if (c == '[') {
|
if (c == '[') {
|
||||||
assert(!inTag);
|
CATCH_ENFORCE(
|
||||||
|
!inTag,
|
||||||
|
"Found '[' inside a tag while registering test case '"
|
||||||
|
<< _nameAndTags.name << "' at " << _lineInfo );
|
||||||
|
|
||||||
inTag = true;
|
inTag = true;
|
||||||
tagStart = idx;
|
tagStart = idx;
|
||||||
}
|
}
|
||||||
if (c == ']') {
|
if (c == ']') {
|
||||||
assert(inTag);
|
CATCH_ENFORCE(
|
||||||
|
inTag,
|
||||||
|
"Found unmatched ']' while registering test case '"
|
||||||
|
<< _nameAndTags.name << "' at " << _lineInfo );
|
||||||
|
|
||||||
inTag = false;
|
inTag = false;
|
||||||
tagEnd = idx;
|
tagEnd = idx;
|
||||||
assert(tagStart < tagEnd);
|
assert(tagStart < tagEnd);
|
||||||
|
@ -153,7 +161,11 @@ namespace Catch {
|
||||||
// it over to backing storage and actually reference the
|
// it over to backing storage and actually reference the
|
||||||
// backing storage in the saved tags
|
// backing storage in the saved tags
|
||||||
StringRef tagStr = originalTags.substr(tagStart+1, tagEnd - tagStart - 1);
|
StringRef tagStr = originalTags.substr(tagStart+1, tagEnd - tagStart - 1);
|
||||||
CATCH_ENFORCE(!tagStr.empty(), "Empty tags are not allowed");
|
CATCH_ENFORCE( !tagStr.empty(),
|
||||||
|
"Found an empty tag while registering test case '"
|
||||||
|
<< _nameAndTags.name << "' at "
|
||||||
|
<< _lineInfo );
|
||||||
|
|
||||||
enforceNotReservedTag(tagStr, lineInfo);
|
enforceNotReservedTag(tagStr, lineInfo);
|
||||||
properties |= parseSpecialTag(tagStr);
|
properties |= parseSpecialTag(tagStr);
|
||||||
// When copying a tag to the backing storage, we need to
|
// When copying a tag to the backing storage, we need to
|
||||||
|
@ -167,8 +179,12 @@ namespace Catch {
|
||||||
// the tags.
|
// the tags.
|
||||||
internalAppendTag(tagStr);
|
internalAppendTag(tagStr);
|
||||||
}
|
}
|
||||||
(void)inTag; // Silence "set-but-unused" warning in release mode.
|
|
||||||
}
|
}
|
||||||
|
CATCH_ENFORCE( !inTag,
|
||||||
|
"Found an unclosed tag while registering test case '"
|
||||||
|
<< _nameAndTags.name << "' at " << _lineInfo );
|
||||||
|
|
||||||
|
|
||||||
// Add [.] if relevant
|
// Add [.] if relevant
|
||||||
if (isHidden()) {
|
if (isHidden()) {
|
||||||
internalAppendTag("."_sr);
|
internalAppendTag("."_sr);
|
||||||
|
|
|
@ -15,6 +15,7 @@
|
||||||
#include <catch2/internal/catch_unique_ptr.hpp>
|
#include <catch2/internal/catch_unique_ptr.hpp>
|
||||||
|
|
||||||
|
|
||||||
|
#include <cstdint>
|
||||||
#include <string>
|
#include <string>
|
||||||
#include <vector>
|
#include <vector>
|
||||||
|
|
||||||
|
|
|
@ -49,6 +49,7 @@
|
||||||
#define CATCH_FAIL( ... ) INTERNAL_CATCH_MSG( "CATCH_FAIL", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, __VA_ARGS__ )
|
#define CATCH_FAIL( ... ) INTERNAL_CATCH_MSG( "CATCH_FAIL", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, __VA_ARGS__ )
|
||||||
#define CATCH_FAIL_CHECK( ... ) INTERNAL_CATCH_MSG( "CATCH_FAIL_CHECK", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
|
#define CATCH_FAIL_CHECK( ... ) INTERNAL_CATCH_MSG( "CATCH_FAIL_CHECK", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
|
||||||
#define CATCH_SUCCEED( ... ) INTERNAL_CATCH_MSG( "CATCH_SUCCEED", Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
|
#define CATCH_SUCCEED( ... ) INTERNAL_CATCH_MSG( "CATCH_SUCCEED", Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
|
||||||
|
#define CATCH_SKIP( ... ) INTERNAL_CATCH_MSG( "SKIP", Catch::ResultWas::ExplicitSkip, Catch::ResultDisposition::Normal, __VA_ARGS__ )
|
||||||
|
|
||||||
|
|
||||||
#if !defined(CATCH_CONFIG_RUNTIME_STATIC_REQUIRE)
|
#if !defined(CATCH_CONFIG_RUNTIME_STATIC_REQUIRE)
|
||||||
|
@ -102,6 +103,7 @@
|
||||||
#define CATCH_FAIL( ... ) (void)(0)
|
#define CATCH_FAIL( ... ) (void)(0)
|
||||||
#define CATCH_FAIL_CHECK( ... ) (void)(0)
|
#define CATCH_FAIL_CHECK( ... ) (void)(0)
|
||||||
#define CATCH_SUCCEED( ... ) (void)(0)
|
#define CATCH_SUCCEED( ... ) (void)(0)
|
||||||
|
#define CATCH_SKIP( ... ) (void)(0)
|
||||||
|
|
||||||
#define CATCH_STATIC_REQUIRE( ... ) (void)(0)
|
#define CATCH_STATIC_REQUIRE( ... ) (void)(0)
|
||||||
#define CATCH_STATIC_REQUIRE_FALSE( ... ) (void)(0)
|
#define CATCH_STATIC_REQUIRE_FALSE( ... ) (void)(0)
|
||||||
|
@ -146,6 +148,7 @@
|
||||||
#define FAIL( ... ) INTERNAL_CATCH_MSG( "FAIL", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, __VA_ARGS__ )
|
#define FAIL( ... ) INTERNAL_CATCH_MSG( "FAIL", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::Normal, __VA_ARGS__ )
|
||||||
#define FAIL_CHECK( ... ) INTERNAL_CATCH_MSG( "FAIL_CHECK", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
|
#define FAIL_CHECK( ... ) INTERNAL_CATCH_MSG( "FAIL_CHECK", Catch::ResultWas::ExplicitFailure, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
|
||||||
#define SUCCEED( ... ) INTERNAL_CATCH_MSG( "SUCCEED", Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
|
#define SUCCEED( ... ) INTERNAL_CATCH_MSG( "SUCCEED", Catch::ResultWas::Ok, Catch::ResultDisposition::ContinueOnFailure, __VA_ARGS__ )
|
||||||
|
#define SKIP( ... ) INTERNAL_CATCH_MSG( "SKIP", Catch::ResultWas::ExplicitSkip, Catch::ResultDisposition::Normal, __VA_ARGS__ )
|
||||||
|
|
||||||
|
|
||||||
#if !defined(CATCH_CONFIG_RUNTIME_STATIC_REQUIRE)
|
#if !defined(CATCH_CONFIG_RUNTIME_STATIC_REQUIRE)
|
||||||
|
@ -198,6 +201,7 @@
|
||||||
#define FAIL( ... ) (void)(0)
|
#define FAIL( ... ) (void)(0)
|
||||||
#define FAIL_CHECK( ... ) (void)(0)
|
#define FAIL_CHECK( ... ) (void)(0)
|
||||||
#define SUCCEED( ... ) (void)(0)
|
#define SUCCEED( ... ) (void)(0)
|
||||||
|
#define SKIP( ... ) (void)(0)
|
||||||
|
|
||||||
#define STATIC_REQUIRE( ... ) (void)(0)
|
#define STATIC_REQUIRE( ... ) (void)(0)
|
||||||
#define STATIC_REQUIRE_FALSE( ... ) (void)(0)
|
#define STATIC_REQUIRE_FALSE( ... ) (void)(0)
|
||||||
|
|
20
externals/catch/src/catch2/catch_test_spec.cpp
vendored
20
externals/catch/src/catch2/catch_test_spec.cpp
vendored
|
@ -6,6 +6,8 @@
|
||||||
|
|
||||||
// SPDX-License-Identifier: BSL-1.0
|
// SPDX-License-Identifier: BSL-1.0
|
||||||
#include <catch2/catch_test_spec.hpp>
|
#include <catch2/catch_test_spec.hpp>
|
||||||
|
#include <catch2/interfaces/catch_interfaces_testcase.hpp>
|
||||||
|
#include <catch2/internal/catch_test_case_registry_impl.hpp>
|
||||||
#include <catch2/internal/catch_reusable_string_stream.hpp>
|
#include <catch2/internal/catch_reusable_string_stream.hpp>
|
||||||
#include <catch2/internal/catch_string_manip.hpp>
|
#include <catch2/internal/catch_string_manip.hpp>
|
||||||
#include <catch2/catch_test_case_info.hpp>
|
#include <catch2/catch_test_case_info.hpp>
|
||||||
|
@ -106,16 +108,18 @@ namespace Catch {
|
||||||
return std::any_of( m_filters.begin(), m_filters.end(), [&]( Filter const& f ){ return f.matches( testCase ); } );
|
return std::any_of( m_filters.begin(), m_filters.end(), [&]( Filter const& f ){ return f.matches( testCase ); } );
|
||||||
}
|
}
|
||||||
|
|
||||||
TestSpec::Matches TestSpec::matchesByFilter( std::vector<TestCaseHandle> const& testCases, IConfig const& config ) const
|
TestSpec::Matches TestSpec::matchesByFilter( std::vector<TestCaseHandle> const& testCases, IConfig const& config ) const {
|
||||||
{
|
Matches matches;
|
||||||
Matches matches( m_filters.size() );
|
matches.reserve( m_filters.size() );
|
||||||
std::transform( m_filters.begin(), m_filters.end(), matches.begin(), [&]( Filter const& filter ){
|
for ( auto const& filter : m_filters ) {
|
||||||
std::vector<TestCaseHandle const*> currentMatches;
|
std::vector<TestCaseHandle const*> currentMatches;
|
||||||
for( auto const& test : testCases )
|
for ( auto const& test : testCases )
|
||||||
if( isThrowSafe( test, config ) && filter.matches( test.getTestCaseInfo() ) )
|
if ( isThrowSafe( test, config ) &&
|
||||||
|
filter.matches( test.getTestCaseInfo() ) )
|
||||||
currentMatches.emplace_back( &test );
|
currentMatches.emplace_back( &test );
|
||||||
return FilterMatch{ extractFilterName(filter), currentMatches };
|
matches.push_back(
|
||||||
} );
|
FilterMatch{ extractFilterName( filter ), currentMatches } );
|
||||||
|
}
|
||||||
return matches;
|
return matches;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
Some files were not shown because too many files have changed in this diff Show more
Loading…
Reference in a new issue