rootless-run 0.1.0

Rootless execution of commands that require root
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

//! Traits for rootless backends.

use std::process::Output;

/// The options for a rootless backend.
pub trait RootlessOptions {
    /// Returns the options as a [`Vec`] of [`String`].
    fn to_vec(&self) -> Vec<String>;
}

/// A backend for running a command as root.
pub trait RootlessBackend<T>
where
    T: RootlessOptions,
{
    /// The Error type to use.
    type Err;

    /// Creates a new [`RootlessBackend`] from a [`RootlessOptions`].
    fn new(options: T) -> Self
    where
        Self: Sized;

    /// Returns the specific [`RootlessOptions`] used for the [`RootlessBackend`] implementation.
    fn options(&self) -> &T;

    /// Runs a command as root using the [`RootlessBackend`] implementation and returns the
    /// resulting [`Output`].
    fn run(&self, command: &[&str]) -> Result<Output, Self::Err>;
}