Sphinx
A Sphinx packet implementation in Rust.
Prerequisites
- rust (stable) : https://www.rust-lang.org/
- docker (for code coverage reports): https://www.docker.com/
Testing
cargo test
will run the unit and integration tests.
Code coverage reporting
If you want to find out how you're doing in terms of code coverage, install docker and then run the code coverage shell script at ./scripts/coverage_report.sh
. Docker will download all the dependencies (get a coffee!), and output an HTML code coverage report at coverage/tarpaulin-report.html
. Open the generated file in your browser to check coverage.
Unit + integration test coverage is currently well above 90%, please ensure that any pull requests maintain good test coverage.
Benchmarks
To run benchmarks, use:
cargo bench
Rust benchmarks run the operation multiple times to give a consistent output and report back in the number of nanoseconds (billionths of a second) per iteration. 1000000000 / result
gives you the number of operations per second.
For later reference, on Dave's i7 Dell XPS-13 (2018) laptop (our test reference machine :)) output is as follows.
test tests::bench_new ... bench: 386.348 us/iter
test tests::bench_process ... bench: 157.322 us/iter
1000000 / 386.348
= ~2588 packet creations per second1000000 / 157.322
= ~6356 packet unwrappings per second