基本情况
使用语言为Python,通过如下文件执行
test/functional/test_runner.py |
单元测试源代码的目录为:
/src/test/ |
Boost 包含了一个测试框架,Bitcoin Core也使用Boost ,使用这个框架开展测试就是最好的选择。
所有的测试都被编译为test_bitcoin ,它的源代码在:
util/setup_common.cpp |
编译和运行单元测试
如果没有在./configure中关闭测试选项,默认所有的测试将被编译。
编译之后,能够通过如下命令运行:
make check |
为了运行单元测试,需要载入:
src/test/test_bitcoin |
如果测试文件被修改,需要再次运行make。
如果修改的不是测试文件,需要运行如下命令:
make -C src/test |
如果需要增加新的单元测试项目,可以在已存在的文件中增加BOOST_AUTO_TEST_CASE 函数,或则在test目录中增加实现了BOOST_AUTO_TEST_SUITE 的新文件。
运行界面相关的测试请载入:
src/qt/test/test_bitcoin-qt |
界面相关目录为:
src/qt/test/ |
界面相关文件为:
src/qt/test/test_main.cpp |
运行单个测试
例如运行getarg_tests:
test_bitcoin --log_level=all --run_test=getarg_tests -- DEBUG_LOG_OUT |
log_level决定日志的详细程度,DEBUG_LOG_OUT是生成日志到文件的意思,日志默认生成的路径在:
BasicTestingSetup::m_path_root |
如果想直接在屏幕输出则可以运行:(以doubledash为例)
test_bitcoin --run_test=getarg_tests/doubledash |
更多的功能请运行:
test_bitcoin --help |
增加测试用例
增加新的测试文件和套件需要把文件添加到src/Makefile.test.include中,
这个模式是针对每个测试创建一个测试文件或测试类,文件名格式如下:
|
测试套件的文件夹名称如下:
|
例如:uint256_tests.cpp
在单元测试中记录和调试
make check 命令将生成foo_tests.cpp.log文件,同时发现的错误会实时的显示出来。
对于每个单元测试的级别,请看上面的介绍。
为了将测试中的信息存储到日志中,你需要使用Boost提供的消息传递方式,最简单的是BOOST_TEST_MESSAGE。
调试你可以使用gdb或lldb 来启动test_bitcoin ,例如:
gdb src/test/test_bitcoin |
本文内容不用于商业目的,如涉及知识产权问题,请权利人联系51Testing小编(021-64471599-8017),我们将立即处理