#sudo #command #dialog #user #applications #necessary #cross-platform

elevated-command

Run a command using sudo, prompting the user with an OS dialog if necessary

4 stable releases

1.1.2 Jan 4, 2024
1.1.1 Jan 3, 2024
1.1.0 Jan 2, 2024
1.0.0 Jan 2, 2024

#6 in #necessary

Download history 22/week @ 2024-02-12 34/week @ 2024-02-19 62/week @ 2024-02-26 34/week @ 2024-03-04 79/week @ 2024-03-11 49/week @ 2024-03-18 12/week @ 2024-03-25 82/week @ 2024-04-01 33/week @ 2024-04-08 22/week @ 2024-04-15 18/week @ 2024-04-22

156 downloads per month

MIT license

35KB
278 lines

elevated-command

crates.io docs.rs

Run command using sudo, prompting the user with a graphical OS dialog if necessary. Useful for background rust applications or native Tauri apps that need sudo.

Cross-Platform

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

Windows

Linux

macOS

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).

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
  2. https://stackoverflow.com/questions/8046097/how-to-check-if-a-process-has-the-administrative-rights/8196291#8196291
  3. https://fix.moe/post/macos-app-authorization

License

Licensed under the MIT license.

Dependencies

~0.1–39MB
~563K SLoC