Skip to content

Commit eb3a3ee

Browse files
committed
v.8.0.0 release
1 parent b188195 commit eb3a3ee

File tree

7 files changed

+61
-46
lines changed

7 files changed

+61
-46
lines changed

README.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ To change this file edit the source file and then execute ./run_markdown_templat
1111

1212
[![Build Status](https://api.travis-ci.org/approvals/ApprovalTests.cpp.svg?branch=master)](https://travis-ci.org/approvals/ApprovalTests.cpp) [![Build status](https://ci.appveyor.com/api/projects/status/lf3i76ije89oihi5?svg=true)](https://ci.appveyor.com/project/isidore/approvaltests-cpp) [![Actions Status](https://github.com/approvals/ApprovalTests.cpp/workflows/build/badge.svg)](https://github.com/approvals/ApprovalTests.cpp/actions) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](/CODE_OF_CONDUCT.md#top)
1313

14-
<a href="https://github.com/approvals/ApprovalTests.cpp/releases/download/v.7.0.0/ApprovalTests.v.7.0.0.hpp">Download the latest version (v.7.0.0) of the **single header file** here.</a>
14+
<a href="https://github.com/approvals/ApprovalTests.cpp/releases/download/v.8.0.0/ApprovalTests.v.8.0.0.hpp">Download the latest version (v.8.0.0) of the **single header file** here.</a>
1515

1616
<!-- toc -->
1717
## Contents

build/relnotes_8.0.0.md

+48
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
See the [v.8.0.0 milestone](https://github.com/approvals/ApprovalTests.cpp/milestone/4?closed=1) for the full list of changes.
2+
3+
* **Breaking changes**
4+
* We have fully standardised the way that Approval Tests looks for 3rd-party headers, so users should no longer need to modify their search paths for include directories. This means that:
5+
* If you are using Catch (#62), and you get build failures, you'll need to change your `#include` lines like this:
6+
```diff
7+
-#include <catch.hpp>
8+
+#include <catch2/catch.hpp>
9+
```
10+
* If you are using doctest (#68), and you get build failures, you'll need to change your `#include` lines like this:
11+
```diff
12+
-#include <doctest.h>
13+
+#include <doctest/doctest.h>
14+
```
15+
* If you are using \[Boost\].UT (#65), and you get build failures, you'll need to change your `#include` lines like this:
16+
```diff
17+
-#include <ut.hpp>
18+
+#include <boost/ut.hpp>
19+
```
20+
* In order for this to work with our third_party directory, our copies of these header files are now in:
21+
* `third_party/catch2/include/catch2/`
22+
* `third_party/doctest/include/doctest`
23+
* `third_party/ut/include/boost`
24+
* Catch1 is no longer supported as a test framework, in order to better support more CMake build layouts. (#64)
25+
* Catch2 remains fully supported.
26+
* Catch1's main benefit was that it supported pre-C++11 compilers, but as ApprovalTests.cpp requires C++11 or newer, this wasn't useful in practice
27+
* **New features**
28+
* Greatly improved and documented [CMake Integration](/doc/CMakeIntegration.md#top) (#69):
29+
* Approval Tests can now be added to other projects with any of CMake's `add_subdirectory()`, `FetchContent` and `ExternalProject`. (#62, #65, #68, #75, #70, #88, #89)
30+
* Created wrapper [ApprovalTests.hpp](https://github.com/approvals/ApprovalTests.cpp/blob/master/ApprovalTests/ApprovalTests.hpp)
31+
so that code can work interchangeably with the single header and via CMake integration (#89)
32+
* Made CMake targets for targets in third_party consistent with those of the original projects, adding `Catch2::Catch2`, `doctest::doctest` and `boost.ut` (#70)
33+
* Created a namespaced CMake target for ApprovalTests `ApprovalTests::ApprovalTests` (#75)
34+
* Don't create third_party targets if they have been created already (#88)
35+
* **Bug fixes**
36+
* Significant effort to improve behaviour with the Ninja build tool:
37+
* Understood, work-around and documented issues with the Ninja generator. See [Troubleshooting Misconfigured Build](/doc/TroubleshootingMisconfiguredBuild.md#top) if you have test failures in your Ninja builds. (#74 - thanks @jwillikers)
38+
* Added compile-time checks for GoogleTest, Catch2 and doctest, to detect problems with `__FILE__` macro caused by the Ninja generator on all platforms (#79 - thanks @jwillikers).
39+
* Added option to disable the `__FILE__` compile-time check (#86)
40+
* Project now works with [Unity builds](http://onqtam.com/programming/2018-07-07-unity-builds/) (#86)
41+
* **Other changes**
42+
* Updated \[Boost\].UT integration to work with [a change](https://github.com/boost-experimental/ut/commit/94220e8c95b323349bfd94ef30b2568916fb1421#diff-04c6e90faac2675aa89e2176d2eec7d8) made for the v1.1.5 release of that library. (#66 - thanks @krzysztof-jusiak)
43+
* Code now formatted with clang-format (#39 - thanks @dheater and @alastairUK)
44+
* See [Formatting Code](/doc/Contributing.md#formatting-code) to configure your editor to use the [.clang-format](https://github.com/approvals/ApprovalTests.cpp/blob/master/.clang-format) file automatically.
45+
* Added CI build for clang-cl (#30 - thanks @alastairUK))
46+
* Added [CI builds for mingw/MSYS and CygWin](https://ci.appveyor.com/project/isidore/approvaltests-cpp/history) (#79)
47+
* Added CI builds for Ninja generator (#74)
48+
* The help text for problem misconfigured `main()` functions now links straight to the [relevant help page](https://github.com/approvals/ApprovalTests.cpp/blob/master/doc/TroubleshootingMisconfiguredMain.md#top). (#84)

build/relnotes_x.y.z.md

+5-43
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,10 @@
1-
See the [v.x.y.z milestone](https://github.com/approvals/ApprovalTests.cpp/milestone/4?closed=1) for the full list of changes.
1+
<!-- See the [v.x.y.z milestone](https://github.com/approvals/ApprovalTests.cpp/milestone/__MILESTONE_NUMBER__?closed=1) for the full list of changes. -->
22

33
* **Breaking changes**
4-
* We have fully standardised the way that Approval Tests looks for 3rd-party headers, so users should no longer need to modify their search paths for include directories. This means that:
5-
* If you are using Catch (#62), and you get build failures, you'll need to change your `#include` lines like this:
6-
```diff
7-
-#include <catch.hpp>
8-
+#include <catch2/catch.hpp>
9-
```
10-
* If you are using doctest (#68), and you get build failures, you'll need to change your `#include` lines like this:
11-
```diff
12-
-#include <doctest.h>
13-
+#include <doctest/doctest.h>
14-
```
15-
* If you are using \[Boost\].UT (#65), and you get build failures, you'll need to change your `#include` lines like this:
16-
```diff
17-
-#include <ut.hpp>
18-
+#include <boost/ut.hpp>
19-
```
20-
* In order for this to work with our third_party directory, our copies of these header files are now in:
21-
* `third_party/catch2/include/catch2/`
22-
* `third_party/doctest/include/doctest`
23-
* `third_party/ut/include/boost`
24-
* Catch1 is no longer supported as a test framework, in order to better support more CMake build layouts. (#64)
25-
* Catch2 remains fully supported.
26-
* Catch1's main benefit was that it supported pre-C++11 compilers, but as ApprovalTests.cpp requires C++11 or newer, this wasn't useful in practice
4+
* None
275
* **New features**
28-
* Greatly improved and documented [CMake Integration](/doc/CMakeIntegration.md#top) (#69):
29-
* Approval Tests can now be added to other projects with any of CMake's `add_subdirectory()`, `FetchContent` and `ExternalProject`. (#62, #65, #68, #75, #70, #88, #89)
30-
* Created wrapper [ApprovalTests.hpp](https://github.com/approvals/ApprovalTests.cpp/blob/master/ApprovalTests/ApprovalTests.hpp)
31-
so that code can work interchangeably with the single header and via CMake integration (#89)
32-
* Made CMake targets for targets in third_party consistent with those of the original projects, adding `Catch2::Catch2`, `doctest::doctest` and `boost.ut` (#70)
33-
* Created a namespaced CMake target for ApprovalTests `ApprovalTests::ApprovalTests` (#75)
34-
* Don't create third_party targets if they have been created already (#88)
6+
* None
357
* **Bug fixes**
36-
* Significant effort to improve behaviour with the Ninja build tool:
37-
* Understood, work-around and documented issues with the Ninja generator. See [Troubleshooting Misconfigured Build](/doc/TroubleshootingMisconfiguredBuild.md#top) if you have test failures in your Ninja builds. (#74 - thanks @jwillikers)
38-
* Added compile-time checks for GoogleTest, Catch2 and doctest, to detect problems with `__FILE__` macro caused by the Ninja generator on all platforms (#79 - thanks @jwillikers).
39-
* Added option to disable the `__FILE__` compile-time check (#86)
40-
* Project now works with [Unity builds](http://onqtam.com/programming/2018-07-07-unity-builds/) (#86)
8+
* None
419
* **Other changes**
42-
* Updated \[Boost\].UT integration to work with [a change](https://github.com/boost-experimental/ut/commit/94220e8c95b323349bfd94ef30b2568916fb1421#diff-04c6e90faac2675aa89e2176d2eec7d8) made for the v1.1.5 release of that library. (#66 - thanks @krzysztof-jusiak)
43-
* Code now formatted with clang-format (#39 - thanks @dheater and @alastairUK)
44-
* See [Formatting Code](/doc/Contributing.md#formatting-code) to configure your editor to use the [.clang-format](https://github.com/approvals/ApprovalTests.cpp/blob/master/.clang-format) file automatically.
45-
* Added CI build for clang-cl (#30 - thanks @alastairUK))
46-
* Added [CI builds for mingw/MSYS and CygWin](https://ci.appveyor.com/project/isidore/approvaltests-cpp/history) (#79)
47-
* Added CI builds for Ninja generator (#74)
48-
* The help text for problem misconfigured `main()` functions now links straight to the [relevant help page](https://github.com/approvals/ApprovalTests.cpp/blob/master/doc/TroubleshootingMisconfiguredMain.md#top). (#84)
10+
* None

build/version.ini

+1-1
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
[VERSION]
2-
major = 7
2+
major = 8
33
minor = 0
44
patch = 0
55

doc/Features.md

+3
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,7 @@ To change this file edit the source file and then execute ./run_markdown_templat
1515
## Contents
1616

1717
* [v.x.y.z](#vxyz)
18+
* [v.8.0.0](#v800)
1819
* [CMake Integration documented](#cmake-integration-documented)
1920
* [Use with Ninja generator documented](#use-with-ninja-generator-documented)
2021
* [v.7.0.0](#v700)
@@ -40,6 +41,8 @@ To change this file edit the source file and then execute ./run_markdown_templat
4041

4142
## v.x.y.z
4243

44+
## v.8.0.0
45+
4346
### CMake Integration documented
4447

4548
See [CMake Integration](/doc/CMakeIntegration.md#top).

doc/mdsource/Features.source.md

+2
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,8 @@ toc
88

99
## v.x.y.z
1010

11+
## v.8.0.0
12+
1113
### CMake Integration documented
1214

1315
See [CMake Integration](/doc/CMakeIntegration.md#top).

mdsource/README.source.md

+1-1
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@
44

55
[![Build Status](https://api.travis-ci.org/approvals/ApprovalTests.cpp.svg?branch=master)](https://travis-ci.org/approvals/ApprovalTests.cpp) [![Build status](https://ci.appveyor.com/api/projects/status/lf3i76ije89oihi5?svg=true)](https://ci.appveyor.com/project/isidore/approvaltests-cpp) [![Actions Status](https://github.com/approvals/ApprovalTests.cpp/workflows/build/badge.svg)](https://github.com/approvals/ApprovalTests.cpp/actions) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-v1.4%20adopted-ff69b4.svg)](/CODE_OF_CONDUCT.md#top)
66

7-
<a href="https://github.com/approvals/ApprovalTests.cpp/releases/download/v.7.0.0/ApprovalTests.v.7.0.0.hpp">Download the latest version (v.7.0.0) of the **single header file** here.</a>
7+
<a href="https://github.com/approvals/ApprovalTests.cpp/releases/download/v.8.0.0/ApprovalTests.v.8.0.0.hpp">Download the latest version (v.8.0.0) of the **single header file** here.</a>
88

99
toc
1010

0 commit comments

Comments
 (0)