Bitcoin的单元测试

lsekfe

基本情况
　　使用语言为Python，通过如下文件执行

1. test/functional/test_runner.py

复制代码

单元测试源代码的目录为：

1. /src/test/

复制代码

Boost 包含了一个测试框架，Bitcoin Core也使用Boost ，使用这个框架开展测试就是最好的选择。
　　所有的测试都被编译为test_bitcoin ，它的源代码在：

1. 　　util/setup_common.cpp
   

复制代码

编译和运行单元测试
　　如果没有在./configure中关闭测试选项，默认所有的测试将被编译。
　　编译之后，能够通过如下命令运行：

1. 　　make check
   

复制代码

为了运行单元测试，需要载入：

1. 　　src/test/test_bitcoin
   

复制代码

如果测试文件被修改，需要再次运行make。
　　如果修改的不是测试文件，需要运行如下命令：

1. 　　make -C src/test
   

复制代码

如果需要增加新的单元测试项目，可以在已存在的文件中增加BOOST_AUTO_TEST_CASE 函数，或则在test目录中增加实现了BOOST_AUTO_TEST_SUITE 的新文件。
　　运行界面相关的测试请载入：

1. 　　src/qt/test/test_bitcoin-qt
   

复制代码

　　界面相关目录为：

1. 　　src/qt/test/
   

复制代码

　　界面相关文件为：

1. 　　src/qt/test/test_main.cpp
   

复制代码

运行单个测试
　　例如运行getarg_tests：

1. 　　test_bitcoin --log_level=all --run_test=getarg_tests -- DEBUG_LOG_OUT
   

复制代码

log_level决定日志的详细程度，DEBUG_LOG_OUT是生成日志到文件的意思，日志默认生成的路径在：

1. 　　BasicTestingSetup::m_path_root
   

复制代码

　　如果想直接在屏幕输出则可以运行：（以doubledash为例）

1. 　　test_bitcoin --run_test=getarg_tests/doubledash
   

复制代码

　　更多的功能请运行：

1. 　　test_bitcoin --help
   

复制代码

增加测试用例
　　增加新的测试文件和套件需要把文件添加到src/Makefile.test.include中，
　　这个模式是针对每个测试创建一个测试文件或测试类，文件名格式如下：

1. _tests.cpp

复制代码

测试套件的文件夹名称如下：

1. 　　_tests
   

复制代码

例如：uint256_tests.cpp
　　在单元测试中记录和调试
　　make check 命令将生成foo_tests.cpp.log文件，同时发现的错误会实时的显示出来。
　　对于每个单元测试的级别，请看上面的介绍。
　　为了将测试中的信息存储到日志中，你需要使用Boost提供的消息传递方式，最简单的是BOOST_TEST_MESSAGE。
　　调试你可以使用gdb或lldb 来启动test_bitcoin ，例如：

1. 　　gdb src/test/test_bitcoin
   

复制代码