dolly-cli 0.1.1

Like apt, but for GitHub repositories — clone, build, install and update tools from source.
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
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

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

use thiserror::Error;

#[derive(Debug, Error)]
pub enum BinaryError {
    #[error("build output not found at `{0}`; check `[build].output` in your recipe")]
    OutputMissing(PathBuf),

    #[error(transparent)]
    Io(#[from] io::Error),
}

pub fn place(src: &Path, dest: &Path) -> Result<(), BinaryError> {
    if !src.exists() {
        return Err(BinaryError::OutputMissing(src.to_path_buf()));
    }

    if let Some(parent) = dest.parent() {
        std::fs::create_dir_all(parent)?;
    }

    std::fs::copy(src, dest)?;
    Ok(())
}

pub fn make_executable(path: &Path) -> Result<(), BinaryError> {
    #[cfg(unix)]
    {
        use std::os::unix::fs::PermissionsExt;
        let mut perms = std::fs::metadata(path)?.permissions();
        perms.set_mode(0o755);
        std::fs::set_permissions(path, perms)?;
    }
    Ok(())
}

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

    #[test]
    fn place_copies_file_contents() {
        let dir = tempfile::tempdir().unwrap();
        let src = dir.path().join("src.bin");
        let dest = dir.path().join("subdir").join("dest.bin");

        std::fs::write(&src, b"hello world").unwrap();
        place(&src, &dest).unwrap();

        let contents = std::fs::read(&dest).unwrap();
        assert_eq!(contents, b"hello world");
    }

    #[test]
    fn place_creates_missing_parent_dir() {
        let dir = tempfile::tempdir().unwrap();
        let src = dir.path().join("src.bin");
        let dest = dir.path().join("nested").join("dirs").join("dest.bin");

        std::fs::write(&src, b"x").unwrap();
        place(&src, &dest).unwrap();

        assert!(dest.exists());
    }

    #[test]
    fn place_overwrites_existing_dest() {
        let dir = tempfile::tempdir().unwrap();
        let src = dir.path().join("src.bin");
        let dest = dir.path().join("dest.bin");

        std::fs::write(&src, b"new").unwrap();
        std::fs::write(&dest, b"old").unwrap();
        place(&src, &dest).unwrap();

        assert_eq!(std::fs::read(&dest).unwrap(), b"new");
    }

    #[test]
    fn place_returns_output_missing_when_src_absent() {
        let dir = tempfile::tempdir().unwrap();
        let src = dir.path().join("missing.bin");
        let dest = dir.path().join("dest.bin");

        let err = place(&src, &dest).unwrap_err();
        assert!(matches!(err, BinaryError::OutputMissing(p) if p == src));
    }

    #[cfg(unix)]
    #[test]
    fn make_executable_sets_mode_755() {
        use std::os::unix::fs::PermissionsExt;

        let dir = tempfile::tempdir().unwrap();
        let path = dir.path().join("bin");
        std::fs::write(&path, b"x").unwrap();

        let mut perms = std::fs::metadata(&path).unwrap().permissions();
        perms.set_mode(0o644);
        std::fs::set_permissions(&path, perms).unwrap();

        make_executable(&path).unwrap();

        let mode = std::fs::metadata(&path).unwrap().permissions().mode() & 0o777;
        assert_eq!(mode, 0o755);
    }
}