1 unstable release
0.1.0 | Sep 11, 2024 |
---|
#308 in Testing
34KB
366 lines
Sham
/ʃam/
noun - a thing that is not what it is purported to be.
adjective - not genuine; fake or false.
verb - falsely present something as the truth.
Sham is a collection of useful mocks and fakes for testing Rust code. The primary purpose is to be able to swap out a genuine implementation and substitute it with a sham one, in order to achieve deterministic testing without side effects.
This is particularly useful for testing code that usually performs a particular operation that is either expensive, slow, or has side effects that are undesirable in a test environment, such as sending network requests. In these cases, a sham implementation can be used to simulate the real one, without actually performing the operation.
The modules provided are:
Note, each module is behind a feature flag, in order to keep the crate size down for those who don't need all the functionality.
reqwest
The reqwest
module
provides mocks for the Reqwest crate, which is a
popular HTTP client for Rust.
std_process
The std_process
module provides mocks for the Rust standard library's process module,
mainly and most notably Command
.
Dependencies
~0–10MB
~106K SLoC