tool-sync 0.2.0

tool-sync is a CLI tool that manages installation of other CLI tools from GitHub Releases by downloading binaries and storing them in a local directory.
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

use shellexpand;
use std::collections::BTreeMap;
use std::path::PathBuf;

use crate::err;
use crate::model::asset_name::AssetName;
use crate::model::tool::{ToolInfo, ToolInfoTag};

/// Stores global information about the tool installation process and detailed
/// info about installing each particular tool.
///
/// This data type is parsed from the TOML configuration file.
#[derive(Debug, PartialEq, Eq)]
pub struct Config {
    /// Directory to store all locally downloaded tools
    pub store_directory: String,

    /// Info about each individual tool
    pub tools: BTreeMap<String, ConfigAsset>,
}

/// Additional details, telling how to download a tool
#[derive(Debug, PartialEq, Eq)]
pub struct ConfigAsset {
    /// GitHub repository author
    pub owner: Option<String>,

    /// GitHub repository name
    pub repo: Option<String>,

    /// Executable name inside the .tar.gz or .zip archive
    /// Defaults to `repo` if not specified
    pub exe_name: Option<String>,

    /// Release tag to download
    /// Defaults to the latest release
    pub tag: Option<String>,

    /// Name of the specific asset to download
    pub asset_name: AssetName,
}

impl From<ToolInfo> for ConfigAsset {
    fn from(tool_info: ToolInfo) -> Self {
        let tag = match tool_info.tag {
            ToolInfoTag::Specific(version) => Some(version),
            ToolInfoTag::Latest => None,
        };

        Self {
            owner: Some(tool_info.owner),
            repo: Some(tool_info.repo),
            exe_name: Some(tool_info.exe_name),
            tag,
            asset_name: tool_info.asset_name,
        }
    }
}

impl Config {
    /// Shellexpands store directory, check whether it exists and exits with
    /// error if 'store_directory' doesn't exist
    pub fn ensure_store_directory(&self) -> PathBuf {
        let expanded_store_directory = shellexpand::full(&self.store_directory);

        let store_directory = match expanded_store_directory {
            Err(e) => err::abort_with(e),
            Ok(cow_path) => PathBuf::from(cow_path.into_owned()),
        };

        let has_store_directory = store_directory.as_path().is_dir();

        if !has_store_directory {
            err::abort_with(format!(
                "Specified directory for storing tools doesn't exist: {}",
                store_directory.display()
            ));
        }

        store_directory
    }
}