1 unstable release

0.1.0 Feb 6, 2023

#302 in Testing

Download history 51/week @ 2023-12-04 25/week @ 2023-12-11 21/week @ 2023-12-18 13/week @ 2024-01-01 18/week @ 2024-01-08 108/week @ 2024-01-15 71/week @ 2024-01-22 68/week @ 2024-01-29 16/week @ 2024-02-05 58/week @ 2024-02-12 125/week @ 2024-02-19 101/week @ 2024-02-26 88/week @ 2024-03-04 133/week @ 2024-03-11 13/week @ 2024-03-18

336 downloads per month


193 lines



A wrapper around the standard std::env functions that allows for a test double to be injected during testing.


At this time, this crate only works for Unix-like systems.


Testing code that relies on the state of environment variables can be fragile, since the state may change between tests or be polluted by other tests. The ideal solution is to have a private set of environment variables per test, so these problems cannot happen.


This crate introduces the RealEnvironment (a wrapper around the functions in std::env) and FakeEnvironment structs, which implement the Environment trait. Instead of using std::env directly, use RealEnvironment with dependency injection so each of your tests can have a private set of environment variables.


Scenario: An app looks for the presence of the CONFIG_LOCATION environment variable. If it isn't set, it uses a default location.

use env_wrapper::{Environment, RealEnvironment};

const DEFAULT_CONFIG_LOCATION: &str = "/etc/my_app/service.conf";

fn main() {
    // In the production code, inject RealEnvironment.
    let real_env = RealEnvironment;
    let config_location = get_config_location(real_env);

fn get_config_location(env: impl Environment) -> String {
    match env.var(CONFIG_LOCATION_ENV_VAR_NAME) {
        Ok(location) => location,
        _ => DEFAULT_CONFIG_LOCATION.to_string(),

fn when_the_user_has_set_the_config_location_env_var_then_use_that_location() {
    use env_wrapper::FakeEnvironment;

    // Arrange
    // Each test should have a separate instance of FakeEnvironment.
    let mut fake_env = FakeEnvironment::new();
    let user_specified_location = "/a/user/specified/location";
    fake_env.set_var(CONFIG_LOCATION_ENV_VAR_NAME, user_specified_location);
    // Act
    // In the test code, inject FakeEnvironment.
    let location = get_config_location(fake_env);

    // Assert
    assert_eq!(location, user_specified_location);


Licensed under either of

at your option.


Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Code of Conduct

All behavior is governed by the Rust Code of Conduct.

No runtime deps