super-shell 1.2.4

This library provides basic super-user shell access in rust.
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

<p align="center">
    <img src="https://raw.githubusercontent.com/RouHim/super-shell-rs/main/logo.png" width="350"/>
</p>

<p align="center">
    <a href="https://crates.io/crates/super-shell"><img src="https://img.shields.io/crates/d/super-shell"/></a>
    <a href="https://crates.io/crates/super-shell"><img src="https://img.shields.io/crates/v/super-shell"/></a>
    <a href="https://github.com/RouHim/super-shell-rs/releases"><img src="https://img.shields.io/github/release-date/rouhim/super-shell-rs"/></a>
    <a href="https://github.com/RouHim/super-shell-rs/actions"><img src="https://img.shields.io/github/actions/workflow/status/rouhim/super-shell-rs/pipe.yaml"/></a>
</p>

<p align="center">
    <i>This library provides basic super-user shell access in rust.</i>
</p>

## Example usage
```rust
use super_shell::RootShell;

fn main() {
    // Super user privileges are requested once via pkexec as default.
    let mut root_shell = RootShell::new().expect("Failed to create root shell");
    
    // All subsequent requests are executed as root user
    println!("{}", root_shell.execute("echo Hello $USER"));
    
    // Each command blocks until the response is fully received
    println!("{}", root_shell.execute("echo now sleeping for 3s ..."));
    root_shell.execute("sleep 3");
    println!("done")
}
```

## Limitations
* Currently only Linux is supported
* No stderr handling
* No sudo support