pkgcraft 0.0.31

library of Gentoo functionality
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

use std::fmt;

use serde::{Deserialize, Serialize};

/// Uri object.
#[derive(Debug, Deserialize, Serialize, Clone, PartialEq, Eq, PartialOrd, Ord, Hash)]
pub struct Uri {
    uri: String,
    rename: Option<String>,
}

impl Uri {
    /// Create a new Uri.
    pub(crate) fn new(uri: &str, rename: Option<&str>) -> Self {
        // TODO: Verify URLs or fetch restricted file names once parsing is reworked to
        // allow custom errors.
        Self {
            uri: uri.trim().to_string(),
            rename: rename.map(Into::into),
        }
    }

    /// Return the string slice for the [`Uri`].
    pub fn as_str(&self) -> &str {
        &self.uri
    }

    /// Return the renamed file name for the Uri, if it exists.
    pub fn rename(&self) -> Option<&str> {
        self.rename.as_deref()
    }

    /// Return the file name for the Uri.
    pub fn filename(&self) -> &str {
        self.rename().unwrap_or_else(|| {
            self.uri
                .rsplit_once('/')
                .map(|(_, s)| s)
                .unwrap_or(&self.uri)
        })
    }
}

impl fmt::Display for Uri {
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "{}", self.uri)?;
        if let Some(value) = &self.rename {
            write!(f, " -> {value}")?;
        }
        Ok(())
    }
}

impl AsRef<str> for Uri {
    fn as_ref(&self) -> &str {
        &self.uri
    }
}