dotfiles_core/
exec_wrapper.rs

1// Copyright (c) 2021-2026 Miguel Barreto and others
2//
3// Permission is hereby granted, free of charge, to any person obtaining
4// a copy of this software and associated documentation files (the
5// "Software"), to deal in the Software without restriction, including
6// without limitation the rights to use, copy, modify, merge, publish,
7// distribute, sublicense, and/or sell copies of the Software, and to
8// permit persons to whom the Software is furnished to do so, subject to
9// the following conditions:
10//
11// The above copyright notice and this permission notice shall be
12// included in all copies or substantial portions of the Software.
13//
14// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
15// EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
16// MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
17// NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
18// LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
19// OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
20// WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
21
22//! Wraps some logic to run external commands and handle errors
23
24use std::io::Result as IoResult;
25use subprocess::{Exec, ExitStatus};
26
27use crate::error::{execution_error, process_until_first_err, DotfilesError};
28
29/// Executes the `cmd` and waits for it to finish.
30///
31/// If the execution returns a [std::io::Error] then it uses the `io_error_message`
32/// for the message in a DotfilesError.
33///
34/// If the execution finishes but in an error state, then it uses the
35/// `error_while_running_message` instead.
36pub fn execute_commands(
37  cmds: Vec<Exec>,
38  io_error_message: &str,
39  error_while_running_message: &str,
40) -> Result<(), DotfilesError> {
41  process_until_first_err(cmds, |cmd| {
42    handle_exec_error(cmd.join(), io_error_message, error_while_running_message)
43  })
44}
45
46fn handle_exec_error(
47  result: IoResult<ExitStatus>,
48  io_error_message: &str,
49  error_while_running_message: &str,
50) -> Result<(), DotfilesError> {
51  result.map_or_else(
52    |err| {
53      Err(DotfilesError::from(
54        io_error_message.into(),
55        execution_error(Some(err), None),
56      ))
57    },
58    |status| match status.success() {
59      true => Ok(()),
60      false => Err(DotfilesError::from(
61        format!("{error_while_running_message}, {status:?}"),
62        execution_error(None, Some(status)),
63      )),
64    },
65  )
66}
dotfiles_core/exec_wrapper.rs

dotfiles_core/
exec_wrapper.rs
