isothrum-cli 0.11.0

isothrum: run what Isoloom generates (up, down, park, resume, status, check, events) from the command line.
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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88

//! Where things are: the run manifest of a lab folder, and the runner's home.

use std::path::{Path, PathBuf};

use crate::error::{Error, Result};

/// The manifest to run: `lab` itself when it is a file; else `lab/.isoloom/<target>/run.json`,
/// the target being the one asked for, or the only one generated.
pub(crate) fn manifest(lab: &Path, target: Option<&str>) -> Result<PathBuf> {
    if lab.is_file() {
        return Ok(lab.to_path_buf());
    }
    let outputs = lab.join(".isoloom");
    if let Some(target) = target {
        let path = outputs.join(target).join("run.json");
        return if path.is_file() {
            Ok(path)
        } else {
            Err(Error::Usage(format!(
                "{} doesn't exist: run `isoloom generate --target {target}` first",
                path.display()
            )))
        };
    }
    let mut found: Vec<PathBuf> = std::fs::read_dir(&outputs)
        .map(|entries| entries.flatten().map(|e| e.path().join("run.json")).filter(|p| p.is_file()).collect())
        .unwrap_or_default();
    found.sort();
    match found.as_slice() {
        [one] => Ok(one.clone()),
        [] => Err(Error::Usage(format!(
            "no run manifest under {}: run `isoloom generate --target <target>` first",
            outputs.display()
        ))),
        many => {
            let names: Vec<String> = many
                .iter()
                .filter_map(|p| Some(p.parent()?.file_name()?.to_string_lossy().into_owned()))
                .collect();
            Err(Error::Usage(format!(
                "{} has manifests for {}: choose one with --target",
                lab.display(),
                names.join(", ")
            )))
        }
    }
}

/// The runner's home: `--home`, else `$ISOTHRUM_HOME`, else `~/.isothrum`.
pub(crate) fn home(flag: Option<PathBuf>, env: Option<String>, user_home: Option<PathBuf>) -> Result<PathBuf> {
    flag.or_else(|| env.filter(|h| !h.is_empty()).map(PathBuf::from))
        .or_else(|| user_home.map(|h| h.join(".isothrum")))
        .ok_or_else(|| Error::Usage("no home folder: give --home or set ISOTHRUM_HOME".into()))
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn the_only_generated_target_is_found_else_one_must_be_named() {
        let lab = tempfile::tempdir().unwrap();
        assert!(manifest(lab.path(), None).unwrap_err().to_string().contains("isoloom generate"));
        let docker = lab.path().join(".isoloom/docker/run.json");
        std::fs::create_dir_all(docker.parent().unwrap()).unwrap();
        std::fs::write(&docker, "{}").unwrap();
        assert_eq!(manifest(lab.path(), None).unwrap(), docker);
        assert_eq!(manifest(&docker, None).unwrap(), docker);
        std::fs::create_dir_all(lab.path().join(".isoloom/vagrant")).unwrap();
        std::fs::write(lab.path().join(".isoloom/vagrant/run.json"), "{}").unwrap();
        assert!(
            manifest(lab.path(), None)
                .unwrap_err()
                .to_string()
                .contains("docker, vagrant: choose one with --target")
        );
        assert_eq!(manifest(lab.path(), Some("docker")).unwrap(), docker);
        assert!(manifest(lab.path(), Some("proxmox")).is_err());
    }

    #[test]
    fn the_home_is_the_flag_else_the_variable_else_the_users() {
        assert_eq!(home(Some("/a".into()), Some("/b".into()), Some("/u".into())).unwrap(), PathBuf::from("/a"));
        assert_eq!(home(None, Some("/b".into()), Some("/u".into())).unwrap(), PathBuf::from("/b"));
        assert_eq!(home(None, Some(String::new()), Some("/u".into())).unwrap(), PathBuf::from("/u/.isothrum"));
        assert!(home(None, None, None).is_err());
    }
}