History

Riccardo Spagni f0b3bbf808 Merge pull request #4459 `bcf3f6af` fuzz_tests: catch unhandled exceptions (moneromooo-monero) `3ebd05d4` miner: restore stream flags after changing them (moneromooo-monero) `a093092e` levin_protocol_handler_async: do not propagate exception through dtor (moneromooo-monero) `1eebb82b` net_helper: do not propagate exceptions through dtor (moneromooo-monero) `fb6a3630` miner: do not propagate exceptions through dtor (moneromooo-monero) `2e2139ff` epee: do not propagate exception through dtor (moneromooo-monero) `0749a8bd` db_lmdb: do not propagate exceptions in dtor (moneromooo-monero) `1b0afeeb` wallet_rpc_server: exit cleanly on unhandled exceptions (moneromooo-monero) `418a9936` unit_tests: catch unhandled exceptions (moneromooo-monero) `ea7f9543` threadpool: do not propagate exceptions through the dtor (moneromooo-monero) `6e855422` gen_multisig: nice exit on unhandled exception (moneromooo-monero) `53df2deb` db_lmdb: catch error in mdb_stat calls during migration (moneromooo-monero) `e67016dd` blockchain_blackball: catch failure to commit db transaction (moneromooo-monero) `661439f4` mlog: don't remove old logs if we failed to rename the current file (moneromooo-monero) `5fdcda50` easylogging++: test for NULL before dereference (moneromooo-monero) `7ece1550` performance_test: fix bad last argument calling add_arg (moneromooo-monero) `a085da32` unit_tests: add check for page size > 0 before dividing (moneromooo-monero) `d8b1ec8b` unit_tests: use std::shared_ptr to shut coverity up about leaks (moneromooo-monero) `02563bf4` simplewallet: top level exception catcher to print nicer messages (moneromooo-monero) `c57a65b2` blockchain_blackball: fix shift range for 32 bit archs (moneromooo-monero)		2018-09-29 22:17:00 +02:00
..
core_proxy	replace std::list with std::vector on some hot paths	2018-06-26 22:14:21 +01:00
core_tests	core_tests: add a test for 4-aggregated BP verification	2018-09-11 13:38:22 +00:00
crypto	fixed cncrypto tests not passing after the change in random_scalar	2018-08-07 15:58:40 +10:00
daemon_tests	Update 2018 copyright	2018-01-26 10:03:20 -05:00
data	tests: update test wallet keys file for encrypted keys	2018-09-15 09:34:11 +00:00
difficulty	Fix missing std::runtime_error def in difficulty.cpp	2018-09-16 19:35:07 +00:00
functional_tests	api/wallet: properly disable key encryption	2018-09-17 22:15:29 +09:00
fuzz	fuzz_tests: catch unhandled exceptions	2018-09-27 18:23:24 +00:00
gtest	gtest: use -fPIC with CLANG too	2018-06-28 16:42:52 +01:00
hash	cryptonote tweak v2.2	2018-09-22 03:47:50 +00:00
libwallet_api_tests	Fix typos in various files	2018-03-15 18:25:38 +02:00
net_load_tests	Fix typos in various files	2018-03-15 18:25:38 +02:00
performance_tests	performance_test: fix bad last argument calling add_arg	2018-09-27 12:53:12 +00:00
unit_tests	Merge pull request #4459	2018-09-29 22:17:00 +02:00
CMakeLists.txt	Update 2018 copyright	2018-01-26 10:03:20 -05:00
README.md	first new functional tests	2018-06-29 10:06:22 +02:00
cryptolib.pl	Update 2018 copyright	2018-01-26 10:03:20 -05:00
cryptotest.pl	Update 2018 copyright	2018-01-26 10:03:20 -05:00
hash-target.cpp	Update 2018 copyright	2018-01-26 10:03:20 -05:00
io.h	Update 2018 copyright	2018-01-26 10:03:20 -05:00

README.md

Running all tests

To run all tests, run:

cd /path/to/monero
make [-jn] debug-test # where n is number of compiler processes

To test a release build, replace debug-test with release-test in the previous command.

Core tests

Core tests take longer than any other Monero tests, due to the high amount of computational work involved in validating core components.

Tests are located in tests/core_tests/, and follow a straightforward naming convention. Most cases cover core functionality (block_reward.cpp, chaingen.cpp, rct.cpp, etc.), while some cover basic security tests (double_spend.cpp & integer_overflow.cpp).

To run only Monero's core tests (after building):

cd build/debug/tests/core
ctest

To run the same tests on a release build, replace debug with release.

Crypto Tests

Crypto tests are located under the tests/crypto directory.

crypto-tests.h contains test harness headers
main.cpp implements the driver for the crypto tests

Tests correspond to components under src/crypto/. A quick comparison reveals the pattern, and new tests should continue the naming convention.

To run only Monero's crypto tests (after building):

cd build/debug/tests/crypto
ctest

To run the same tests on a release build, replace debug with release.

Daemon tests

[TODO]

Functional tests

[TODO] Functional tests are located under the tests/functional directory.

First, run a regtest daemon in the offline mode and with a fixed difficulty:

monerod --regtest --offline --fixed-difficulty 1

Alternatively, you can run multiple daemons and let them connect with each other by using --add-exclusive-node. In this case, make sure that the same fixed difficulty is given to all the daemons.

Next, restore a mainnet wallet with the following seed and restore height 0 (the file path doesn't matter):

velvet lymph giddy number token physics poetry unquoted nibs useful sabotage limits benches lifestyle eden nitrogen anvil fewest avoid batch vials washing fences goat unquoted

Open the wallet file with monero-wallet-rpc with RPC port 18083. Finally, start tests by invoking ./blockchain.py or ./speed.py

Fuzz tests

Fuzz tests are written using American Fuzzy Lop (AFL), and located under the tests/fuzz directory.

An additional helper utility is provided contrib/fuzz_testing/fuzz.sh. AFL must be installed, and some additional setup may be necessary for the script to run properly.

Hash tests

Hash tests exist under tests/hash, and include a set of target hashes in text files.

To run only Monero's hash tests (after building):

cd build/debug/tests/hash
ctest

To run the same tests on a release build, replace debug with release.

Libwallet API tests

[TODO]

Net Load tests

[TODO]

Performance tests

Performance tests are located in tests/performance_tests, and test features for performance metrics on the host machine.

To run only Monero's performance tests (after building):

cd build/debug/tests/performance_tests
./performance_tests

If the performance_tests binary does not exist, try running make in the build/debug/tests/performance_tests directory.

To run the same tests on a release build, replace debug with release.

Unit tests

Unit tests are defined under the tests/unit_tests directory. Independent components are tested individually to ensure they work properly on their own.

To run only Monero's unit tests (after building):

cd build/debug/tests/unit_tests
ctest

To run the same tests on a release build, replace debug with release.

Writing new tests

Test hygiene

When writing new tests, please implement all functions in .cpp or .c files, and only put function headers in .h files. This will help keep the fairly complex test suites somewhat sane going forward.

Writing fuzz tests

[TODO]