Skip to content

lxl66566/windows-env

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

windows-env

Easily manage Windows environment variables permanently, without the need to restart your system. (but terminal restart is required)

Features:

  • Easily operate list variables like PATH.

Installation

  • as lib:
    [target."cfg(windows)".dependencies]
    windows_env = "0.2.0"
  • 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

  • binary usage: runs wenv -h to see help message.

  • 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(())
    }
    • using windows-env as a lib will affect the current process, so you can use the new env by spawning processes after modifying env in rust code.

Compare

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

TODO

  • cli support
  • System env modification

MSRV

  • v0.1.1: 1.70

About

Easily manage Windows environment variables permanently.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages