History

Riccardo Spagni 2b00899bb2 Merge pull request #2920 `bd5cce07` network_throttle: fix ineffective locking (moneromooo-monero) `e0a61299` network_throttle: remove unused xxx static member (moneromooo-monero) `24f584d9` cryptonote_core: remove unused functions with off by one bugs (moneromooo-monero) `b1634aa3` blockchain: don't leave dangling pointers in this (moneromooo-monero) `8e60b81c` cryptonote_core: fix db leak on error (moneromooo-monero) `213e326c` abstract_tcp_server2: log init_server errors as fatal (moneromooo-monero) `b51dc566` use const refs in for loops for non tiny types (moneromooo-monero) `f0568ca6` net_parse_helpers: fix regex error checking (moneromooo-monero) `b49ddc76` check accessing an element past the end of a container (moneromooo-monero) `2305bf26` check return value for generate_key_derivation and derive_public_key (moneromooo-monero) `a4240d9f` catch const exceptions (moneromooo-monero) `45a1c4c0` add empty container sanity checks when using front() and back() (moneromooo-monero) `56fa6ce1` tests: fix a buffer overread in a unit test (moneromooo-monero) `b4524892` rpc: guard against json parsing a non object (moneromooo-monero) `c2ed8618` easylogging++: avoid buffer underflow (moneromooo-monero) `187a6ab2` epee: trap failure to parse URI from request (moneromooo-monero) `061789b5` checkpoints: trap failure to load JSON checkpoints (moneromooo-monero) `ba2fefb9` checkpoints: pass std::string by const ref, not const value (moneromooo-monero) `38c8f4e0` mlog: terminate a string at last char, just in case (moneromooo-monero) `d753d716` fix a few leaks by throwing objects, not newed pointers to objects (moneromooo-monero) `fe568db8` p2p: use size_t for arbitrary counters instead of uint8_t (moneromooo-monero) `46d6fa35` cryptonote_protocol: sanity check chain hashes from peer (moneromooo-monero) `25584f86` cryptonote_protocol: print peer versions when unexpected (moneromooo-monero) `490a5d41` rpc: do not try to use an invalid txid in relay_tx (moneromooo-monero)		2017-12-25 21:17:52 +02:00
..
core_proxy	cryptonote_core does not depend on p2p anymore	2017-12-16 23:28:38 +00:00
core_tests	core_tests: multisig test now tests multiple inputs	2017-12-17 16:12:47 +00:00
crypto	Scrub keys from memory just before scope end.	2017-12-16 15:40:33 -07:00
daemon_tests	changed crypto to cncrypto so it generated libcncrypto	2017-05-23 07:45:40 -04:00
data	tests: add levin fuzz test	2017-12-23 11:29:55 +00:00
difficulty	update copyright year, fix occasional lack of newline at line end	2017-02-21 19:38:18 +02:00
functional_tests	move includes around to lessen overall load	2017-12-16 22:46:38 +00:00
fuzz	tests: add levin fuzz test	2017-12-23 11:29:55 +00:00
gtest	updated gtest (added missing files)	2016-01-25 21:19:57 +02:00
hash	changed crypto to cncrypto so it generated libcncrypto	2017-05-23 07:45:40 -04:00
libwallet_api_tests	split wallet and wallet_api	2017-11-16 12:10:29 +00:00
net_load_tests	Merge pull request #2696	2017-11-14 15:13:44 +02:00
performance_tests	move includes around to lessen overall load	2017-12-16 22:46:38 +00:00
unit_tests	Merge pull request #2920	2017-12-25 21:17:52 +02:00
CMakeLists.txt	tests: disable libwallet_api_tests when BUILD_GUI_DEPS is not set	2017-11-26 08:25:42 +00:00
README.md	Edited test readme for accuracy and depth	2017-10-01 12:11:59 -06:00
cryptolib.pl	update copyright year, fix occasional lack of newline at line end	2017-02-21 19:38:18 +02:00
cryptotest.pl	update copyright year, fix occasional lack of newline at line end	2017-02-21 19:38:18 +02:00
hash-target.cpp	update copyright year, fix occasional lack of newline at line end	2017-02-21 19:38:18 +02:00
io.h	update copyright year, fix occasional lack of newline at line end	2017-02-21 19:38:18 +02: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]

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]