moonup 0.5.2

Manage multiple MoonBit installations
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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120

use std::ffi::OsStr;
use std::path::PathBuf;

use crate::{constant::TOOLCHAIN_FILE, utils::trimmed_or_none};

/// Iterates over the current directory and all its parent directories to find
/// if there is a [`TOOLCHAIN_FILE`].
///
/// # Returns
///
/// The path to the toolchain file if found
pub fn resolve_toolchain_file() -> Option<PathBuf> {
    let current_dir = std::env::current_dir().ok();
    std::iter::successors(current_dir.as_deref(), |prev| prev.parent())
        .find_map(|dir| Some(dir.join(TOOLCHAIN_FILE)).filter(|p| p.is_file()))
}

/// Detect the pinned toolchain from the current working directory
///
/// # Returns
///
/// The pinned toolchain version if found
pub fn detect_pinned_toolchain() -> Option<String> {
    resolve_toolchain_file()
        .and_then(|path| {
            std::fs::read_to_string(path)
                .map(|s| trimmed_or_none(&s).map(str::to_owned))
                .ok()
        })
        .flatten()
}

/// Detect the default toolchain
///
/// The default toolchain version is stored in the `$MOONUP_HOME/default` file
///
/// # Returns
///
/// The default toolchain version if found
pub fn detect_default_toolchain() -> Option<String> {
    let default_file = crate::moonup_home().join("default");
    std::fs::read_to_string(default_file)
        .map(|s| trimmed_or_none(&s).map(str::to_owned))
        .ok()
        .flatten()
}

/// Iterates over the current directory and all its parent directories
/// to find if there is a [`TOOLCHAIN_FILE`] and detect the toolchain version.
///
/// # Returns
///
/// The path to actual versioned toolchain
pub fn detect_active_toolchain() -> PathBuf {
    let active = detect_active_toolchainspec();
    crate::moonup_home().join("toolchains").join(active)
}

/// Iterates over the current directory and all its parent directories
/// to find if there is a [`TOOLCHAIN_FILE`] and detect the toolchain spec.
///
/// # Returns
///
/// The toolchain spec
///
/// # Note
///
/// This function is used by the `moonup-shim`, and because we don't want to
/// bloated the shim, miette/tracing should not be used here.
pub fn detect_active_toolchainspec() -> String {
    detect_pinned_toolchain()
        .or(detect_default_toolchain())
        .unwrap_or("latest".to_string())
}

/// Resolves the executable binary in the given paths.
///
/// # Returns
///
/// The path to the executable binary if found, otherwise `None`.
pub fn resolve_exe<T, U>(binary_name: T, paths: U) -> Option<PathBuf>
where
    T: AsRef<OsStr>,
    U: AsRef<OsStr>,
{
    // Ensure PATHEXT is set on Windows for `which-rs` crate to work correctly
    // NOTE(chawyehsu): This is a workaround for [1], also relevant to [2]
    //
    // [1]: https://github.com/moonbitlang/moonbit-docs/issues/1236
    // [2]: https://github.com/harryfei/which-rs/issues/123
    #[cfg(target_os = "windows")]
    if std::env::var("PATHEXT").is_err() {
        // SAFETY: `set_var` is always safe to call on Windows,
        // whether single-threaded or multi-threaded
        unsafe {
            std::env::set_var("PATHEXT", crate::constant::DEFAULT_PATHEXT);
        };
    }

    which::which_in_global(binary_name, Some(paths))
        .and_then(|mut i| i.next().ok_or(which::Error::CannotFindBinaryPath))
        .ok()
}

/// Resolves a file in the given paths without requiring executable bits.
///
/// # Returns
///
/// The path to the file if found, otherwise `None`.
pub fn resolve_file<T, U>(file_name: T, paths: U) -> Option<PathBuf>
where
    T: AsRef<OsStr>,
    U: AsRef<OsStr>,
{
    let file_name = file_name.as_ref();

    std::env::split_paths(paths.as_ref())
        .map(|path| path.join(file_name))
        .find(|path| path.is_file())
}