windows-env 0.1.1

Easily manage Windows environment variables permanently.
docs.rs failed to build windows-env-0.1.1
Please check the build logs for more information.
See Builds for ideas on how to fix a failed build, or Metadata for how to configure docs.rs builds.
If you believe this is docs.rs' fault, open an issue.

windows-env

Easily manage Windows environment variables permanently, without the need to restart your system.

Features:

  • Concurrent safe.
  • Easily operate list variables like PATH.

Note:

  • The env operation will not affect the current terminal.

Installation

  • as lib: 
    [target."cfg(windows)".dependencies]

windows_env = "0.1.1"
  • as executable binary: 
    cargo binstall windows-env        # see cargo-binstall: https://github.com/cargo-bins/cargo-binstall

cargo install windows-env -F bin  # or compile from source manually

Example

lib usage:

fn main() -> std::io::Result<()> {
    windows_env::set("TEST_ENV", "test")?;
    assert_eq!(windows_env::get("TEST_ENV")?.unwrap(), "test");
    windows_env::remove("TEST_ENV")?;
    assert!(windows_env::get("TEST_ENV")?.is_none());

    windows_env::append("TEST_ENV", "test1")?;
    windows_env::prepend("TEST_ENV", "test2")?;
    assert_eq!(windows_env::get("TEST_ENV")?.unwrap(), "test2;test1");

    windows_env::remove_from_list("TEST_ENV", "test2")?;
    assert!(windows_env::exists_in_list("TEST_ENV", "test1")?);

    windows_env::remove("TEST_ENV")?;
    Ok(())
}

executable binary: runs wenv -h to see help message.

Compare

  • set_env:
    • it uses powershell script while this crate uses windows api

TODO

  • cli support
  • System env modification