bitcoin/src/test
danra 946638d0a0 Improve versionbits_computeblockversion test code consistency
In this test, `nTime` is used for all the calls to `Mine()`, each time being set to the correct time beforehand, except for in the last few calls to `Mine()` where `nStartTime` is used directly, even though `nTime` is still set to `nStartTime` beforehand. `nTime` just remains unused for these last few calls to `Mine()`.

Changed the last few calls to `Mine()` to use `nTime` instead, improving consistency. This also fixes an unused value static analyzer warning about `nTime` being set to a value which is never used.
2017-08-28 00:03:18 +03:00
..
data Merge #10679: Document the non-DER-conformance of one test in tx_valid.json. 2017-08-23 12:15:10 +02:00
DoS_tests.cpp scripted-diff: stop using the gArgs wrappers 2017-08-14 17:02:10 +02:00
Makefile
README.md
addrman_tests.cpp Add recommendation: By default, declare single-argument constructors `explicit` 2017-08-22 22:55:19 +02:00
allocator_tests.cpp Use the override specifier (C++11) where we expect to be overriding the virtual function of a base class 2017-06-28 02:12:06 +02:00
amount_tests.cpp
arith_uint256_tests.cpp Fixed multiple typos 2017-06-22 19:18:10 +03:00
base32_tests.cpp
base58_tests.cpp Declare single-argument (non-converting) constructors "explicit" 2017-08-16 16:33:25 +02:00
base64_tests.cpp
bip32_tests.cpp Declare single-argument (non-converting) constructors "explicit" 2017-08-16 16:33:25 +02:00
blockencodings_tests.cpp Declare single-argument (non-converting) constructors "explicit" 2017-08-16 16:33:25 +02:00
bloom_tests.cpp
bswap_tests.cpp
checkqueue_tests.cpp Merge #10521: Limit variable scope 2017-06-09 13:09:24 -07:00
coins_tests.cpp Declare single-argument (non-converting) constructors "explicit" 2017-08-16 16:33:25 +02:00
compress_tests.cpp
crypto_tests.cpp
cuckoocache_tests.cpp
dbwrapper_tests.cpp Declare single-argument (non-converting) constructors "explicit" 2017-08-16 16:33:25 +02:00
getarg_tests.cpp scripted-diff: stop using the gArgs wrappers 2017-08-14 17:02:10 +02:00
hash_tests.cpp
key_tests.cpp
limitedmap_tests.cpp
main_tests.cpp
mempool_tests.cpp
merkle_tests.cpp
miner_tests.cpp scripted-diff: Use the C++11 keyword nullptr to denote the pointer literal instead of the macro NULL 2017-08-07 07:36:37 +02:00
multisig_tests.cpp scripted-diff: Use the C++11 keyword nullptr to denote the pointer literal instead of the macro NULL 2017-08-07 07:36:37 +02:00
net_tests.cpp scripted-diff: stop using the gArgs wrappers 2017-08-14 17:02:10 +02:00
netbase_tests.cpp [refactor] move SplitHostPort() into utilstrencodings 2017-07-12 17:06:15 -04:00
pmt_tests.cpp
policyestimator_tests.cpp Remove checking of mempool min fee from estimateSmartFee. 2017-07-14 23:41:40 -04:00
pow_tests.cpp scripted-diff: Use the C++11 keyword nullptr to denote the pointer literal instead of the macro NULL 2017-08-07 07:36:37 +02:00
prevector_tests.cpp Add const to methods that do not modify the object for which it is called 2017-07-25 13:46:52 +02:00
raii_event_tests.cpp scripted-diff: Use the C++11 keyword nullptr to denote the pointer literal instead of the macro NULL 2017-08-07 07:36:37 +02:00
random_tests.cpp
reverselock_tests.cpp
rpc_tests.cpp rpc: Move ValueFromAmount to core_write 2017-08-07 17:01:21 +02:00
sanity_tests.cpp
scheduler_tests.cpp
script_P2SH_tests.cpp scripted-diff: Use the C++11 keyword nullptr to denote the pointer literal instead of the macro NULL 2017-08-07 07:36:37 +02:00
script_tests.cpp Merge #9964: Add const to methods that do not modify the object for which it is called 2017-08-16 02:09:49 +02:00
scriptnum10.h
scriptnum_tests.cpp
serialize_tests.cpp
sighash_tests.cpp
sigopcount_tests.cpp Remove confusing MAX_BLOCK_BASE_SIZE. 2017-07-14 19:24:17 +00:00
skiplist_tests.cpp scripted-diff: Use the C++11 keyword nullptr to denote the pointer literal instead of the macro NULL 2017-08-07 07:36:37 +02:00
streams_tests.cpp
test_bitcoin.cpp scripted-diff: stop using the gArgs wrappers 2017-08-14 17:02:10 +02:00
test_bitcoin.h Declare single-argument (non-converting) constructors "explicit" 2017-08-16 16:33:25 +02:00
test_bitcoin_fuzzy.cpp
test_bitcoin_main.cpp Add attribute [[noreturn]] (C++11) to functions that will not return 2017-07-17 18:46:18 +02:00
testutil.cpp
testutil.h
timedata_tests.cpp
torcontrol_tests.cpp
transaction_tests.cpp Remove factor of 3 from definition of dust. 2017-07-17 07:10:03 -04:00
txvalidationcache_tests.cpp scripted-diff: Use the C++11 keyword nullptr to denote the pointer literal instead of the macro NULL 2017-08-07 07:36:37 +02:00
uint256_tests.cpp
univalue_tests.cpp
util_tests.cpp scripted-diff: Use the C++11 keyword nullptr to denote the pointer literal instead of the macro NULL 2017-08-07 07:36:37 +02:00
versionbits_tests.cpp Improve versionbits_computeblockversion test code consistency 2017-08-28 00:03:18 +03:00

README.md

Compiling/running unit tests

Unit tests will be automatically compiled if dependencies were met in ./configure and tests weren't explicitly disabled.

After configuring, they can be run with make check.

To run the bitcoind tests manually, launch src/test/test_bitcoin.

To add more bitcoind tests, add BOOST_AUTO_TEST_CASE functions to the existing .cpp files in the test/ directory or add new .cpp files that implement new BOOST_AUTO_TEST_SUITE sections.

To run the bitcoin-qt tests manually, launch src/qt/test/test_bitcoin-qt

To add more bitcoin-qt tests, add them to the src/qt/test/ directory and the src/qt/test/test_main.cpp file.

Running individual tests

test_bitcoin has some built-in command-line arguments; for example, to run just the getarg_tests verbosely:

test_bitcoin --log_level=all --run_test=getarg_tests

... or to run just the doubledash test:

test_bitcoin --run_test=getarg_tests/doubledash

Run test_bitcoin --help for the full list.

Note on adding test cases

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. To add a new unit test file to our test suite you need to add the file to src/Makefile.test.include. 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 example of this pattern, examine 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/.