History

Jeff Garzik 7f836c66bd rpc_tests: use BOOST_CHECK_EQUAL Upon failure, BOOST_CHECK_EQUAL provides additional diagnostic information, displaying that data that failed to match.		2014-08-20 22:43:36 -04:00
..
data	bitcoin-tx: Accept input via stdin. Add input handling to tests.	2014-08-19 10:29:10 -04:00
accounting_tests.cpp	Add CMutableTransaction and make CTransaction immutable.	2014-06-21 22:59:03 +02:00
alert_tests.cpp
allocator_tests.cpp
base32_tests.cpp
base58_tests.cpp	Remove unnecessary dependencies for bitcoin-cli	2014-06-25 10:31:35 +02:00
base64_tests.cpp
bctest.py	bitcoin-tx: Accept input via stdin. Add input handling to tests.	2014-08-19 10:29:10 -04:00
bignum.h	Fix build in OS X 10.9	2014-05-13 01:39:42 -03:00
bip32_tests.cpp
bitcoin-util-test.py	Add "it works" test for bitcoin-tx	2014-08-19 10:28:58 -04:00
bloom_tests.cpp	CBloomFilter::clear() method	2014-07-21 11:50:07 -07:00
canonical_tests.cpp	move rand functions from util to new random.h/.cpp	2014-07-09 09:42:19 +02:00
checkblock_tests.cpp
Checkpoints_tests.cpp
compress_tests.cpp
crypto_tests.cpp	move rand functions from util to new random.h/.cpp	2014-07-09 09:42:19 +02:00
DoS_tests.cpp	Remove timing-based signature cache unit test	2014-06-25 14:57:21 -04:00
getarg_tests.cpp
hash_tests.cpp
key_tests.cpp
main_tests.cpp
Makefile	build: add stub makefiles for easier subdir builds	2014-06-05 16:05:43 -04:00
miner_tests.cpp	Add CMutableTransaction and make CTransaction immutable.	2014-06-21 22:59:03 +02:00
mruset_tests.cpp	move rand functions from util to new random.h/.cpp	2014-07-09 09:42:19 +02:00
multisig_tests.cpp	Declare SignatureHash() in script.h	2014-08-01 17:45:09 +02:00
netbase_tests.cpp	net: Add CSubNet class for subnet matching	2014-05-09 16:45:57 +02:00
pmt_tests.cpp	Add CMutableTransaction and make CTransaction immutable.	2014-06-21 22:59:03 +02:00
README.md
rpc_tests.cpp	rpc_tests: use BOOST_CHECK_EQUAL	2014-08-20 22:43:36 -04:00
rpc_wallet_tests.cpp	Merge pull request #3837	2014-06-02 18:00:37 +02:00
script_P2SH_tests.cpp	Declare SignatureHash() in script.h	2014-08-01 17:45:09 +02:00
script_tests.cpp	Declare SignatureHash() in script.h	2014-08-01 17:45:09 +02:00
scriptnum_tests.cpp
serialize_tests.cpp
sighash_tests.cpp	Declare SignatureHash() in script.h	2014-08-01 17:45:09 +02:00
sigopcount_tests.cpp
skiplist_tests.cpp	move rand functions from util to new random.h/.cpp	2014-07-09 09:42:19 +02:00
test_bitcoin.cpp	move rand functions from util to new random.h/.cpp	2014-07-09 09:42:19 +02:00
transaction_tests.cpp	Move ParseScript() helper, becoming accessible outside src/test/	2014-07-29 11:13:27 -04:00
uint256_tests.cpp	Move {Get,Set}Compact from bignum to uint256	2014-05-09 16:44:59 +02:00
util_tests.cpp	move rand functions from util to new random.h/.cpp	2014-07-09 09:42:19 +02:00
wallet_tests.cpp	Add support for watch-only addresses	2014-07-02 15:48:37 +02:00

README.md

Notes

The sources in this directory are unit test cases. Boost includes a unit testing framework, and since bitcoin already uses boost, it makes sense to simply use this framework rather than require developers to configure some other framework (we want as few impediments to creating unit tests as possible).

The build system is setup to compile an executable called "test_bitcoin" that runs all of the unit tests. The main source file is called test_bitcoin.cpp, which simply includes other files that contain the actual unit tests (outside of a couple required preprocessor directives). The pattern is to create one test file for each class or source file for which you want to create unit tests. The file naming convention is "<source_filename>_tests.cpp" and such files should wrap their tests in a test suite called "<source_filename>_tests". For an examples of this pattern, examine uint160_tests.cpp and uint256_tests.cpp.

For further reading, I found the following website to be helpful in explaining how the boost unit test framework works: http://www.alittlemadness.com/2009/03/31/c-unit-testing-with-boosttest/.