# 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:
  ```toml
  [target."cfg(windows)".dependencies]
  windows_env = "0.1.1"
  ```
- as executable binary:
  ```sh
  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:

```rs
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

- [x] cli support
- [ ] System env modification