caesura 0.31.0

An all-in-one command line tool to transcode FLAC audio files and upload to gazelle based indexers/trackers
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

use crate::prelude::*;
use std::future::Future;
use std::process::Output;

/// Extension trait for running processes and requiring success.
pub trait ProcessExt {
    /// Run the process and require successful exit.
    ///
    /// - Returns [`Output`] on success
    /// - Returns [`Failure`] with [`ProcessAction::Start`] if the process fails to start
    /// - Returns [`Failure`] with [`ProcessAction::Execute`] if the process exits with non-zero status
    fn run(&mut self) -> impl Future<Output = Result<Output, Failure<ProcessAction>>> + Send;
}

impl ProcessExt for TokioCommand {
    async fn run(&mut self) -> Result<Output, Failure<ProcessAction>> {
        let program = self.as_std().get_program().to_string_lossy().to_string();
        let output = self
            .output()
            .await
            .map_err(|e| Failure::new(ProcessAction::Start, e).with("program", &program))?;
        require_success(output, &program)
    }
}

/// Check that a process output indicates success.
///
/// Use this for processes that use `.spawn()` + `.wait_with_output()` patterns
/// where you can't use [`ProcessExt::run()`].
pub fn require_success(output: Output, program: &str) -> Result<Output, Failure<ProcessAction>> {
    if output.status.success() {
        Ok(output)
    } else {
        Err(
            Failure::new(ProcessAction::Execute, ProcessOutput::from(output))
                .with("program", program),
        )
    }
}