mirror of
https://github.com/catchorg/Catch2.git
synced 2024-11-21 21:06:11 +01:00
Trim superfluous whitespace in docs
This commit is contained in:
parent
a07ac3f935
commit
6a422bae0b
@ -31,7 +31,7 @@ Once you're up and running consider the following reference material.
|
|||||||
* [CMake integration](cmake-integration.md#top)
|
* [CMake integration](cmake-integration.md#top)
|
||||||
* [CI and other miscellaneous pieces](ci-and-misc.md#top)
|
* [CI and other miscellaneous pieces](ci-and-misc.md#top)
|
||||||
* [Known limitations](limitations.md#top)
|
* [Known limitations](limitations.md#top)
|
||||||
|
|
||||||
**Other:**
|
**Other:**
|
||||||
* [Why Catch2?](why-catch.md#top)
|
* [Why Catch2?](why-catch.md#top)
|
||||||
* [Migrating from v2 to v3](migrate-v2-to-v3.md#top)
|
* [Migrating from v2 to v3](migrate-v2-to-v3.md#top)
|
||||||
|
@ -19,7 +19,7 @@ Most of these macros come in two forms:
|
|||||||
The ```REQUIRE``` family of macros tests an expression and aborts the test case if it fails.
|
The ```REQUIRE``` family of macros tests an expression and aborts the test case if it fails.
|
||||||
The ```CHECK``` family are equivalent but execution continues in the same test case even if the assertion fails. This is useful if you have a series of essentially orthogonal assertions and it is useful to see all the results rather than stopping at the first failure.
|
The ```CHECK``` family are equivalent but execution continues in the same test case even if the assertion fails. This is useful if you have a series of essentially orthogonal assertions and it is useful to see all the results rather than stopping at the first failure.
|
||||||
|
|
||||||
* **REQUIRE(** _expression_ **)** and
|
* **REQUIRE(** _expression_ **)** and
|
||||||
* **CHECK(** _expression_ **)**
|
* **CHECK(** _expression_ **)**
|
||||||
|
|
||||||
Evaluates the expression and records the result. If an exception is thrown, it is caught, reported, and counted as a failure. These are the macros you will use most of the time.
|
Evaluates the expression and records the result. If an exception is thrown, it is caught, reported, and counted as a failure. These are the macros you will use most of the time.
|
||||||
@ -77,22 +77,22 @@ documentation page](comparing-floating-point-numbers.md#top).
|
|||||||
|
|
||||||
## Exceptions
|
## Exceptions
|
||||||
|
|
||||||
* **REQUIRE_NOTHROW(** _expression_ **)** and
|
* **REQUIRE_NOTHROW(** _expression_ **)** and
|
||||||
* **CHECK_NOTHROW(** _expression_ **)**
|
* **CHECK_NOTHROW(** _expression_ **)**
|
||||||
|
|
||||||
Expects that no exception is thrown during evaluation of the expression.
|
Expects that no exception is thrown during evaluation of the expression.
|
||||||
|
|
||||||
* **REQUIRE_THROWS(** _expression_ **)** and
|
* **REQUIRE_THROWS(** _expression_ **)** and
|
||||||
* **CHECK_THROWS(** _expression_ **)**
|
* **CHECK_THROWS(** _expression_ **)**
|
||||||
|
|
||||||
Expects that an exception (of any type) is be thrown during evaluation of the expression.
|
Expects that an exception (of any type) is be thrown during evaluation of the expression.
|
||||||
|
|
||||||
* **REQUIRE_THROWS_AS(** _expression_, _exception type_ **)** and
|
* **REQUIRE_THROWS_AS(** _expression_, _exception type_ **)** and
|
||||||
* **CHECK_THROWS_AS(** _expression_, _exception type_ **)**
|
* **CHECK_THROWS_AS(** _expression_, _exception type_ **)**
|
||||||
|
|
||||||
Expects that an exception of the _specified type_ is thrown during evaluation of the expression. Note that the _exception type_ is extended with `const&` and you should not include it yourself.
|
Expects that an exception of the _specified type_ is thrown during evaluation of the expression. Note that the _exception type_ is extended with `const&` and you should not include it yourself.
|
||||||
|
|
||||||
* **REQUIRE_THROWS_WITH(** _expression_, _string or string matcher_ **)** and
|
* **REQUIRE_THROWS_WITH(** _expression_, _string or string matcher_ **)** and
|
||||||
* **CHECK_THROWS_WITH(** _expression_, _string or string matcher_ **)**
|
* **CHECK_THROWS_WITH(** _expression_, _string or string matcher_ **)**
|
||||||
|
|
||||||
Expects that an exception is thrown that, when converted to a string, matches the _string_ or _string matcher_ provided (see next section for Matchers).
|
Expects that an exception is thrown that, when converted to a string, matches the _string_ or _string matcher_ provided (see next section for Matchers).
|
||||||
@ -128,8 +128,8 @@ REQUIRE_NOTHROW([&](){
|
|||||||
|
|
||||||
To support Matchers a slightly different form is used. Matchers have [their own documentation](matchers.md#top).
|
To support Matchers a slightly different form is used. Matchers have [their own documentation](matchers.md#top).
|
||||||
|
|
||||||
* **REQUIRE_THAT(** _lhs_, _matcher expression_ **)** and
|
* **REQUIRE_THAT(** _lhs_, _matcher expression_ **)** and
|
||||||
* **CHECK_THAT(** _lhs_, _matcher expression_ **)**
|
* **CHECK_THAT(** _lhs_, _matcher expression_ **)**
|
||||||
|
|
||||||
Matchers can be composed using `&&`, `||` and `!` operators.
|
Matchers can be composed using `&&`, `||` and `!` operators.
|
||||||
|
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
<a id="top"></a>
|
<a id="top"></a>
|
||||||
# CI and other odd pieces
|
# CI and other odd pieces
|
||||||
|
|
||||||
This page talks about how Catch integrates with Continuous Integration
|
This page talks about how Catch integrates with Continuous Integration
|
||||||
Build Systems may refer to low-level tools, like CMake, or larger systems that run on servers, like Jenkins or TeamCity. This page will talk about both.
|
Build Systems may refer to low-level tools, like CMake, or larger systems that run on servers, like Jenkins or TeamCity. This page will talk about both.
|
||||||
|
|
||||||
## Continuous Integration systems
|
## Continuous Integration systems
|
||||||
@ -11,9 +11,9 @@ Probably the most important aspect to using Catch with a build server is the use
|
|||||||
Two of these reporters are built in (XML and JUnit) and the third (TeamCity) is included as a separate header. It's possible that the other two may be split out in the future too - as that would make the core of Catch smaller for those that don't need them.
|
Two of these reporters are built in (XML and JUnit) and the third (TeamCity) is included as a separate header. It's possible that the other two may be split out in the future too - as that would make the core of Catch smaller for those that don't need them.
|
||||||
|
|
||||||
### XML Reporter
|
### XML Reporter
|
||||||
```-r xml```
|
```-r xml```
|
||||||
|
|
||||||
The XML Reporter writes in an XML format that is specific to Catch.
|
The XML Reporter writes in an XML format that is specific to Catch.
|
||||||
|
|
||||||
The advantage of this format is that it corresponds well to the way Catch works (especially the more unusual features, such as nested sections) and is a fully streaming format - that is it writes output as it goes, without having to store up all its results before it can start writing.
|
The advantage of this format is that it corresponds well to the way Catch works (especially the more unusual features, such as nested sections) and is a fully streaming format - that is it writes output as it goes, without having to store up all its results before it can start writing.
|
||||||
|
|
||||||
|
@ -6,7 +6,7 @@ some of them that are willing to share this information.
|
|||||||
|
|
||||||
If you want to add your organisation, please check that there is no issue
|
If you want to add your organisation, please check that there is no issue
|
||||||
with you sharing this fact.
|
with you sharing this fact.
|
||||||
|
|
||||||
- Bloomberg
|
- Bloomberg
|
||||||
- [Bloomlife](https://bloomlife.com)
|
- [Bloomlife](https://bloomlife.com)
|
||||||
- [Inscopix Inc.](https://www.inscopix.com/)
|
- [Inscopix Inc.](https://www.inscopix.com/)
|
||||||
@ -16,7 +16,7 @@ with you sharing this fact.
|
|||||||
- [Nexus Software Systems](https://nexwebsites.com)
|
- [Nexus Software Systems](https://nexwebsites.com)
|
||||||
- [UX3D](https://ux3d.io)
|
- [UX3D](https://ux3d.io)
|
||||||
- [King](https://king.com)
|
- [King](https://king.com)
|
||||||
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
@ -98,7 +98,7 @@ is equivalent with the out-of-the-box experience.
|
|||||||
|
|
||||||
|
|
||||||
## Bazel support
|
## Bazel support
|
||||||
When `CATCH_CONFIG_BAZEL_SUPPORT` is defined or when `BAZEL_TEST=1` (which is set by the Bazel inside of a test environment),
|
When `CATCH_CONFIG_BAZEL_SUPPORT` is defined or when `BAZEL_TEST=1` (which is set by the Bazel inside of a test environment),
|
||||||
Catch2 will register a `JUnit` reporter writing to a path pointed by `XML_OUTPUT_FILE` provided by Bazel.
|
Catch2 will register a `JUnit` reporter writing to a path pointed by `XML_OUTPUT_FILE` provided by Bazel.
|
||||||
|
|
||||||
> `CATCH_CONFIG_BAZEL_SUPPORT` was [introduced](https://github.com/catchorg/Catch2/pull/2399) in Catch2 3.0.1.
|
> `CATCH_CONFIG_BAZEL_SUPPORT` was [introduced](https://github.com/catchorg/Catch2/pull/2399) in Catch2 3.0.1.
|
||||||
|
@ -125,7 +125,7 @@ information that you will need for updating Catch2's documentation, and
|
|||||||
possibly some generic advise as well.
|
possibly some generic advise as well.
|
||||||
|
|
||||||
|
|
||||||
### Technicalities
|
### Technicalities
|
||||||
|
|
||||||
First, the technicalities:
|
First, the technicalities:
|
||||||
|
|
||||||
|
@ -33,7 +33,7 @@ public:
|
|||||||
CATCH_REGISTER_LISTENER(testRunListener)
|
CATCH_REGISTER_LISTENER(testRunListener)
|
||||||
```
|
```
|
||||||
|
|
||||||
_Note that you should not use any assertion macros within a Listener!_
|
_Note that you should not use any assertion macros within a Listener!_
|
||||||
|
|
||||||
[You can find the list of events that the listeners can react to on its
|
[You can find the list of events that the listeners can react to on its
|
||||||
own page](reporter-events.md#top).
|
own page](reporter-events.md#top).
|
||||||
|
@ -241,12 +241,12 @@ in which case a range is accepted if any of its elements is accepted
|
|||||||
by the provided matcher.
|
by the provided matcher.
|
||||||
|
|
||||||
`AllMatch`, `NoneMatch`, and `AnyMatch` match ranges for which either
|
`AllMatch`, `NoneMatch`, and `AnyMatch` match ranges for which either
|
||||||
all, none, or any of the contained elements matches the given matcher,
|
all, none, or any of the contained elements matches the given matcher,
|
||||||
respectively.
|
respectively.
|
||||||
|
|
||||||
`AllTrue`, `NoneTrue`, and `AnyTrue` match ranges for which either
|
`AllTrue`, `NoneTrue`, and `AnyTrue` match ranges for which either
|
||||||
all, none, or any of the contained elements are `true`, respectively.
|
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`.
|
||||||
|
|
||||||
## Writing custom matchers (old style)
|
## Writing custom matchers (old style)
|
||||||
|
@ -72,7 +72,7 @@ A header-only template engine for modern C++.
|
|||||||
A C++17 template header-only library for the abstraction of memory access patterns.
|
A C++17 template header-only library for the abstraction of memory access patterns.
|
||||||
|
|
||||||
### [libcluon](https://github.com/chrberger/libcluon)
|
### [libcluon](https://github.com/chrberger/libcluon)
|
||||||
A single-header-only library written in C++14 to glue distributed software components (UDP, TCP, shared memory) supporting natively Protobuf, LCM/ZCM, MsgPack, and JSON for dynamic message transformations in-between.
|
A single-header-only library written in C++14 to glue distributed software components (UDP, TCP, shared memory) supporting natively Protobuf, LCM/ZCM, MsgPack, and JSON for dynamic message transformations in-between.
|
||||||
|
|
||||||
### [MNMLSTC Core](https://github.com/mnmlstc/core)
|
### [MNMLSTC Core](https://github.com/mnmlstc/core)
|
||||||
A small and easy to use C++11 library that adds a functionality set that will be available in C++14 and later, as well as some useful additions.
|
A small and easy to use C++11 library that adds a functionality set that will be available in C++14 and later, as well as some useful additions.
|
||||||
|
@ -138,7 +138,7 @@ benchmarking itself fails.
|
|||||||
> Introduced in Catch2 3.0.1.
|
> Introduced in Catch2 3.0.1.
|
||||||
|
|
||||||
Listings events are events that correspond to the test binary being
|
Listings events are events that correspond to the test binary being
|
||||||
invoked with `--list-foo` flag.
|
invoked with `--list-foo` flag.
|
||||||
|
|
||||||
There are currently 3 listing events, one for reporters, one for tests,
|
There are currently 3 listing events, one for reporters, one for tests,
|
||||||
and one for tags. Note that they are not exclusive to each other.
|
and one for tags. Note that they are not exclusive to each other.
|
||||||
|
@ -130,9 +130,9 @@ struct Template_Foo_2 {
|
|||||||
};
|
};
|
||||||
|
|
||||||
TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG(
|
TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG(
|
||||||
Template_Fixture_2,
|
Template_Fixture_2,
|
||||||
"A TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG based test run that succeeds",
|
"A TEMPLATE_PRODUCT_TEST_CASE_METHOD_SIG based test run that succeeds",
|
||||||
"[class][template][product][nttp]",
|
"[class][template][product][nttp]",
|
||||||
((typename T, size_t S), T, S),
|
((typename T, size_t S), T, S),
|
||||||
(std::array, Template_Foo_2),
|
(std::array, Template_Foo_2),
|
||||||
((int,2), (float,6))) {
|
((int,2), (float,6))) {
|
||||||
|
@ -100,7 +100,7 @@ before we move on.
|
|||||||
It accepts a boolean expression, and uses expression templates to
|
It accepts a boolean expression, and uses expression templates to
|
||||||
internally decompose it, so that it can be individually stringified
|
internally decompose it, so that it can be individually stringified
|
||||||
on test failure.
|
on test failure.
|
||||||
|
|
||||||
On the last point, note that there are more testing macros available,
|
On the last point, note that there are more testing macros available,
|
||||||
because not all useful checks can be expressed as a simple boolean
|
because not all useful checks can be expressed as a simple boolean
|
||||||
expression. As an example, checking that an expression throws an exception
|
expression. As an example, checking that an expression throws an exception
|
||||||
@ -178,7 +178,7 @@ To continue on the vector example above, you could add a check that
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
Another way to look at sections is that they are a way to define a tree
|
Another way to look at sections is that they are a way to define a tree
|
||||||
of paths through the test. Each section represents a node, and the final
|
of paths through the test. Each section represents a node, and the final
|
||||||
tree is walked in depth-first manner, with each path only visiting only
|
tree is walked in depth-first manner, with each path only visiting only
|
||||||
one leaf node.
|
one leaf node.
|
||||||
|
Loading…
Reference in New Issue
Block a user