4 hours, on-site or remote
Testing in Rust: an introduction
Rust's type system is great, but it's not enough on its own to ensure correctness: a solid testing strategy is a requirement for any serious Rust application.
The workshop will build up your Rust's testing toolkit. We will start from scratch, with your first unit test. By the end, you will have a comprehensive understanding of the available test types, the best practices in terms of test organization as well as their runtime implications. You will be well equipped for the testing challenges ahead of you!
The workshop is designed for software developers who are just starting their Rust journey.
If you've been working with Rust for a while, you might be interested instead in our advanced testing workshop.
anchorWorkshop overview
Writing your first unit test
Straight into the action: the
#[test]annotation and basic assertions! We will wire everything up and get our feedback loop going.Testing failures
Unhappy scenarios are often more important than the happy ones! We will discuss the
#[should_panic]annotation as well as the tradeoffs of returning aResultfrom your tests.The Rust testing zoo
Unit tests are just of the test approaches offered by Rust's built-in testing framework—we have integration and doc tests too. We will look at each category and build a mental framework for choosing the correct testing technique in each context.
Running your tests
What is a test? We will take a look under the hood to understand how the Rust built-in testing framework is actually implemented. Armed with this knowledge, we will explore the runtime implications of different approaches for test organisation. We will also cover alternative test runners, such as
cargo-nextest.Test helpers: where do they go?
Test code is just as important as production code: you want it to be terse and clearly communicate what is being tested. If you follow this philosophy, you'll soon be trying to extract common logic into test helpers: where should they be located? We will cover the different strategies available (test modules, feature gate, helper crate) and their trade-offs.
Beyond assertions
In closing, we will have a look at a few advanced techniques beyond the standard toolkit: snapshot testing (
insta) and property-based testing (quickcheck).
