#env #temp #directory #guard #drop #env-var

tmp_env

A crate which lets you create temporary environment and be automatically restored/cleaned when not needed

2 releases

0.1.1 Jun 16, 2021
0.1.0 Jun 9, 2021

#551 in Configuration

Download history 928/week @ 2024-03-14 613/week @ 2024-03-21 407/week @ 2024-03-28 332/week @ 2024-04-04 755/week @ 2024-04-11 357/week @ 2024-04-18 320/week @ 2024-04-25 300/week @ 2024-05-02 306/week @ 2024-05-09 351/week @ 2024-05-16 347/week @ 2024-05-23 242/week @ 2024-05-30 248/week @ 2024-06-06 880/week @ 2024-06-13 576/week @ 2024-06-20 290/week @ 2024-06-27

2,018 downloads per month
Used in 2 crates

Custom license

11KB
132 lines

tmp_env

Version Documentation

tmp_env is a crate which lets you create temporary environment and be automatically cleaned when not needed.

For example sometimes you need to change the current directory or set environment variables to launch a process but you don't need this temporary environment for the rest of your program. Then you will use tmp_env to create environment variable using tmp_env::set_var instead of std::env::set_var to get from tmp_env::set_var a datastructure which will automatically restore the corresponding environment variable when dropped.

Install

Put this dependency in your Cargo.toml

tmp_env = "0.1"

Usage

  • To temporary change the current directory:
{
    let _tmp_current_dir = tmp_env::set_current_dir("src").expect("should set the new current_dir");
    let current_dir = std::env::current_dir().expect("cannot get current dir from std env");
    assert!(current_dir.ends_with("src"));
}
let current_dir = std::env::current_dir().expect("cannot get current dir from std env");
assert!(!current_dir.ends_with("src"));
  • To temporary set an environment variable:
{
    let _tmp_env = tmp_env::set_var("TEST_TMP_ENV", "myvalue");
    assert_eq!(std::env::var("TEST_TMP_ENV"), Ok(String::from("myvalue")));
}
// Because guard `_tmp_env` is dropped then the environment variable is also automatically unset (not restored because no previous value was set)
assert!(std::env::var("TEST_TMP_ENV").is_err());
  • To temporary create a directory
{
    let tmp_dir = tmp_env::create_temp_dir().expect("cannot create temp dir"); // When tmp_dir is dropped this temporary dir will be removed
    assert!(std::fs::metadata(&*tmp_dir).is_ok());
}
// The temporary directory is now removed

Dependencies

~310KB