roguewave 0.1.0

An imperative remote server automation tool
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

use anyhow::{bail, Context, Result};
use log::{debug, info};

use crate::Session;

impl Session {
    /// Check if the user `name` exists on the remote system.
    pub async fn user_exists(&self, name: &str) -> Result<bool> {
        let code = self
            .command(["id", "--user", name])
            .hide_command()
            .hide_all_output()
            .exit_code()
            .await?;
        match code {
            0 => Ok(true),
            1 => Ok(false),
            _ => bail!("unexpected exit code"),
        }
    }

    /// Create a user and its home directory on the remote system.
    pub async fn create_user(&self, name: &str) -> Result<()> {
        if self.user_exists(name).await? {
            debug!("user {name:?} already exists");
            return Ok(());
        }
        self.command(["useradd", "--create-home", name])
            .run()
            .await?;
        info!("created user {name:?}");
        Ok(())
    }

    /// Fetch remote user ID by name.
    pub async fn user_id(&self, name: &str) -> Result<u32> {
        self.command(["id", "--user", name])
            .hide_command()
            .hide_stdout()
            .run()
            .await?
            .stdout
            .trim()
            .parse()
            .context("failed to parse user id")
    }
}