elevated-command 1.1.0

Run a command using sudo, prompting the user with an OS dialog if necessary
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

# elevated-command


Run command using `sudo`, prompting the user with a graphical OS dialog if necessary. Useful for background rust applications or native [Tauri](https://tauri.app/) apps that need `sudo`.


## Cross-Platform

`elevated-command` provides a native OS dialog prompt on **Windows**, **Linux** and **MacOS**.

![Windows](https://raw.githubusercontent.com/jorangreef/sudo-prompt/master/windows.png)

![Linux](https://raw.githubusercontent.com/jorangreef/sudo-prompt/master/linux.png)

![macOS](https://raw.githubusercontent.com/jorangreef/sudo-prompt/master/macos.png)


## Example

Add the following to your Cargo.toml:

```
[dependencies]
elevated-command = "1.1"
```

In your `main.rs`: 

```
use elevated_command::Command;
use std::process::Command as StdCommand;

fn main() {
    let is_elevated = Command::is_elevated();

    let mut cmd = StdCommand::new("path to the application");
    cmd.arg("some arg");

    let output = if is_elevated {
        cmd.output().unwrap()
    } else {
        let elevated_cmd = Command::new(cmd);
        elevated_cmd.output().unwrap()
    };
}
```
Note: The application should not be `sudo`.

To get started using `elevated-command`, please see the [API reference (docs.rs)](https://docs.rs/elevated-command/).

## Behavior

On Windows, `elevated-command` will elevate your command using User Account Control (UAC).

On Linux, `elevated-command` will use `pkexec` to show the password prompt and run your command.

On MacOS, `elevated-command` should behave just like the `sudo` command in the shell.


## Reference

1. [jorangreef/sudo-prompt](https://github.com/jorangreef/sudo-prompt)
2. https://stackoverflow.com/questions/8046097/how-to-check-if-a-process-has-the-administrative-rights/8196291#8196291


## License

Licensed under the [MIT](https://github.com/vangork/elevated-command/blob/main/LICENSE) license.