4 * Fixed compilation for strict C++98 mode (ie not gnu++98) and older compilers (#1103)
5 * `INFO` messages are included in the `xml` reporter output even without `-s` specified.
12 * The original expression in `REQUIRE_FALSE( expr )` is now reporter properly as `!( expr )` (#1051)
13 * Previously the parentheses were missing and `x != y` would be expanded as `!x != x`
14 * `Approx::Margin` is now inclusive (#952)
15 * Previously it was meant and documented as inclusive, but the check itself wasn't
16 * This means that `REQUIRE( 0.25f == Approx( 0.0f ).margin( 0.25f ) )` passes, instead of fails
17 * `RandomNumberGenerator::result_type` is now unsigned (#1050)
20 * `__JETBRAINS_IDE__` macro handling is now CLion version specific (#1017)
21 * When CLion 2017.3 or newer is detected, `__COUNTER__` is used instead of
22 * TeamCity reporter now explicitly flushes output stream after each report (#1057)
23 * On some platforms, output from redirected streams would show up only after the tests finished running
24 * `ParseAndAddCatchTests` now can add test files as dependency to CMake configuration
25 * This means you do not have to manually rerun CMake configuration step to detect new tests
31 * Evaluation layer has been rewritten (backported from Catch 2)
32 * The new layer is much simpler and fixes some issues (#981)
33 * Implemented workaround for VS 2017 raw string literal stringification bug (#995)
34 * Fixed interaction between `[!shouldfail]` and `[!mayfail]` tags and sections
35 * Previously sections with failing assertions would be marked as failed, not failed-but-ok
38 * Added [libidentify](https://github.com/janwilmans/LibIdentify) support
39 * Added "wait-for-keypress" option
45 * Various warnings from clang-tidy, Resharper-C++ and PVS Studio have been addressed (#957)
46 * Dynamically generated sections are now properly reported (#963)
47 * Writes to `std::clog` are redirected for reporters (#989)
48 * Previously only `std::cerr` writes were redirected
49 * Interleaved writes to `std::cerr` and `std::clog` are combined properly
50 * Assertions failed before signals/structured exceptions fails test case are properly reported as failed (#990)
53 * Catch's runtime overhead has been decreased further (#940)
54 * Added support for IBM i ILE c++ compiler (#976)
55 * This means that AS/400 is now supported.
56 * The default reporter can be configured at compile time (#978)
57 * That is, the reporter used if no reporter is explicitly specified
60 * `ParseAndAddCatchTests` cmake script has couple new customization options
67 * Catch's runtime overhead has been significantly decreased (#937, #939)
68 * Added `--list-extra-info` cli option (#934).
69 * It lists all tests together with extra information, ie filename, line number and description.
76 * Truthy expressions are now reconstructed properly, not as booleans (#914)
77 * Various warnings are no longer erroneously suppressed in test files (files that include `catch.hpp`, but do not define `CATCH_CONFIG_MAIN` or `CATCH_CONFIG_RUNNER`) (#871)
78 * Catch no longer fails to link when main is compiled as C++, but linked against Objective-C (#855)
79 * Fixed incorrect gcc version detection when deciding to use `__COUNTER__` (#928)
80 * Previously any GCC with minor version less than 3 would be incorrectly classified as not supporting `__COUNTER__`.
81 * Suppressed C4996 warning caused by upcoming updated to MSVC 2017, marking `std::uncaught_exception` as deprecated. (#927)
84 * CMake integration script now incorporates debug messages and registers tests in an improved way (#911)
85 * Various documentation improvements
92 * `CATCH_FAIL` macro no longer causes compilation error without variadic macro support
93 * `INFO` messages are no longer cleared after being reported once
95 ### Improvements and minor changes
96 * Catch now uses `wmain` when compiled under Windows and `UNICODE` is defined.
97 * Note that Catch still officially supports only ASCII
102 * Completed the fix for (lack of) uint64_t in earlier Visual Studios
106 ### Improvements and minor changes
107 * All of `Approx`'s member functions now accept strong typedefs in C++11 mode (#888)
108 * Previously `Approx::scale`, `Approx::epsilon`, `Approx::margin` and `Approx::operator()` didn't.
112 * POSIX signals are now disabled by default under QNX (#889)
113 * QNX does not support current enough (2001) POSIX specification
114 * JUnit no longer counts exceptions as failures if given test case is marked as ok to fail.
115 * `Catch::Option` should now have its storage properly aligned.
116 * Catch no longer attempts to define `uint64_t` on windows (#862)
117 * This was causing trouble when compiled under Cygwin
120 * Catch is now compiled under MSVC 2017 using `std:c++latest` (C++17 mode) in CI
121 * We now provide cmake script that autoregisters Catch tests into ctest.
122 * See `contrib` folder.
128 * Unexpected exceptions are no longer ignored by default (#885, #887)
134 ### Improvements and minor changes
135 * Catch no longer attempts to ensure the exception type passed by user in `REQUIRE_THROWS_AS` is a constant reference.
136 * It was causing trouble when `REQUIRE_THROWS_AS` was used inside templated functions
137 * This actually reverts changes made in v1.7.2
138 * Catch's `Version` struct should no longer be double freed when multiple instances of Catch tests are loaded into single program (#858)
139 * It is now a static variable in an inline function instead of being an `extern`ed struct.
140 * Attempt to register invalid tag or tag alias now throws instead of calling `exit()`.
141 * Because this happen before entering main, it still aborts execution
142 * Further improvements to this are coming
143 * `CATCH_CONFIG_FAST_COMPILE` now speeds-up compilation of `REQUIRE*` assertions by further ~15%.
144 * The trade-off is disabling translation of unexpected exceptions into text.
145 * When Catch is compiled using C++11, `Approx` is now constructible with anything that can be explicitly converted to `double`.
146 * Captured messages are now printed on unexpected exceptions
149 * Clang's `-Wexit-time-destructors` should be suppressed for Catch's internals
150 * GCC's `-Wparentheses` is now suppressed for all TU's that include `catch.hpp`.
151 * This is functionally a revert of changes made in 1.8.0, where we tried using `_Pragma` based suppression. This should have kept the suppression local to Catch's assertions, but bugs in GCC's handling of `_Pragma`s in C++ mode meant that it did not always work.
152 * You can now tell Catch to use C++11-based check when checking whether a type can be streamed to output.
153 * This fixes cases when an unstreamable type has streamable private base (#877)
154 * [Details can be found in documentation](configuration.md#catch_config_cpp11_stream_insertable_check)
158 * We have added VS 2017 to our CI
159 * Work on Catch 2 should start soon
166 ### Improvements and minor changes
167 * TAP reporter now behaves as if `-s` was always set
168 * This should be more consistent with the protocol desired behaviour.
169 * Compact reporter now obeys `-d yes` argument (#780)
170 * The format is "XXX.123 s: <section-name>" (3 decimal places are always present).
171 * Before it did not report the durations at all.
172 * XML reporter now behaves the same way as Console reporter in regards to `INFO`
173 * This means it reports `INFO` messages on success, if output on success (`-s`) is enabled.
174 * Previously it only reported `INFO` messages on failure.
175 * `CAPTURE(expr)` now stringifies `expr` in the same way assertion macros do (#639)
176 * Listeners are now finally [documented](event-listeners.md).
177 * Listeners provide a way to hook into events generated by running your tests, including start and end of run, every test case, every section and every assertion.
181 * Catch no longer attempts to reconstruct expression that led to a fatal error (#810)
182 * This fixes possible signal/SEH loop when processing expressions, where the signal was triggered by expression decomposition.
183 * Fixed (C4265) missing virtual destructor warning in Matchers (#844)
184 * `std::string`s are now taken by `const&` everywhere (#842).
185 * Previously some places were taking them by-value.
186 * Catch should no longer change errno (#835).
187 * This was caused by libstdc++ bug that we now work around.
188 * Catch now provides `FAIL_CHECK( ... )` macro (#765).
189 * Same as `FAIL( ... )`, but does not abort the test.
190 * Functions like `fabs`, `tolower`, `memset`, `isalnum` are now used with `std::` qualification (#543).
191 * Clara no longer assumes first argument (binary name) is always present (#729)
192 * If it is missing, empty string is used as default.
193 * Clara no longer reads 1 character past argument string (#830)
194 * Regression in Objective-C bindings (Matchers) fixed (#854)
198 * We have added VS 2013 and 2015 to our CI
199 * Catch Classic (1.x.x) now contains its own, forked, version of Clara (the argument parser).
207 Cygwin issue with `gettimeofday` - `#define` was not early enough
211 ### New features/ minor changes
213 * Matchers have new, simpler (and documented) interface.
214 * Catch provides string and vector matchers.
215 * For details see [Matchers documentation](matchers.md).
216 * Changed console reporter test duration reporting format (#322)
217 * Old format: `Some simple comparisons between doubles completed in 0.000123s`
218 * New format: `xxx.123s: Some simple comparisons between doubles` _(There will always be exactly 3 decimal places)_
219 * Added opt-in leak detection under MSVC + Windows (#439)
220 * Enable it by compiling Catch's main with `CATCH_CONFIG_WINDOWS_CRTDBG`
221 * Introduced new compile-time flag, `CATCH_CONFIG_FAST_COMPILE`, trading features for compilation speed.
222 * Moves debug breaks out of tests and into implementation, speeding up test compilation time (~10% on linux).
223 * _More changes are coming_
224 * Added [TAP (Test Anything Protocol)](https://testanything.org/) and [Automake](https://www.gnu.org/software/automake/manual/html_node/Log-files-generation-and-test-results-recording.html#Log-files-generation-and-test-results-recording) reporters.
225 * These are not present in the default single-include header and need to be downloaded from GitHub separately.
226 * For details see [documentation about integrating with build systems](build-systems.md).
227 * XML reporter now reports filename as part of the `Section` and `TestCase` tags.
228 * `Approx` now supports an optional margin of absolute error
229 * It has also received [new documentation](assertions.md).
232 * Silenced C4312 ("conversion from int to 'ClassName *") warnings in the evaluate layer.
233 * Fixed C4512 ("assignment operator could not be generated") warnings under VS2013.
234 * Cygwin compatibility fixes
235 * Signal handling is no longer compiled by default.
236 * Usage of `gettimeofday` inside Catch should no longer cause compilation errors.
237 * Improved `-Wparentheses` supression for gcc (#674)
238 * When compiled with gcc 4.8 or newer, the supression is localized to assertions only
239 * Otherwise it is supressed for the whole TU
240 * Fixed test spec parser issue (with escapes in multiple names)
243 * Various documentation fixes and improvements
248 ### Fixes and minor improvements
251 (technically the first two are breaking changes but are also fixes and arguably break few if any people)
252 * C-escape control characters instead of XML encoding them (which requires XML 1.1)
253 * Revert XML output to XML 1.0
254 * Can provide stylesheet references by extending the XML reporter
255 * Added description and tags attribites to XML Reporter
256 * Tags are closed and the stream flushed more eagerly to avoid stdout interpolation
260 * `REQUIRE_THROWS_AS` now catches exception by `const&` and reports expected type
261 * In `SECTION`s the file/ line is now of the `SECTION`. not the `TEST_CASE`
262 * Added std:: qualification to some functions from C stdlib
263 * Removed use of RTTI (`dynamic_cast`) that had crept back in
264 * Silenced a few more warnings in different circumstances
265 * Travis improvements
270 * Fixed inconsistency in defining `NOMINMAX` and `WIN32_LEAN_AND_MEAN` inside `catch.hpp`.
271 * Fixed SEH-related compilation error under older MinGW compilers, by making Windows SEH handling opt-in for compilers other than MSVC.
272 * For specifics, look into the [documentation](configuration.md).
273 * Fixed compilation error under MinGW caused by improper compiler detection.
274 * Fixed XML reporter sometimes leaving an empty output file when a test ends with signal/structured exception.
275 * Fixed XML reporter not reporting captured stdout/stderr.
276 * Fixed possible infinite recursion in Windows SEH.
277 * Fixed possible compilation error caused by Catch's operator overloads being ambiguous in regards to user-defined templated operators.
281 ### Features/ Changes:
282 * Catch now runs significantly faster for passing tests
283 * Microbenchmark focused on Catch's overhead went from ~3.4s to ~0.7s.
284 * Real world test using [JSON for Modern C++](https://github.com/nlohmann/json)'s test suite went from ~6m 25s to ~4m 14s.
285 * Catch can now run specific sections within test cases.
286 * For now the support is only basic (no wildcards or tags), for details see the [documentation](command-line.md).
287 * Catch now supports SEH on Windows as well as signals on Linux.
288 * After receiving a signal, Catch reports failing assertion and then passes the signal onto the previous handler.
289 * Approx can be used to compare values against strong typedefs (available in C++11 mode only).
290 * Strong typedefs mean types that are explicitly convertible to double.
291 * CHECK macro no longer stops executing section if an exception happens.
292 * Certain characters (space, tab, etc) are now pretty printed.
293 * This means that a `char c = ' '; REQUIRE(c == '\t');` would be printed as `' ' == '\t'`, instead of ` == 9`.
296 * Text formatting no longer attempts to access out-of-bounds characters under certain conditions.
297 * THROW family of assertions no longer trigger `-Wunused-value` on expressions containing explicit cast.
298 * Breaking into debugger under OS X works again and no longer required `DEBUG` to be defined.
299 * Compilation no longer breaks under certain compiler if a lambda is used inside assertion macro.
302 * Catch's CMakeLists now defines install command.
303 * Catch's CMakeLists now generates projects with warnings enabled.
308 ### Features/ Changes:
309 * Catch now supports breaking into debugger on Linux
312 * Generators no longer leak memory (generators are still unsupported in general)
313 * JUnit reporter now reports UTC timestamps, instead of "tbd"
314 * `CHECK_THAT` macro is now properly defined as `CATCH_CHECK_THAT` when using `CATCH_` prefixed macros
317 * Types with overloaded `&&` operator are no longer evaluated twice when used in an assertion macro.
318 * The use of `__COUNTER__` is supressed when Catch is parsed by CLion
319 * This change is not active when compiling a binary
320 * Approval tests can now be run on Windows
321 * CMake will now warn if a file is present in the `include` folder but not is not enumerated as part of the project
322 * Catch now defines `NOMINMAX` and `WIN32_LEAN_AND_MEAN` before including `windows.h`
323 * This can be disabled if needed, see [documentation](configuration.md) for details.
329 * Moved CMakeLists.txt to root, made it friendlier for CLion and generating XCode and VS projects, and removed the manually maintained XCode and VS projects.
331 ### Features/ Changes:
332 * Approx now supports `>=` and `<=`
333 * Can now use `\` to escape chars in test names on command line
334 * Standardize C++11 feature toggles
338 * Missing argument to `CATCH_CHECK_THROWS`
339 * Don't encode extended ASCII in XML
340 * use `std::shuffle` on more compilers (fixes deprecation warning/error)
341 * Use `__COUNTER__` more consistently (where available)
344 * Tweaks and changes to scripts - particularly for Approval test - to make them more portable
348 Release notes were not maintained prior to v1.6.0, but you should be able to work them out from the Git history