版权声明:本文参照了《doctest项目的README》。未经作者允许,严禁用于商业出版,否则追究法律责任。网络转载请注明出处,这是对原创者的起码的尊重!!!
https://github.com/onqtam/doctest
master branch | Linux/OSX | Windows | ||
dev branch | Linux/OSX | Windows |
doctest用于单元测试和TDD的功能最丰富的C98 / C11单个头文件测试框架。
doctest是一个新的C++测试框架,但与其他功能丰富的替代方法相比,它在编译时间(按数量级)和运行时间上都是最快的。通过提供一个快速,透明和灵活的测试器和一个干净的接口,它使D / Rust / Nim 等编译语言能够直接在生产代码中进行测试。
该框架是和将保持自由,但需要你的支持,以维持其发展。有很多新功能特性和维护要做。如果您使用doctest为公司工作,或者有办法这样做,请考虑财务支持。每月通过Patreon捐款和通过PayPal的一次性捐款。
一个编译为可执行文件的自注册测试的完整示例如下所示:
有很多C++测试框架,如Catch,Boost.Test,UnitTest,cpputest,googletest以及其它一些。
doctest和其他测试框架之间的主要区别在于它很轻而且没有侵入性:
- 就包括头文件和编写数千个断言方面,编译时间都非常短。
- 即使在MSVC / GCC /Clang的最严格的警告级别也不会产生任何警告。
- 提供了一种使用DOCTEST_CONFIG_DISABLE标识符从二进制文件中删除所有与测试相关的代码的方法。
- 不污染全局命名空间(一切都在命名空间doctest),并不拖动任何标题。
- 完全兼容C++98——每次提交之前,都在CI上通过超过300个案例(静态分析,杀毒)
这允许框架有比其他测试工具更多的使用方式 - 测试可以直接写在生产代码中!
Mantra说:测试可以被认为是一种文档形式,应该能够靠近他们测试的产品代码。
- 这使得写测试的障碍非常低。
- 你不必制作一个单独的源文件。
- 不用包括一堆东西在里面。
- 不用将其添加到构建系统。
- 不用将其添加到源代码管理 。
- 您可以在其源代码文件的底部,甚至头文件中编写一个类或一个功能的测试!
- 生产代码中的测试可以被认为是文档或最新的评论 - 显示如何使用API。
- 不通过公共API和头文件暴露测试内部细节,不再是一个令人费解的问题。
- 测试驱动开发从未如此简单。
如果您不想/需要混合生产代码和测试,可以像使用其他框架一样使用该框架——查看该功能。
doctest是在Catch之后建模,代码的某些部分已经被直接使用 ——请检查它们之间的差异。
这个表比较doctest / catch / lest,非常相似。
查看YouTube上的CppCon 2017演讲 ,以更好地了解框架的工作原理,并阅读ACCU Overload 2017二月版文章)中的使用方法!
doctest从一开始就被设计为尽可能轻量级和透明。这些主要特点应该保留下来。
DOCTEST_CONFIG_DISABLE
标识符可以从二进制执行文件中删除与测试相关的所有内容。-Weverything -pedantic
-Wall -Wextra -pedantic
和 超过35个 其他警告,这些标志不覆盖GCC!——参考这里。/W4
(/Wall太多了—— 如果使用该选项,甚至微软自己的头文件都会产生数千个警告)DOCTEST_CONFIG_DISABLE
。DOCTEST_CONFIG_NO_EXCEPTIONS
。DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
标识符,可以提供main()。doctest::isRunningInTest()
。 该框架是和将保持自由,但需要你的支持,以维持其发展。有很多新功能特性和维护要做。如果您使用doctest为公司工作,或者有办法这样做,请考虑财务支持。每月通过Patreon捐款和通过PayPal的一次性捐款。
未来版本的计划功能——不断改变……
要开始使用doctest,您只需要下载其最新版本,并将其包含在源文件中(或者将此版本库作为git子模块添加)——doctest仅仅为一个头文件。
本教程假定您可以直接使用头文件:#include"doctest.h"
,它与测试源文件在同一个文件夹中,或者您已经在构建系统中正确设置了包含路径。
驱动测试开发TDD不是本教程的讨论范围。
假设你要测试一个函数factorial:
int factorial(int number)
{
return number <= 1 ? number : factorial(number - 1) * number;
}
使用doctest提供的默认main函数的测试程序如下所示:
#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
#include "doctest.h"
int factorial(int number)
{
return number <= 1 ? number : factorial(number - 1) * number;
}
TEST_CASE("testing the factorial function") {
CHECK(factorial(1) == 1);
CHECK(factorial(2) == 2);
CHECK(factorial(3) == 6);
CHECK(factorial(10) == 3628800);
}
这将编译成一个完整的可以响应命令行参数的可执行文件。如果没有任何命令行参数,它将执行所有的测试用例(在这个测试中 只有一个测试用例),报告每一个失败,生成关于有多少测试通过和失败的摘要。成功返回0,如果有任何失败返回1(如果你指向知道测试是否通过,这会很有用)。
如果你运行这个测试它会完全通过。似乎一切都很好,对吗?但这里还有一个bug。我们没有测试factorial(0)== 1,让我们添加这个测试用例:
TEST_CASE("testing the factorial function")
{
CHECK(factorial(0) == 1);
CHECK(factorial(1) == 1);
CHECK(factorial(2) == 2);
CHECK(factorial(3) == 6);
CHECK(factorial(10) == 3628800);
}
再次编译运行,结果显示我们没有完全通过测试:
test.cpp(7) FAILED!
CHECK( factorial(0) == 1 )
with expansion:
CHECK( 0 == 1 )
注意CHECK( 0 == 1 )
:我们获得了factorial(0)的真正返回值0,在表达式中又使用了==
。这是我们意识到了问题所在,我们修改这个函数:
int factorial(int number) { return number > 1 ? factorial(number - 1) * number : 1; }
现在测试通过了。
当然还有更多的问题需要考虑。例如,当返回值超过int的范围时,我们会遇到问题。使用阶乘可以很快出现这样的结果,您可能需要为这些用例添加测试,并决定如何处理这。在这里就不做这些测试了。
虽然这是一个简单的测试,但是它足以展示如何使用doctest。
我们需要做的就是定义一个宏,然后引入一个头文件——这样我们就获得所需的一切,包括响应命令行参数的main函数。只能在一个源文件中定义宏,但可以在多个源文件中引入doctest.h。建议在一个专门的实现文件中#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
和#include "doctest.h"
。当然也可以自己提供main函数——参考提供自定义的主函数。
我们用TEST_CASE宏引入测试用例。它需要一个参数,该参数是 一个自由格式的测试名称(更多信息参见Test cases and subcases)。测试名称不必是唯一的,您可以通过指定通配的测试名称或标签来运行指定测试集。有关运行测试的更多信息,请参阅命令行文档。
测试名称只是一个字符串,可以为空。我们不必声明一个函数或方法,或者在任何地方明确注册测试用例。在后台,一个带有名称的函数被定义,并且使用静态注册表自动注册。通过将函数名称抽象出来,我们可以在不受标识符名称限制的情况下命名我们的测试。
我们使用CHECK()编写我们的各个用例的测试断言。我们用C++的语法自然的表述条件,而不是针对每种类型的条件表达式(等于,小于,大于等)单独用一种,在后台,用一个简单的表达式模板来捕获表达式的左侧值和右侧值,所以我们可以在我们的测试报告中显示这些值。还有其他的断言宏在本教程中没有涉及,但由于这种技术,他们的数量大幅减少。
大多数测试框架都有一个基于类的夹具机制。测试用例映射到类的方法,并且可在setup()
和teardown()
函数(或者在C++这样的语言的构造/析构函数)中执行相同的setup和teardown。
尽管doctest完全支持这种工作方式,但这种方法存在一些问题。特别是你的代码必须被拆分,拆分的粒度可能会导致问题。你只能在一组方法中有一个setup / teardown对,但是有时你需要在每种方法中稍微不同的setup或者你可能需要几个级别的setup(这个概念我们稍后会在本教程中进行阐述)。像[这样的问题]就导致了James Newkirk领导建立了NUnit的团队,从头开始重新构建了xUnit。
doctest采取了一种与NUnit和xUnit不同的方法,这更适合于C++和C一类的语言。
最好通过一个例子来解释:
TEST_CASE("vectors can be sized and resized") {
std::vector v(5);
REQUIRE(v.size() == 5);
REQUIRE(v.capacity() >= 5);
SUBCASE("adding to the vector increases it's size") {
v.push_back(1);
CHECK(v.size() == 6);
CHECK(v.capacity() >= 6);
}
SUBCASE("reserving increases just the capacity") {
v.reserve(6);
CHECK(v.size() == 5);
CHECK(v.capacity() >= 6);
}
}
对于每个SUBCASE(),TEST_CASE()都从头开始执行,所以当执行每个子案例时,我们知道大小是5,容量至少是5。我们用顶级的REQUIRE()宏来执行这些要求,因为我们对此有信心。如果CHECK()失败,这个测试用例被标记为失败,但会执行继续,但是如果REQUIRE()失败,则停止并退出测试。
这是因为SUBCASE()宏包含一个if语句,该语句将回调到doctest中以查看是否应该执行该子用例。TEST_CASE()每次运行一个子用例,其他子用例将被跳过。下一次执行下一个子用例,直到没有遇到新的子用例。
到现在为止,一直都还不错——这已经是setup / teardown方法的一个改进,因为现在我们看得到setup代码,并使用了栈。当我们在下面的例子中开始嵌套时,SUBCASE的实力就显示出来了:
#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
#include "doctest.h"
#include
using namespace std;
TEST_CASE("lots of nested subcases")
{
cout << endl << "root" << endl;
SUBCASE("")
{
cout << "1" << endl;
SUBCASE("") { cout << "1.1" << endl; }
}
SUBCASE("")
{
cout << "2" << endl;
SUBCASE("") { cout << "2.1" << endl; }
SUBCASE("")
{
cout << "2.2" << endl;
SUBCASE("")
{
cout << "2.2.1" << endl;
SUBCASE("") { cout << "2.2.1.1" << endl; }
SUBCASE("") { cout << "2.2.1.2" << endl; }
}
}
SUBCASE("") { cout << "2.3" << endl; }
SUBCASE("") { cout << "2.4" << endl; }
}
}
输出结果:
root
1
1.1
root
2
2.1
root
2
2.2
2.2.1
2.2.1.1
root
2
2.2
2.2.1
2.2.1.2
root
2
2.3
root
2
2.4
subcase可以嵌套到任意深度(仅受限于堆栈大小)。叶子用例(不包含subcase 的用例)将按一个独立于其它叶子用例的路径恰好执行一次,所以一个叶子用例不会干扰另一个叶子用例。而父用例中的致命故障将阻止子用例运行,就是这样设计的。
为了简化教程,我们把所有的代码放在一个文件中。这是对启动有好处,使得进入doctest更加容易和快速。当你开始编写更多真实的测试时,这并不是最好的方法。
要求是下面的代码块(或等价的代码块):
#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
#include "doctest.h"
恰好出现在一个翻译单元(源文件)中。根据需要为测试使用尽可能多的额外的源文件——分区对于你的工作来说是最有意义的。每个额外的文件只需要#include"doctest"
,但不要重复#define
。
实际上把上述的#define
语句放在自己的源文件会更好。
这是一个为了让你快速开始和运行doctest的简单介绍,指出了doctest和其他你可能已经熟悉的框架之间的一些主要区别。这会让你走得很远,你现在可以沉浸其中并写一些测试。
当然你也可以学习后续的内容。
普通断言宏和C中的宏assert(expression)类似,带有一个参数,该参数是一个一元或者二元的条件表达式,为真或为假,产生对应动作 。
REQUIRE(expression)
—— 如果表达式为假,将立即退出测试用例,并将测试用例标记为失败。CHECK(expression)
——如果表达式为假,将测试用例标记为失败,但将继续测试用例。对于用有多用例的测试是很适用的。 WARN(expression)
—— 如果表达式为假,将仅打印一条消息,但不会将测试用例标记为失败。doctest中否定断言有三个级别:
REQUIRE_FALSE(expression)
—— 如果表达式为真,将立即退出测试用例,并将测试用例标记为失败。CHECK_FALSE(expression)
—— 如果表达式为真,将测试用例标记为失败,但将继续测试用例。 WARN_FALSE(expression)
—— 如果表达式为真,将仅打印一条消息,但不会将测试用例标记为失败。带消息的断言
INFO("this is relevant to all asserts, and here is some var: " << local);
CHECK_MESSAGE(a < b, "relevant only to this assert " << other_local << "more text!");
CHECK(b < c); // here only the first INFO() will be relevant
所有的断言只评估一次表达式,如果失败,则表达式的值会被字符串化。
只要抛出的异常,就会被捕获,报告,并算作失败,除非当前的断言级别是WARN
。
请注意,REQUIRE级别的断言使用异常结束当前的测试用例。在用户定义的类的析构函数中使用此级别的断言可能是危险的——如果一个析构函数在异常引起堆栈展开期间被调用,并且REQUIRE断言失败,则程序将终止。此外,从C++11开始,除非另有说明,否则所有析构函数都将默认为noexcept(true),因此这样的断言将导致std :: terminate()
被调用。
这些断言不使用模板来分解条件表达式以捕获左侧和右侧值。所以编译速度快快25%-45%。
是3种可能之一:REQUIRE / CHECK / WARN。
_EQ(left, right) 等价 (left == right)
_NE(left, right) 等价 (left != right)
_GT(left, right) 等价 (left > right)
_LT(left, right) 等价 (left < right)
_GE(left, right) 等价 (left >= right)
_LE(left, right) 等价 (left <= right)
_UNARY(expr) 等价 (expr)
_UNARY_FALSE(expr) 等价 _FALSE(expr)
快速断言是二元和一元断言的更快版本 ,快60-80%。区别在于 如果表达式抛出异常则整个测试结束,不会评估try / catch块中的表达式。
如果定义了DOCTEST_CONFIG_SUPER_FAST_ASSERTS
,可以更快50-80%!
是3种可能之一:REQUIRE / CHECK / WARN。
FAST__EQ(left, right) 等价 (left == right)
FAST__NE(left, right) 等价 (left != right)
FAST__GT(left, right) 等价 (left > right)
FAST__LT(left, right) 等价 (left < right)
FAST__GE(left, right) 等价 (left >= right)
FAST__LE(left, right) 等价 (left <= right)
FAST__UNARY(expr) 等价 (expr)
FAST__UNARY_FALSE(expr) 等价 _FALSE(expr)
是3种可能之一:REQUIRE / CHECK / WARN。
断言在表达式的测试期间会抛出异常(任何类型)。
断言在表达式的测试期间抛会出指定类型的异常。
注意:异常类型原本添加了const或&,用户只需要指定类型即可,因为C++中标准做法是按值抛出,用引用捕捉。
断言在表达式的测试期间不会抛出异常。
注意: 异常断言也有带消息的形式,也是在后面加_MESSAGE
当比较浮点数时,特别是至少有一个浮点数已经被计算出来时, 必须非常小心,以允许舍入误差和不精确的表示。
doctest提供了一种名为doctest::Approx()
的包装类 来实现浮点数的含有误差的比较。 doctest::Approx()
可以用在比较表达式的两边。它重载了比较运算符以允许一定的误差。下面是一个简单的例子:
REQUIRE(performComputation() == doctest::Approx(2.1));
默认情况下,使用使用微小的量(这是相对百分比来说),这能满足很多简单的舍入误差情况。当这个微小的量不能满足需要时,可以通过调用doctest::Approx()
的epsilon()
方法来指定误差值。如:
REQUIRE(22.0/7 == doctest::Approx(3.141).epsilon(0.01)); // allow for a 1% error
当处理非常大或非常小的数字时,指定一个比例会比较有用的,可以通过调用doctest::Approx()
的scale()
方法来实现。
不要将断言宏用在在try / catch中因为REQUIRE宏会抛出异常来结束测试用例!
查看这个例子来了解断言宏的使用。
在对头文件进行预处理和包含之后,测试对每个处理过的源文件从顶部到底部进行注册,但在源文件之间没有顺序。
尽管doctest完全支持传统的xUnit风格的基于类的测试用例写法,但这不是首选样式。doctest提供了在测试用例中嵌套子句的强大机制。测试用例和子用例:
TEST_CASE(test name)
SUBCASE(subcase name)
test name 和subcase name 可以是空,引用,字符串。测试名称在doctest可执行文件中不必是唯一的。它们也应该是字符串。
经典测试用例参加教程。
测试用例也可以参数化——参见文档。
可以通过使用命令行过滤测试用例和子用例——参见命令行。
更多示例请参考SUBCASE 和 BDD 用法示例。
doctest除了支持经典风格的测试用例之外,doctest还支持一种替代语法,该语法允许将测试写为“可执行规范”(行为驱动开发的早期目标之一)。这组宏映射到TEST_CASE s 和SUBCASE s,带有一些内部支持以使它们更使用更顺畅。
SCENARIO( scenario name )
——该宏映射到TEST_CASE
并以相同的方式工作,但测试用例名称将以“Scenario:”为前缀。SCENARIO_TEMPLATE( scenario name, type, list of types )
——该宏映射到TEST_CASE_TEMPLATE
,并以相同的方式工作,但测试用例名称将以“Scenario:”为前缀。SCENARIO_TEMPLATE_DEFINE( scenario name, type, id )
——该宏映射到TEST_CASE_TEMPLATE_DEFINE
,并以相同的方式工作,但测试用例名称将以“Scenario:”为前缀。
GIVEN( something )
、WHEN( something )
、 THEN( something )
——这些宏映射到SUBCASE s上,但子用例的名称是前缀为“given:”,“when:”或“then:”的_something_s。
AND_WHEN( something )
、AND_THEN( something )
——与WHEN和THEN类似,但前缀是以“and”开头。这些用于将WHEN s和THEN s链接在一起。 当使用这些宏中的任何一个时,控制台报告器会识别它们并格式化测试用例头文件,以使Givens,Whens和Thens对齐来提高可读性。
除了附加前缀和控制台报告器中的格式外,这些宏与TEST_CASE和SUBCASE完全相同。因此,没有执行这些宏的正确排序——这取决于程序员!
更多示例请参考SUBCASE 和 BDD 用法示例。
虽然doctest允许您将测试集合在一起作为一个测试用例中的子用例,但是有时候,使用更传统的Test fixtures将它们分组更方便。 doctest也完全支持这种方式。您将测试夹具定义为简单结构:
class UniqueTestsFixture
{
private:
static int uniqueID;
protected:
DBConnection conn;
public:
UniqueTestsFixture() : conn(DBConnection::createConnection("myDB"))
{
}
protected:
int getID()
{
return ++uniqueID;
}
};
int UniqueTestsFixture::uniqueID = 0;
TEST_CASE_FIXTURE(UniqueTestsFixture, "Create Employee/No Name")
{
REQUIRE_THROWS(conn.executeSQL("INSERT INTO employee (id, name) VALUES (?, ?)", getID(), ""));
}
TEST_CASE_FIXTURE(UniqueTestsFixture, "Create Employee/Normal")
{
REQUIRE(conn.executeSQL("INSERT INTO employee (id, name) VALUES (?, ?)", getID(), "Joe Bloggs"));
}
这两个测试用例将创建唯一命名的UniqueTestsFixture的派生类,因此可以访问getID()保护方法和conn成员变量。这样可以确保两个测试用例能够使用相同的方法(DRY原则)创建一个DBConnection,并且创建的任何ID是唯一的,这使得执行测试的顺序并不重要。
测试用例可以分组成测试套件。这是通过TEST_SUITE()或TEST_SUITE_BEGIN()/ TEST_SUITE_END()完成的。例如:
TEST_CASE("") {} // not part of any test suite
TEST_SUITE("math") {
TEST_CASE("") {} // part of the math test suite
TEST_CASE("") {} // part of the math test suite
}
TEST_SUITE_BEGIN("utils");
TEST_CASE("") {} // part of the utils test suite
TEST_SUITE_END();
TEST_CASE("") {} // not part of any test suite
那么指定测试套件的测试用例可以通过指定过滤器的来执行——参见命令行。
有关测试套件的更多例子请参看断言宏示例。
测试用例可以使用如下附加属性进行修饰:
TEST_CASE("name"
* doctest::description("shouldn't take more than 500ms")
* doctest::timeout(0.5)) {
// asserts
}
可以同时使用多个修饰器。下面是目前支持的修饰器:
skip(bool = true)
——标记要从执行中跳过的测试用例,除非使用–no-skip命令行选项。may_fail(bool = true)
——如果任何给定的断言失败,测试不会失败(但仍然报告)—— 这可以用于标记正在进行的工作,或您不想立即修复但仍想在测试中追踪的已知问题。should_fail(“text”)
——类似may_fail(),但如果通过测试,也算作失败——如果要通知意外或第三方修复,他可能会很有用。expected_failures(int)
——定义在测试用例中预计失败的断言数—— 当失败的断言数与声明的预期失败次数不同时,该测试用例算作失败。 timeout(double)
——如果测试用例的执行超过此限制(以秒为单位),该测试用例就算做失败——但不会终止测试用例——这需要子进程支持 。test_suite(“name”)
——可以在测试用例中用来重载其所在的测试套件。 description(“text”)
——描述测试用例。 修饰器采用的值在注册测试用例时(在全局初始化期间)计算,是在进入main()之前,而不是在运行之前。
修饰器也可以应用于测试套件块,并且该块中的所有测试用例都继承这些属性。
TEST_SUITE("some TS" * doctest::description("all tests will have this")) {
TEST_CASE("has a description from the surrounding test suite") {
// asserts
}
}
TEST_SUITE("some TS") {
TEST_CASE("no description even though in the same test suite as the one above") {
// asserts
}
}
测试用例可以重载他们从父测试套件继承的装饰器:
TEST_SUITE("not longer than 500ms" * doctest::timeout(0.5))
{
TEST_CASE("500ms limit")
{
// asserts
}
TEST_CASE("200ms limit" * doctest::timeout(0.2))
{
// asserts
}
}
测试用例可以通过类型和值进行参数化。
目前在doctest中有两种做数据驱动测试的方法,在未来会有更好的得支持。
void doChecks(int data)
{
// do asserts with data
}
TEST_CASE("test name")
{
std::vector<int> data {1, 2, 3, 4, 5, 6};
for(auto& i : data)
{
CAPTURE(i); // log the current input data
doChecks(i);
}
}
缺点:
(1)在异常情况下(或REQUIRE断言失败),整个测试用例将结束,对剩余的输入数据不再测试。
(2)用户必须通过调用CAPTURE()(或INFO())来手动记录数据。
(3)更多的样板 ——doctest应该提供用于生成数据的原语,但目前没有—— 所以用户必须编写自己的数据生成器。
TEST_CASE("test name")
{
int data;
SUBCASE("") { data = 1; }
SUBCASE("") { data = 2; }
CAPTURE(data);
// do asserts with data
}
缺点:
(1)不能很好地扩展—— 为多个不同的输入编写这样的代码是不切实际的。
(2)用户必须通过调用CAPTURE()(或INFO())来手动记录数据。
然而有一个简单的方法可以把它封装成一个宏(为简单起见用C++11编写):
#include
#include
#include
#define DOCTEST_VALUE_PARAMETERIZED_DATA(data, data_array) \
static std::vector<std::string> _doctest_subcases = [&data_array]() \
{ \
std::vector<std::string> out; \
while(out.size() != data_array.size()) \
out.push_back(std::string(#data_array "[") +std::to_string(out.size() + 1) + "]"); \
return out; \
}(); \
int _doctest_subcase_idx = 0; \
std::for_each(data_array.begin(), data_array.end(), [&](const auto& in) { \
DOCTEST_SUBCASE(_doctest_subcases[_doctest_subcase_idx++].c_str()) { data = in; } \
})
现在可以这样使用:
TEST_CASE("test name")
{
int data;
std::list<int> data_array = {1, 2, 3, 4};
// must be iterable—— std::vector<> would work as well
DOCTEST_VALUE_PARAMETERIZED_DATA(data, data_array);
printf("%d\n", data);
}
通过重复进入测试用例3次(在第一次进入之后)来打印4个数字——就像子用例那样。
这种方法的一个很大的局限性是宏不能和其他子类在同一个代码块{}缩进级别下使用(会很奇怪) - 它只能在子用例内使用。
static std::vector
是必要的,因为SUBCASE()宏接受const char *参数,并不复制字符串,而是在内部保持指针——这就是为什么我们需要构建字符串的持久版。这可能会在将来版本中改变(接受一个字符串类),以方便使用……
假设您有多个相同的接口的实现,并希望确保它们都满足一些共同的要求。或者,您可能已经定义了符合“相同概念”的几种类型,并且您想要验证它们。在这两种情况下,您想针对不同类型重复相同的测试逻辑。
尽管您可以为每个要测试的类型编写一个TEST_CASE(并且您甚至可以将测试逻辑分解成从测试用例中调用的函数模板),但是它是乏味且不通用的:如果您需要M次测试超过N类型,你最终将编写M * N测试。
模板测试允许您在一个类型的列表上重复相同的测试逻辑。你只需要写一次测试逻辑。有两种方法可以做到:
typedef doctest::Types<char, short, int, long long int> the_types;
TEST_CASE_TEMPLATE("signed integers stuff", T, the_types)
{
T var = T();
--var;
CHECK(var == -1);
}
TEST_CASE_TEMPLATE_DEFINE("signed integer stuff", T, test_id)
{
T var = T();
--var;
CHECK(var == -1);
}
typedef doctest::Types<char, short, int, long long int> the_types;
TEST_CASE_TEMPLATE_INSTANTIATE(test_id, the_types);
typedef doctest::Types<float, double> the_types_2;
TEST_CASE_TEMPLATE_INSTANTIATE(test_id, the_types_2);
如果您正在设计一个接口或概念,您可以定义一组类型参数化测试来验证接口/概念的任何有效实现应具有的属性。然后,每个实现的作者都可以用他的类型实例化测试套件,以验证它是否符合要求,而不必重复编写类似的测试。
一个名为signed integers stuff的测试用例实例化为int类型,将产生以下测试用例名称:
signed integers stuff<int>
默认情况下,所有基本类型( int,bool,float …)都具有由库提供的字符串。对于所有其他类型,用户将不得不使用TYPE_TO_STRING(类型)宏,如下所示:
TYPE_TO_STRING(std::vector<int>);
TYPE_TO_STRING
宏仅在当前源文件中有效果,因此如果在分开的源文件中使用相同类型的模板化测试用例,则需要在某些头文件中使用该宏。
其他测试框架使用头文件
来自动获取类型对应字符串,但是doctest不能在头文件的前向声明部分(公共头文件)中包含任何头文件—— 所以用户必须告知框架每种类型,这是为了实现最优的编译时性能。
doctest :: Types <>
模板最多可以接受60个参数。DOCTEST_CONFIG_WITH_VARIADIC_MACROS
),可以跳过typedef,并且可以直接在宏中构造类型列表,否则编译器会认为类型列表中的每个逗号都引入了一个新的宏参数。通过可变参数宏支持,TYPE_TO_STRING宏也可以和std :: pair
这样的类型一起使用。 template <typename first, typename second>
struct TypePair
{
typedef first A;
typedef second B;
};
typedef Types<
TypePair<int, char>,
TypePair<char, int>
> pairs;
TEST_CASE_TEMPLATE("multiple types", T, pairs) {
typedef typename T::A T1;
typedef typename T::B T2;
// use T1 and T2 types
}
更多示例请参考模板测试用例。
doctest没有任何命令行选项也工作相当不错,但是有一堆控制选项可用。分为如下几类:
--order-by = rand
。 过滤器使用通配符来进行匹配—— 其中*
表示“匹配任何序列”,?
意思是“匹配任何一个字符”。模式串应放在引号内,比如:--test-case="*no sound*,vaguely named test number ?"
如果用户提供main()函数,所有选项也可以使用代码设置(使用默认值或者重新设置)。
Query Flags | Description |
---|---|
-? 、--help 、-h |
打印一个帮助消息,会列出所有这些标志/选项 |
-v 、--version |
打印doctest框架的版本 |
-c 、--count |
打印与当前过滤器匹配的测试用例数(见下文) |
-ltc 、--list-test-cases |
按名字列出与当前过滤器匹配的所有测试用例(见下文) |
-lts 、--list-test-suites |
按名字列出所有测试套件,每个测试套件至少有一个与当前过滤器匹配的测试用例(见下文) |
Int/String Options | Description |
---|---|
-tc 、--test-case= |
根据测试名称过滤测试用例。默认情况下,所有测试用例都匹配,但是如果给这个过滤器赋予一个值,如--test-case = * math *,* sound * ,则只有与模式串列表中的任意一个或多个匹配的测试用例才会得到执行/计算/列出 |
-tce 、--test-case-exclude= |
类似-test-case = 选项,只是会跳过与模式串匹配的测试用例 |
-sf 、 --source-file= |
与--test-case = 类似,但是是基于文件名过滤 |
-sfe 、 --source-file-exclude= |
与--test-case-exclude = 类似,但是基于文件名过滤 |
-ts 、 --test-suite= |
与--test-case = 类似,但是基测试套件名过滤 |
-tse 、--test-suite-exclude= |
与--test-case-exclude = 类似,但是基于测试套件名过滤 |
-sc 、 --subcase= |
与--test-case = 类似,但根据子用例名过滤 subcase |
-sce 、--subcase-exclude= |
与--test-case-exclude = 类似,但基于子用例名过滤 |
-ob 、 --order-by= |
测试用例在被执行之前将按照所在文件名/所在测试套件名/测试用例名/随机 进行排序, string的可能值是file、suit、name、rand,默认为file。 |
-rs 、--rand-seed= |
随机排序的种子 |
-f 、--first= |
通过当前过滤器执行的第一个测试用例——用于基于范围的执行——请参见示例 |
-l 、--last= |
通过当前过滤器执行的最后一个测试用例——用于基于范围的执行——请参见示例 |
-aa 、--abort-after= |
测试框架在多次断言失败之后将停止测试。默认值为0,表示不会停止。请注意,框架使用异常来停止当前的测试用例,而不管断言(CHECK / REQUIRE)的级别如何——因此要在析构函数中断言要非常小心 |
-scfl 、--subcase-filter-levels= |
仅在前级子用例中使用子用例过滤器,也只执行深度为的子用例,默认值是非常高的数字,意味着过滤所有的子用例 |
Bool Options | Description |
---|---|
-s 、--success= |
在输出结果中包含成功的断言 |
-cs 、--case-sensitive= |
过滤器要区分大小写 |
-e 、--exit= |
测试结束后退出—— 只有当客户端提供main()入口点时,这才有意义——程序应该在doctest :: Context 对象调用run() 之后检查shouldExit() 方法,然后退出—— 这留给用户来完成。这个想法是只有测试在客户端程序中才能执行 ,而自身并不能继续执行 |
-d 、 --duration= |
以秒为单位打印每个测试所用时间 |
-nt 、 --no-throw= |
跳过与异常相关的断言 |
ne 、 --no-exitcode= |
始终返回成功的退出代码—— 即使测试失败 |
-nr 、 --no-run= |
跳过所有运行时的doctest操作(发生在程序进入main()之前的测试注册除外)。如果将测试框架集成到提供了main()入口点的客户端代码库并且用户想要跳过执行测试而只是使用该程序,这将非常有用 |
-nv 、 --no-version= |
输出中的省略框架版本 |
-nc 、 --no-colors= |
禁用彩色输出 |
-fc 、 --force-colors= |
强制使用彩色输出,即使无法检测到tty |
-nb 、 --no-breaks= |
当断言失败时,禁用调试器中的断点 |
-ns 、 --no-skip= |
不要跳过用装饰器标记为skip的测试用例 |
-npf 、--no-path-filenames= |
当打印文件名时,将路径从输出中删除—— 用于要在不同环境中得到来自测试框架的相同输出 |
-nln 、 --no-line-numbers= |
当打印源位置时,输出中的行号将被替换为0 ——用于即使源文件中的测试位置发生变化,也想获得相同的输出 |
--version
也可以用--dt-version
或--dt-v
代替。DOCTEST_CONFIG_NO_UNPREFIXED_OPTIONS
来禁用所有无前缀的标志/选项。#define DOCTEST_CONFIG_NO_UNPREFIXED_OPTIONS
#define DOCTEST_CONFIG_IMPLEMENT
#include "doctest.h"
class dt_removed
{
std::vector<const char*> vec;
public:
dt_removed(const char** argv_in)
{
for(; *argv_in; ++argv_in)
if(strncmp(*argv_in, "--dt-", strlen("--dt-")) != 0)
vec.push_back(*argv_in);
vec.push_back(NULL);
}
int argc()
{
return static_cast<int>(vec.size()) - 1;
}
const char** argv()
{
return &vec[0];
} // Note: non-const char **:
};
int program(int argc, const char** argv);
int main(int argc, const char** argv)
{
doctest::Context context(argc, argv);
int test_result = context.run();
// run queries, or run tests unless --no-run
if(context.shouldExit()) // honor query flags and --exit
return test_result;
dt_removed args(argv);
int app_result = program(args.argc(), args.argv());
return test_result + app_result; // combine the 2 results
}
int program(int argc, const char** argv)
{
printf("Program: %d arguments received:\n", argc - 1);
while(*++argv)
printf("'%s'\n", *argv);
return EXIT_SUCCESS;
}
当我们按下面所示运行时:
program.exe --dt-test-case=math* --my-option -s --dt-no-breaks
输出结果为:
Program: 2 arguments received:
'--my-option'
'-s'
在测试用例中可以记录额外消息。
INFO()宏允许以和std :: ostream,std :: cout等相同的方式使用插入运算符(<<)。
INFO("The number is " << i);
此消息将与当前作用域中位于info之后或嵌套在当前作用域中的所有断言相关,并且只有在断言失败时才会打印。
注意,没有初始<< ——而是将插入序列放在括号中。
该消息不是立即构建的,而是仅在需要时才被延迟进行字符串化。这意味着rvalues(临时值)不能传递给INFO()宏。所有文字常量都被视为标准的右值引用——除了C字符串文字(“like this one”)。这意味着即使正常的整数文字也不能直接使用—— 在传递给INFO()之前,它们需要存储在变量/常量中。如果使用C ++14(或Visual Studio 2017),doctest提供TO_LVALUE()
宏来帮助这方面 ——它将任何文字常量或constexpr值转换为左值,可以像这样使用:
constexpr int foo()
{
return 42;
}
TEST_CASE("playing with literals and constexpr values")
{
INFO(TO_LVALUE(6) << " and this is a C string literal " << TO_LVALUE(foo()));
CHECK(false);
}
TO_LVALUE()也可以在想要避面静态constexpr成员称为ODR-used的上下中起作用,请看DOCTEST_CONFIG_ASSERTION_PARAMETERS_BY_VALUE。
一些注意事项:
- 延迟字符串化意味着值被字符串化发生在一个断言失败而不是在捕获时—— 所以该值可能已经改变。
- 如果库使用C++ 11右引用构建(请参阅
DOCTEST_CONFIG_WITH_RVALUE_REFERENCES
),则提供删除重载以禁止在INFO()调用中捕获右值——因为延迟字符串化实际上缓存了指向对象的指针。对于C ++98临时值将再次无效,但会有可怕的编译错误。DOCTEST_CONFIG_NUM_CAPTURES_ON_STACK
配置标识符可用于控制使用多少栈空间来以避免为stream macros 分配堆空间。- 可以使用流操纵器(来自),但需要创建为局部变量并作为左值使用。
- 有关如何教导doctest对您的类型进行字符串的信息,请参阅字符串化页面 。
延迟字符串和栈的使用意味着在常见的情况下,当无断言失败时,代码运行速度非常快。这使得它在循环中也适用——也许要记录迭代器。
还有一个CAPTURE()宏,它是对INFO()的一个更方便的包装:
CAPTURE(some_variable)
这将为你处理变量名称的字符串(实际上它适用于任何表达式,而不仅仅是变量)。这将记录如下:
some_variable := 42
还有一些其他宏用于记录信息:
MESSAGE(message)
FAIL_CHECK(message)
FAIL(message)
FAIL()
类似于REQUIRE断言 ——使测试用例失败并退出。 FAIL_CHECK()
的作用就像一个CHECK断言 ——使测试用例失败,但继续执行。 MESSAGE()
只打印一条消息。
在这些所有宏中,消息再次使用“流操作符<<, 如下所示:
FAIL("This is not supposed to happen! some var: " << var);
此外,这里没有延迟字符串化——字符串总是构造和打印,因此对记录的值没有限制——临时和值可被接受 ——与INFO()
宏不同。
还有一些打算供第三方库使用的消息宏,如mocking frameworks:
ADD_MESSAGE_AT(file, line, message)
ADD_FAIL_CHECK_AT(file, line, message)
ADD_FAIL_AT(file, line, message)
当将来自不同框架的断言与doctest集成时,它们将非常有用。
更多示例请参考日志示例。
在C++中编写测试的通常方法是将源文件与它们测试的代码分开,形成只包含测试的可执行文件。在这种情况下,由doctest提供的默认main()通常就足够了:
#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
#include "doctest.h"
这应该在一个源文件中完成,甚至在一个单独没有其他的东西的文件中。
但是,如果您需要更多的控制——想要用代码设置执行上下文,或者希望将框架集成到自己的生产代码中,那么默认的main()就无法胜任此工作了。在这种情况下请使用DOCTEST_CONFIG_IMPLEMENT.
。
所有的命令行选项都可以这样设置(falg则不能,因为没有意义)。只能使用doctest::Context
对象的addFilter()
或clearFilters()
方法附加或清除过滤器 ——用户无法使用代码删除特定过滤器。
#define DOCTEST_CONFIG_IMPLEMENT
#include "doctest.h"
int main(int argc, char** argv) {
doctest::Context context;
// !!! THIS IS JUST AN EXAMPLE SHOWING HOW DEFAULTS/OVERRIDES ARE SET !!!
// defaults
context.addFilter("test-case-exclude", "*math*"); // exclude test cases with "math" in their name
context.setOption("abort-after", 5); // stop test execution after 5 failed assertions
context.setOption("order-by", "name"); // sort the test cases by their name
context.applyCommandLine(argc, argv);
// overrides
context.setOption("no-breaks", true); // don't break in the debugger when assertions fail
int res = context.run(); // run
if(context.shouldExit()) // important - query flags (and --exit) rely on the user doing this
return res; // propagate the result of the tests
int client_stuff_return_code = 0;
// your program - if the testing framework is integrated in your production code
return res + client_stuff_return_code; // the result from doctest is propagated here as well
}
注意在上下文对象中调用.shouldExit()
——这非常重要—— 当使用查询标志(或–no-run选项设置为true)时将会设置它,并且以正常方式退出应用程序是用户有责任。
框架可以在二进制文件(可执行文件/共享对象)中单独使用,每个都有自己的测试运行器——这样甚至可以使用不同版本doctest——但是没有简单的方法可以从加载的全部二进制文件中执行测试,并让结果汇总。
还有一个选项可以让测试运行器(实现)内置在二进制文件中,并通过导出它的公共符号与其他程序共享(因此有一个单独的测试注册表),(是用户编写测试所需的是框架的所有的前向声明)。
更多信息请看DOCTEST_CONFIG_IMPLEMENTATION_IN_DLL配置标识符和示例。
doctest旨在尽可能地“高效工作”。它还允许使用一组标识符配置它的构建方式。
标识符应在包含框架头文件之前定义。
全局定义的东西意味着每个源文件的二进制(可执行/共享对象)都共享配置。
对于大多数人来说,唯一所需的配置是告诉doctest哪个源文件应该托管所有的实现代码.
DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
#define DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
#include "doctest.h"
这只能在库实现的源文件中定义。
DOCTEST_CONFIG_IMPLEMENT
如果客户端想要提供main()函数(要么从代码中设置一些选项的值或将框架集成到其他现有的项目代码库中),那么就应该使用这个标识符。
DOCTEST_CONFIG_DISABLE
最重要的配置选项之一所有与测试相关的配置选项都从二进制文件中删除——包括框架实现和写在任何地方测试用例!这是doctest最独特的功能之一。
这应该在全局定义。
DOCTEST_CONFIG_IMPLEMENTATION_IN_DLL
这个宏将影响doctest的公共接口——所有编写测试所需的前向声明将被转换为导入的符号。这样,测试运行器不必在二进制(可执行/共享对象)中实现,并且可以从构建和导出它的另一个二进制文件重用。
要从二进制文件导出测试运行程序,只需在测试实现测试运行器的任何源文件中一起使用DOCTEST_CONFIG_IMPLEMENTATION_IN_DLL
与DOCTEST_CONFIG_IMPLEMENT
(或DOCTEST_CONFIG_IMPLEMENT_WITH_MAIN
,但此时其他二进制文件必须链接到可执行文件)。请注意,不应在导出doctest测试运行器的二进制文件的其他源文件中定义此标识符,否则将导致链接器冲突——在同一个二进制文件中具有相同的导入和导出符号。
查看这个示例——它展示了如何在dll中实现测试运行器(甚至在一个动态加载的插件中测试)。
这应该在导入符号的二进制文件中全局定义。
应该仅在导出测试运行器的二进制文件的库的源文件中定义。
DOCTEST_CONFIG_NO_SHORT_MACRO_NAMES
这将删除doctest中没有DOCTEST_前缀的所有宏,如CHECK
,TEST_CASE
和SUBCASE
。然后只有完整的宏名称可用——如DOCTEST_CHECK
,DOCTEST_TEST_CASE
和DOCTEST_SUBCASE
。用户可以自己制作这些宏的简短版本——参见示例。
他可以在全局或仅在特定的源文件中进行定义。
DOCTEST_CONFIG_NUM_CAPTURES_ON_STACK
使用此标识符,用户可以通过INFO()日志记录宏来配置栈上的捕获次数(请阅读更多信息)。默认值为5——这意味着对于这样的调用:INFO(var1 <<“la la”<< var2)
;所有3个被记录的变量将在栈上被捕获(支持2个以上——没有堆分配,除非在同一作用域内的断言失败)——栈中总共5*(sizeof(void *)*2))
字节用于捕获。随后调用的INFO()将拥有自己的栈空间。请注意,0是无效值。例子:。
#define DOCTEST_CONFIG_NUM_CAPTURES_ON_STACK 10
#include
或通过命令行:-DDOCTEST_CONFIG_NUM_CAPTURES_ON_STACK = 10
应当在全局定义。
DOCTEST_CONFIG_TREAT_CHAR_STAR_AS_STRING
默认情况下,char 被视为指针。使用此选项比较char 指针将切换到为用strcmp()进行比较,并且当字符串化时,将打印字符串而不是指针值。
应当在全局定义。
DOCTEST_CONFIG_SUPER_FAST_ASSERTS
这使得快速断言宏(FAST_CHECK_EQ(a,b)——具有FAST_前缀)编译更快!(50-80%)
每个快速断言变成一个单一的函数调用——唯一的缺点是:如果一个断言失败并且调试器被附加——当中断时,它将变成一个内部函数——用户必须在1级调用栈才能看到实际的断言。
这可以在全局和仅在特定的源文件中进行定义。
DOCTEST_CONFIG_USE_IOSFWD
默认情况下,库没有提供std::ostream
的前向声明来支持运算符<<的字符串化机制。这是被标准禁止的(即使它在所有测试的编译器上都可以使用)。但如果用户希望100%与标准兼容,则可以使用此配置选项强制包含
头文件。
另外,可能一些使用niche的编译器的STL实现定义了不同的用法—— 那么在STL头中会出现编译错误,使用这个选项可以解决该问题。
应该在全局定义。
DOCTEST_CONFIG_NO_COMPARISON_WARNING_SUPPRESSION
默认情况下,库禁止关于比较有符号和无符号类型时的警告。
- g++/clang -Wsign-conversion
- g++/clang -Wsign-compare
- msvc C4389 ‘operator’ : signed/unsigned mismatch
- msvc C4018 ‘expression’ : signed/unsigned mismatch
您可以查看该问题,以更好地了解为什么默认禁止这些警告。
这可以在全局和仅在特定的源文件中进行定义。
DOCTEST_CONFIG_NO_UNPREFIXED_OPTIONS
这将禁用命令行选项的简短版本,只有具有–dt-前缀的版本才会由doctest解析——在测试框架集成到客户端代码库中时,与客户端命令行选项的处理会更容易交互——没有冲突,所以用户可以从他们的选项解析中排除以–dt-开头的所有内容。
这应该仅在库实现的源文件中定义(仅在那里)。
DOCTEST_CONFIG_NO_TRY_CATCH_IN_ASSERTS
这将从下面的情况中删除所有try / catch部分,:
- 正常断言
- 二元和一元断言——使其功能与快速断言相同(但不包括编译速度)
因此在断言中评估一个表达式时,若抛出异常,将终止当前的测试用例。
这可以在全局和仅在特定的源文件中进行定义。
DOCTEST_CONFIG_NO_EXCEPTIONS
这将从框架中删除使用异常的所有内容——如果使用-fno-exceptions
禁用异常,也可以为某些编译器(GCC,Clang)自动检测到。对于MSVC _HAS_EXCEPTIONS
不能用于自动检测,因为它在系统头文件中定义,而不是项目中定义,并且doctest不会包含这个头文件。
什么变了:
- 在这样的上下文中,在try / catch部分中的测试表达式的断言不再进行测试。
REQUIRE
宏已经消失(未定义)异常宏消失
(未定义)abort-after
选项将不能完全正常的工作,因为异常用于终止测试用例。
当测试用例失败时,REQUIRE系列的断言使用异常终止当前测试用例。使用异常而不是简单的返回;因为断言不仅可以在测试用例中使用,还可以在测试用例的函数调用中使用。
还有一些像REQUIRE断言(终止测试用例)的日志记录宏——就像FAIL()——开始不一样的工作——FAIL_CHECK()。
DOCTEST_CONFIG_NO_EXCEPTIONS
意味着DOCTEST_CONFIG_NO_TRY_CATCH_IN_ASSERTS
。
如果您希望使用可以处理异常的断言,但有时构建时又不用异常——请检查DOCTEST_CONFIG_NO_EXCEPTIONS_BUT_WITH_ALL_ASSERTS
配置选项。
这应该在全局定义。
DOCTEST_CONFIG_NO_EXCEPTIONS_BUT_WITH_ALL_ASSERTS
当不用异常构建测试时(参考DOCTEST_CONFIG_NO_EXCEPTIONS
),RQUIRE宏和处理异常的宏都将消失(未定义)。
然而,如果您希望可以使用处理异常的断言,但有时构建时又不用异常——就可以使用这个配置项,影响如下:
- REQUIRE断言并没有消失——但是他们的行为就像CHECK宏——当其中一个测试失时败,整个测试用例将被标记为失败,但不会立即退出。
- 处理异常的断言变为空操作(而不是完全未定义)。
这可以在全局和仅在特定的源文件中进行定义。
DOCTEST_CONFIG_ASSERTION_PARAMETERS_BY_VALUE
template<typename T>
struct type_traits { static const bool value = false; };
// unless DOCTEST_CONFIG_ASSERTION_PARAMETERS_BY_VALUE is defined the following assertion
// will lead to a linker error if type_traits::value isn't defined in a translation unit
CHECK(type_traits<int>::value == false);
这可以在全局和仅在特定的源文件中进行定义。
DOCTEST_CONFIG_COLORS_NONE
这将消除在框架的控制台输出中对颜色的支持。
这应该仅在库实现的源文件中定义(仅在那里)。
DOCTEST_CONFIG_COLORS_WINDOWS
这将强制对控制台输出颜色的支持,以使用Windows API和头文件。
这应该仅在库实现的源文件中定义(仅在那里)。
DOCTEST_CONFIG_COLORS_ANSI
这将在控制台强制支持输出颜色,以使用ANSI转义代码。
这应该仅在库实现的源文件中定义(仅在那里)。
DOCTEST_CONFIG_WINDOWS_SEH
这将在Windows上启用SEH处理。目前仅在使用MSVC编译时启用,因为某些版本的MinGW没有必要的Win32 API支持。用户可以选择明确启用该功能—— 已知可以使用在MinGW-w64项目中。
这应该仅在库实现的源文件中定义(仅在那里)。
DOCTEST_CONFIG_NO_WINDOWS_SEH
当DOCTEST_CONFIG_WINDOWS_SEH
被默认开启时,用于禁用它。
这应该仅在库实现的源文件中定义(仅在那里)。
DOCTEST_CONFIG_POSIX_SIGNALS
这将允许在UNIX下使用信号来处理崩溃。默认开启,
这应该仅在库实现的源文件中定义(仅在那里)。
DOCTEST_CONFIG_NO_POSIX_SIGNALS
当DOCTEST_CONFIG_POSIX_SIGNALS
被默认开启时,用于禁用DOCTEST_CONFIG_POSIX_SIGNALS
。
这应该仅在库实现的源文件中定义(仅在那里)。
DOCTEST_CONFIG_INCLUDE_TYPE_TRAITS
这被用于强制引入C++11的
头文件。——这使得Approx
辅助类可以使用double
这样的强类型定义,查看这个或这个问题的以获得更多细节。
这可以在全局和仅在特定的源文件中进行定义。
DOCTEST_CONFIG_WITH_DELETED_FUNCTIONS
doctest尝试检测C++ 11已被删除的函数是否可用,如果没有检查到,用户可以定义这个宏。
这应该在全球定义。
DOCTEST_CONFIG_WITH_RVALUE_REFERENCES
doctest尝试检测C++ 11右值引用是否可用,如果没有检查到,用户可以定义这个宏。
这应该在全球定义。
DOCTEST_CONFIG_WITH_VARIADIC_MACROS
doctest尝试检测C++ 11 可变参数宏 是否可用,如果没有检查到,用户可以定义这个宏。
这可以在全局和仅在特定的源文件中进行定义。
DOCTEST_CONFIG_WITH_NULLPTR
doctest尝试检测C++ 11 nullptr
是否可用,如果没有检查到,用户可以定义这个宏。
这应该在全球定义。
DOCTEST_CONFIG_WITH_LONG_LONG
doctest尝试检测C++ 11 long long
的功能是否可用,如果没有检查到,用户可以定义这个宏。
这应该在全球定义。
DOCTEST_CONFIG_WITH_STATIC_ASSERT
doctest尝试检测C++ 11 static_assert
是否可用,如果没有检查到,用户可以定义这个宏。
这应该在全球定义。
DOCTEST_CONFIG_NO_DELETED_FUNCTIONS
如果doctest检测到支持C++11 已删除函数,并且用户很了解,这可以用来禁用该功能。
这应该在全球定义。
DOCTEST_CONFIG_NO_RVALUE_REFERENCES
如果doctest检测到支持C++11 右值引用,并且用户很了解,这可以用来禁用该功能。
这应该在全球定义。
DOCTEST_CONFIG_NO_VARIADIC_MACROS
如果doctest检测到支持C++11 可变参数宏,并且用户很了解,这可以用来禁用该功能。
这可以在全局和仅在特定的源文件中进行定义。
DOCTEST_CONFIG_NO_NULLPTR
如果doctest检测到支持C++11 nullptr
,并且用户很了解,这可以用来禁用该功能。
这应该在全球定义。
DOCTEST_CONFIG_NO_LONG_LONG
如果doctest检测到支持C++11 long long
,并且用户很了解,这可以用来禁用该功能。
这应该在全球定义。
DOCTEST_CONFIG_NO_STATIC_ASSERT
如果doctest检测到支持C++11 static_assert()
,并且用户很了解,这可以用来禁用该功能。
这应该在全球定义。
doctest要能够转换在断言中使用的类型,并将表达式记录到字符串中(用于记录和报告)。大多数内置类型都支持开箱即用,但有三种方法可以告诉doctest如何将自己的类型(或其他第三方类型)转换为字符串。
<<
这是在C++中提供字符串转换的标准方式,您可能已经为自己的目标提供了这种方式。如果你不熟悉这种用法,和写一个自由函数类似:
std::ostream& operator<< (std::ostream& os, const T& value)
{
os << convertMyTypeToString(value);
return os;
}
(其中T是您的类型,convertMyTypeToString是您将编写的使您的类型可打印的任何代码——它不必在另一个函数中)。
您应该将此函数放在与您的类型相同的命名空间中。
或者你可能更喜欢把它写成一个成员函数:
std::ostream& T::operator<<(std::ostream& os) const
{
os << convertMyTypeToString(*this);
return os;
}
doctest::toString
如果你不想重载运算符<<,或者你想为测试目的转换不同类型,你可以重载toString()
,其返回doctest::String
。
namespace user
{
struct udt {};
doctest::String toString(const udt& value)
{
return convertMyTypeToString(value);
}
}
请注意,该函数必须在与您的类型相同的命名空间中。如果类型不在任何命名空间中,那么重载也应在全局命名空间中。convertMyTypeToString是您编写以使您的类型可打印的任何代码。
doctest::StringMaker
特例化 toString
不能按预期工作。特例化StringMaker
为您提供更精确和可靠的控制——但代价和复杂性稍微增加:namespace doctest
{
template<>
struct StringMaker
{
static String convert(const T& value)
{
return convertMyTypeToString(value);
}
};
}
默认情况下,所有从std::exception
排派生的异常将通过调用·what()·方法转换为字符串。对于不是从std::exception
派生的异常类型或者what()
不返回合适的字符串,使用REGISTER_EXCEPTION_TRANSLATOR
。这定义了一个函数,它接收你的异常类型并返回一个doctest ::String
。它可以出现在代码的任何地方——它不必在同一个转化单元中。例如:
REGISTER_EXCEPTION_TRANSLATOR(MyType& ex)
{
return doctest::String(ex.message());
}
请注意,异常可被接受而无需引用,但在C++中被认为是不良做法。
注册异常转换器的另一种方法是在执行任何测试之前执行以下函数:
// adding a lambda - the signature required is `doctest::String(exception_type)`
doctest::registerExceptionTranslator<int>([](int in){ return doctest::toString(in); });
可以控制注册异常翻译器的顺序,只需按照所需的顺序显式的调用 函数,或者在单个翻译单元(源文件)中以顶端到底部的方式列出异常转换器的宏,对单个源文件来说,doctest中自动注册都以顶端到底部的方式工作。
查看这个示例来看如何对std::vector
和其他类型/异常进行字符串化。
注意:当特例化StringMaker
或者重载toString()
时,type string 将被使用——doctest也使用type string。std::string
不是候选项,因为 doctest没有引入头文
。
为了支持运算符<<、(、std::ostream&…字符串库没有提供std::ostream的前向声明,虽然在库中就是这样,但在标准中是被禁止的。目前在所有测试编译器中都可以工作,但如果用户希望与标准百分百兼容——标识符DOCTEST_CONFIG_USE_IOSFWD
应被使用以强制引入头文件
。默认不引入该头文件的原因是因为在MSVC中,它会移入一大堆东西,预处理器完成后,转化文件已经增长到42000行的C++代码,而Clang和libc则实现得非常好,引入头文件
只是不到400行代码。
版权声明:本文参照了《doctest项目的README》。未经作者允许,严禁用于商业出版,否则追究法律责任。网络转载请注明出处,这是对原创者的起码的尊重!!!