dash/src/test
Wladimir J. van der Laan 21e00e9050
Merge #9821: util: Specific GetOSRandom for Linux/FreeBSD/OpenBSD
7e6dcd9 random: Add fallback if getrandom syscall not available (Wladimir J. van der Laan)
7cad849 sanity: Move OS random to sanity check function (Wladimir J. van der Laan)
aa09ccb squashme: comment that NUM_OS_RANDOM_BYTES should not be changed lightly (Wladimir J. van der Laan)
224e6eb util: Specific GetOSRandom for Linux/FreeBSD/OpenBSD (Wladimir J. van der Laan)

Tree-SHA512: 9fd408b1316c69de86674f342339b2f89192fd317c8c036b5df4320f828fa263c7966146bfc1904c51137ee4a26e4cb0f560b2cd05e18cde4d808b9b92ad15c4
2019-01-22 22:57:09 -06:00
..
data Merge #9350: [Trivial] Adding label for amount inside of tx_valid/tx_invalid.json 2019-01-22 22:55:43 -06:00
addrman_tests.cpp A few devnet related fixes (#2168) 2018-07-08 00:19:33 +03:00
alert_tests.cpp Drop BOOST_FOREACH and use references in loops (const ref where applicable, Dash code only) (#1899) 2018-02-06 14:09:33 +03:00
allocator_tests.cpp Merge #9070: Lockedpool fixes 2018-01-13 13:44:39 +01:00
amount_tests.cpp Merge #7796: [amount] Add support for negative fee rates 2017-12-20 14:58:27 +01:00
arith_uint256_tests.cpp Merge #8673: Trivial: Fix obvious assignment/equality error in test 2018-01-09 14:16:39 +01:00
base32_tests.cpp
base58_tests.cpp Merge #9305: Refactor: Removed begin/end_ptr functions. 2018-01-17 17:31:12 +01:00
base64_tests.cpp
bctest.py Merge #10130: bitcoin-tx input verification (awemany, jnewbery) 2018-01-26 12:59:29 +01:00
bip32_tests.cpp Backports 0.15 pr2 (#2597) 2019-01-07 12:55:35 +03:00
bip39_tests.cpp Some cleanup (mostly trivial) (#2038) 2018-04-20 13:53:23 +03:00
bitcoin-util-test.py Merge #9508: Remove unused Python imports 2018-01-21 12:48:33 +01:00
blockencodings_tests.cpp Backport compact blocks functionality from bitcoin (#1966) 2018-04-11 14:06:01 +03:00
bloom_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
bswap_tests.cpp fixed protobuf 3.0 (byteswap) issue on macOS (#1370) 2017-02-28 13:00:02 +04:00
buildenv.py.in Merge #8270: Tests: Use portable #! in python scripts (/usr/bin/env) 2018-01-08 18:04:55 +01:00
cachemap_tests.cpp Various fixes and refactoring for Cache*Map classes (#1896) 2018-02-06 14:08:43 +03:00
cachemultimap_tests.cpp Various fixes and refactoring for Cache*Map classes (#1896) 2018-02-06 14:08:43 +03:00
checkqueue_tests.cpp Include test_dash.h instead of test_bitcoin.h 2018-01-26 12:59:29 +01:00
coins_tests.cpp Merge #9435: Removed unused variable in test, fixing warning. 2018-01-18 07:31:23 +01:00
compress_tests.cpp
crypto_tests.cpp Merge #9095: test: Fix test_random includes 2018-01-15 06:14:12 +01:00
cuckoocache_tests.cpp Merge #9610: [Trivial] Grammar and typo correction (laudaa) 2018-01-21 12:48:33 +01:00
dbwrapper_tests.cpp Merge #9867: Replace remaining sprintf with snprintf 2019-01-22 22:55:48 -06:00
DoS_tests.cpp Merge #9763: [Trivial] Update comments referencing main.cpp 2018-01-23 09:24:29 +01:00
evo_deterministicmns_tests.cpp Harden spork15 on testnet (#2586) 2018-12-28 19:13:44 +03:00
evo_simplifiedmns_tests.cpp Use proTxHash instead of outpoint when calculating masternode scores (#2440) 2018-11-13 15:24:14 +03:00
getarg_tests.cpp
governance_validators_tests.cpp Validate proposals for expiration (#2003) 2018-03-21 14:09:13 +03:00
hash_tests.cpp Backport compact blocks functionality from bitcoin (#1966) 2018-04-11 14:06:01 +03:00
key_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
limitedmap_tests.cpp Merge #9610: [Trivial] Grammar and typo correction (laudaa) 2018-01-21 12:48:33 +01:00
main_tests.cpp Some cleanup (mostly trivial) (#2038) 2018-04-20 13:53:23 +03:00
Makefile
mempool_tests.cpp Merge #7562: Bump transaction version default to 2 2018-01-20 09:22:38 +01:00
merkle_tests.cpp Merge #9125: Make CBlock a vector of shared_ptr of CTransactions 2018-01-15 06:14:16 +01:00
miner_tests.cpp manual fixes on #9868 2019-01-22 22:57:04 -06:00
multisig_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
net_tests.cpp Use override keyword for overriden class member functions (#1644) 2018-02-15 10:29:15 +03:00
netbase_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
pmt_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
policyestimator_tests.cpp Merge #9239: Disable fee estimates for 1 block target 2018-01-17 17:30:38 +01:00
pow_tests.cpp Add tests for special rules for slow blocks on devnet/testnet (#2176) 2018-07-09 12:42:11 +03:00
prevector_tests.cpp Merge #9349: Make CScript (and prevector) c++11 movable. 2018-01-18 07:31:23 +01:00
raii_event_tests.cpp Merge #9647: Skip RAII event tests if libevent is built without event_set_mem_functions 2018-01-23 09:24:26 +01:00
random_tests.cpp Merge #9821: util: Specific GetOSRandom for Linux/FreeBSD/OpenBSD 2019-01-22 22:57:09 -06:00
ratecheck_tests.cpp Remove remaining using namespace std 2018-02-21 22:32:13 +03:00
README.md Merge #9065: Merge doc/unit-tests.md into src/test/README.md 2018-01-13 13:44:39 +01:00
reverselock_tests.cpp c++11: don't throw from the reverselock destructor (#1421) 2017-04-11 13:55:41 +03:00
rpc_tests.cpp Remove all legacy/compatibility MN code (#2600) 2019-01-03 12:17:43 +03:00
sanity_tests.cpp
scheduler_tests.cpp Merge #9610: [Trivial] Grammar and typo correction (laudaa) 2018-01-21 12:48:33 +01:00
script_P2PK_tests.cpp Remove remaining using namespace std 2018-02-21 22:32:13 +03:00
script_P2PKH_tests.cpp Fix p2pkh tests asserts (#2153) 2018-06-29 01:23:25 +03:00
script_P2SH_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
script_tests.cpp Merge #8976: libconsensus: Add input validation of flags (#1891) 2018-02-05 18:42:05 +03:00
scriptnum10.h
scriptnum_tests.cpp Merge #9512: Fix various things -fsanitize complains about 2018-01-21 12:48:33 +01:00
serialize_tests.cpp Merge #9510: [trivial] Fix typos in comments 2018-01-21 12:48:34 +01:00
sighash_tests.cpp Only use version 1 and 2 transactions for sighash_tests (#2219) 2018-08-11 01:36:36 +03:00
sigopcount_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
skiplist_tests.cpp Merge #9490: Replace FindLatestBefore used by importmuti with FindEarliestAtLeast. 2018-01-21 12:48:32 +01:00
streams_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
subsidy_tests.cpp Add tests for GetBlockSubsidy algorithm (#2022) 2018-04-11 14:06:27 +03:00
test_dash.cpp Initialize g_connman before initializing the LLMQ system 2019-01-21 15:22:38 +01:00
test_dash.h Add unit tests for DIP3 and DIP4 2018-09-05 18:40:53 +02:00
test_random.h Merge #8914: Kill insecure_random and associated global state 2018-01-12 09:58:14 +01:00
testutil.cpp Backports 0.15 pr1 (#2590) 2019-01-03 12:18:47 +03:00
testutil.h Merge #7667: Move GetTempPath() to testutil 2017-12-19 12:55:49 +01:00
timedata_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
transaction_tests.cpp Remove remaining using namespace std 2018-02-21 22:32:13 +03:00
txvalidationcache_tests.cpp Remove leftover RBF code from BTC (#2297) 2018-09-20 15:39:34 +03:00
uint256_tests.cpp Merge #9039: Various serialization simplifcations and optimizations 2018-01-15 06:14:15 +01:00
univalue_tests.cpp Add univalue test for real numbers (#2460) 2018-11-22 06:09:58 +01:00
util_tests.cpp Merge #9281: Refactor: Remove using namespace <xxx> from bench/ & test/ sources 2018-01-18 07:33:44 +01:00
versionbits_tests.cpp Use override keyword for overriden class member functions (#1644) 2018-02-15 10:29:15 +03:00

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 dashd tests manually, launch src/test/test_dash.

To add more dashd 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 dash-qt tests manually, launch src/qt/test/test_dash-qt

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

Running individual tests

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

test_dash --log_level=all --run_test=getarg_tests

... or to run just the doubledash test:

test_dash --run_test=getarg_tests/doubledash

Run test_dash --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 Dash Core 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_dash that runs all of the unit tests. The main source file is called test_dash.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/.

bitcoin-util-test.py

The test directory also contains the bitcoin-util-test.py tool, which tests bitcoin utils (currently just dash-tx). This test gets run automatically during the make check build process. It is also possible to run the test manually from the src directory:

test/bitcoin-util-test.py --srcdir=[current directory]