walker-common 0.17.0

Common functionality for SBOM and CSAF walker
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

//! URLs
use url::Url;

/// Get a URL from something
///
/// ## Relative URLs
///
/// A entity can provide a relative URL. This is an optional operation, and is not implemented by default.
///
/// Implementors of this feature should have a clear definition what the meaning of the base is. For example:
/// the advisory's base is the distribution URL.
///
/// The combination of the provided actual base and relative URL must result in the same value as the actual URL.
pub trait Urlify {
    /// The URL
    fn url(&self) -> &Url;

    fn relative_base_and_url(&self) -> Option<(&Url, String)> {
        None
    }

    fn relative_url(&self) -> Option<String> {
        self.relative_base_and_url().map(|(_, url)| url)
    }

    fn relative_base(&self) -> Option<&Url> {
        self.relative_base_and_url().map(|(url, _)| url)
    }

    fn possibly_relative_url(&self) -> String {
        self.relative_url()
            .unwrap_or_else(|| self.url().to_string())
    }
}

impl<T, E> Urlify for Result<T, E>
where
    T: Urlify,
    E: Urlify,
{
    fn url(&self) -> &Url {
        match self {
            Ok(something) => something.url(),
            Err(something) => something.url(),
        }
    }
}

/// Ensure that the path has a trailing slash
pub fn ensure_slash(mut url: Url) -> Url {
    if !url.path().ends_with("/") {
        let new_path = format!("{}/", url.path());
        url.set_path(&new_path);
    }

    url
}