uv-static 0.0.47

This is an internal component crate of uv
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

pub use env_vars::*;

mod env_vars;

use std::borrow::Cow;

use thiserror::Error;

/// The base URL for the default Astral mirror.
pub const ASTRAL_MIRROR_BASE_URL: &str = "https://releases.astral.sh";

/// Read the user-configured Astral mirror URL from the environment, if set.
pub fn astral_mirror_url_from_env() -> Option<String> {
    std::env::var_os(EnvVars::UV_ASTRAL_MIRROR_URL).and_then(|url| {
        if url.as_os_str().is_empty() {
            None
        } else {
            Some(url.to_string_lossy().into_owned())
        }
    })
}

/// Return the effective Astral mirror base URL, using the default mirror when unset.
pub fn astral_mirror_base_url(astral_mirror_url: Option<&str>) -> Cow<'_, str> {
    custom_astral_mirror_url(astral_mirror_url)
        .map(|url| Cow::Owned(url.trim_end_matches('/').to_string()))
        .unwrap_or(Cow::Borrowed(ASTRAL_MIRROR_BASE_URL))
}

/// Return a user-configured Astral mirror URL, treating empty values as unset.
pub fn custom_astral_mirror_url(astral_mirror_url: Option<&str>) -> Option<&str> {
    astral_mirror_url.filter(|url| !url.is_empty())
}

#[derive(Debug, Error)]
#[error("Failed to parse environment variable `{name}` with invalid value `{value}`: {err}")]
pub struct InvalidEnvironmentVariable {
    pub name: String,
    pub value: String,
    pub err: String,
}

/// Parse a boolean environment variable.
///
/// Adapted from Clap's `BoolishValueParser` which is dual licensed under the MIT and Apache-2.0.
pub fn parse_boolish_environment_variable(
    name: &'static str,
) -> Result<Option<bool>, InvalidEnvironmentVariable> {
    // See `clap_builder/src/util/str_to_bool.rs`
    // We want to match Clap's accepted values

    // True values are `y`, `yes`, `t`, `true`, `on`, and `1`.
    const TRUE_LITERALS: [&str; 6] = ["y", "yes", "t", "true", "on", "1"];

    // False values are `n`, `no`, `f`, `false`, `off`, and `0`.
    const FALSE_LITERALS: [&str; 6] = ["n", "no", "f", "false", "off", "0"];

    // Converts a string literal representation of truth to true or false.
    //
    // `false` values are `n`, `no`, `f`, `false`, `off`, and `0` (case insensitive).
    //
    // Any other value will be considered as `true`.
    fn str_to_bool(val: impl AsRef<str>) -> Option<bool> {
        let pat: &str = &val.as_ref().to_lowercase();
        if TRUE_LITERALS.contains(&pat) {
            Some(true)
        } else if FALSE_LITERALS.contains(&pat) {
            Some(false)
        } else {
            None
        }
    }

    let Some(value) = std::env::var_os(name) else {
        return Ok(None);
    };

    let Some(value) = value.to_str() else {
        return Err(InvalidEnvironmentVariable {
            name: name.to_string(),
            value: value.to_string_lossy().to_string(),
            err: "expected a valid UTF-8 string".to_string(),
        });
    };

    let Some(value) = str_to_bool(value) else {
        return Err(InvalidEnvironmentVariable {
            name: name.to_string(),
            value: value.to_string(),
            err: "expected a boolish value".to_string(),
        });
    };

    Ok(Some(value))
}