cargo-msrv 0.19.1

Find your minimum supported Rust version (MSRV)!
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152

use crate::error::{IoError, IoErrorSource, TResult};
use camino::Utf8Path;
use std::ffi::{OsStr, OsString};
use std::process::{Command, Stdio};

pub struct RustupCommand {
    command: Command,
    args: Vec<OsString>,
    stdout: Stdio,
    stderr: Stdio,
    // Span used to trace the path to execution of a RustupCommand
    _span: tracing::Span,
}

impl RustupCommand {
    pub fn new() -> Self {
        Self {
            command: Command::new("rustup"),
            args: Vec::new(),
            stdout: Stdio::null(),
            stderr: Stdio::null(),
            _span: tracing::debug_span!("RustupCommand"),
        }
    }

    pub fn with_dir(mut self, path: impl AsRef<Utf8Path>) -> Self {
        // The block ensures the scope of the _span.enter() will exit before
        // returning self at the end of the method scope.
        {
            let _span = self._span.enter();

            let path = path.as_ref();

            if let Ok(canonical_path) = dunce::canonicalize(path) {
                debug!(name: "rustup_command_path", canonicalized = true, path = %canonical_path.display());
                self.command.current_dir(canonical_path);
            } else {
                debug!(name: "rustup_command_path", canonicalized = false, %path);
                self.command.current_dir(path);
            }
        }

        self
    }

    pub fn with_args<T: Into<OsString>>(mut self, args: impl IntoIterator<Item = T>) -> Self {
        self.args.extend(args.into_iter().map(Into::into));
        self
    }

    pub fn with_stdout(mut self) -> Self {
        self.stdout = Stdio::piped();
        self
    }

    pub fn with_stderr(mut self) -> Self {
        self.stderr = Stdio::piped();
        self
    }

    /// Execute `rustup run [...]`
    pub fn run(self) -> TResult<RustupOutput> {
        self.execute(OsStr::new("run"))
    }

    /// Execute `rustup install [...]`
    pub fn install(self) -> TResult<RustupOutput> {
        self.execute(OsStr::new("install"))
    }

    /// Execute `rustup show [...]`
    pub fn show(self) -> TResult<RustupOutput> {
        self.execute(OsStr::new("show"))
    }

    pub fn target(self) -> TResult<RustupOutput> {
        self.execute(OsStr::new("target"))
    }

    pub fn component(self) -> TResult<RustupOutput> {
        self.execute(OsStr::new("component"))
    }

    /// Execute a given `rustup` command.
    ///
    /// See also:
    /// * [RustupCommand::run](RustupCommand::run)
    /// * [RustupCommand::install](RustupCommand::install)
    /// * [RustupCommand::show](RustupCommand::show)
    fn execute(mut self, cmd: &OsStr) -> TResult<RustupOutput> {
        let _span = self._span.enter();

        debug!(
            name: "rustup_command_execute_start",
            cmd = ?cmd,
            args = ?self.args.as_slice(),
            current_dir = ?self.command.get_current_dir(),
        );

        self.command.arg(cmd);
        self.command.args(self.args);

        self.command.stdout(self.stdout);
        self.command.stderr(self.stderr);

        let child = self.command.spawn().map_err(|error| IoError {
            error,
            source: IoErrorSource::SpawnProcess(cmd.to_owned()),
        })?;

        let output = child.wait_with_output().map_err(|error| IoError {
            error,
            source: IoErrorSource::WaitForProcessAndCollectOutput(cmd.to_owned()),
        })?;

        debug!(
            name: "rustup_command_execute_finish",
            cmd = ?cmd,
            success = output.status.success(),
        );

        Ok(RustupOutput {
            output,
            stdout: std::sync::OnceLock::new(),
            stderr: std::sync::OnceLock::new(),
        })
    }
}

pub struct RustupOutput {
    output: std::process::Output,
    stdout: std::sync::OnceLock<String>,
    stderr: std::sync::OnceLock<String>,
}

impl RustupOutput {
    pub fn stdout(&self) -> &str {
        self.stdout
            .get_or_init(|| String::from_utf8_lossy(&self.output.stdout).into_owned())
            .as_str()
    }

    pub fn stderr(&self) -> &str {
        self.stderr
            .get_or_init(|| String::from_utf8_lossy(&self.output.stderr).into_owned())
            .as_str()
    }

    pub fn exit_status(&self) -> std::process::ExitStatus {
        self.output.status
    }
}