dotfiles_core/exec_wrapper.rs
1// Copyright (c) 2021-2022 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 subprocess::{Exec, ExitStatus, PopenError};
25
26use crate::error::{execution_error, process_until_first_err, DotfilesError};
27
28/// Executes the `cmd` and waits for it to finish.
29///
30/// If the execution returns a [subprocess::PopenError] then it uses the `popen_error_message`
31/// for the message in a DotfilesError.
32///
33/// If the execution finishes but in an error state, then it uses the
34/// `error_while_running_message` instead.
35pub fn execute_commands(
36 cmds: Vec<Exec>,
37 popen_error_message: &str,
38 error_while_running_message: &str,
39) -> Result<(), DotfilesError> {
40 process_until_first_err(cmds.into_iter(), |cmd| {
41 handle_exec_error(cmd.join(), popen_error_message, error_while_running_message)
42 })
43}
44
45fn handle_exec_error(
46 popen: Result<ExitStatus, PopenError>,
47 popen_error_message: &str,
48 error_while_running_message: &str,
49) -> Result<(), DotfilesError> {
50 popen.map_or_else(
51 |err| {
52 Err(DotfilesError::from(
53 popen_error_message.into(),
54 execution_error(Some(err), None),
55 ))
56 },
57 |status| match status {
58 ExitStatus::Exited(0) => Ok(()),
59 _ => Err(DotfilesError::from(
60 format!("{error_while_running_message}, {status:?}"),
61 execution_error(None, Some(status)),
62 )),
63 },
64 )
65}