up 0.18.1

up is a tool to help you keep your machine up to date.
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

//! Handle paths that are passed as CLI options.

use crate::utils::files;
use camino::Utf8Path;
use camino::Utf8PathBuf;
use color_eyre::eyre::Result;
use std::fmt::Display;
use std::ops::Deref;
use std::str::FromStr;

/// The path to a temporary directory for up to use for temporary file output.
#[derive(Debug, Clone)]
pub struct TempDir(pub Utf8PathBuf);

impl TempDir {
    /// Create the temp directory and then join a file path to it.
    pub fn join_file_mkdir(&self, path: impl AsRef<Utf8Path>) -> Result<Utf8PathBuf> {
        files::create_dir_all(&self.0)?;
        Ok(self.0.join(path))
    }

    /// Join a dir path and create the directory.
    pub fn join_dir_mkdir(&self, path: impl AsRef<Utf8Path>) -> Result<Utf8PathBuf> {
        let output = self.0.join(path);
        files::create_dir_all(&output)?;
        Ok(output)
    }

    /// Create the directory and return a reference to it.
    pub fn mkdir_as_ref(&self) -> Result<&Utf8Path> {
        files::create_dir_all(&self.0)?;
        Ok(self.as_ref())
    }
}

impl Default for TempDir {
    fn default() -> Self {
        let mut temp_dir = Utf8PathBuf::try_from(std::env::temp_dir())
            .expect("Expected default temporary directory for system to be valid UTF-8");
        temp_dir.push("up");
        Self(temp_dir)
    }
}

impl FromStr for TempDir {
    type Err = std::convert::Infallible;

    fn from_str(s: &str) -> Result<Self, Self::Err> {
        Utf8PathBuf::from_str(s).map(Self)
    }
}

impl Display for TempDir {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.0)
    }
}

impl AsRef<Utf8Path> for TempDir {
    fn as_ref(&self) -> &Utf8Path {
        &self.0
    }
}

impl Deref for TempDir {
    type Target = Utf8PathBuf;

    fn deref(&self) -> &Utf8PathBuf {
        &self.0
    }
}