abscissa_core 0.9.0

Application microframework with support for command-line option parsing, configuration, error handling, logging, and terminal interactions. This crate contains the framework's core functionality.
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

//! Exit statuses for terminated processes

use super::Guard;
use std::fmt;

/// Information about a process's exit status
pub struct ExitStatus<'cmd> {
    /// Exit code
    code: i32,

    /// Optional mutex guard ensuring exclusive access to this process.
    ///
    /// This is held by the exit status to ensure tests can inspect the results
    /// of executed commands with the lock held.
    #[allow(dead_code)]
    guard: Option<Guard<'cmd>>,
}

impl<'cmd> ExitStatus<'cmd> {
    /// Create a new exit status
    pub(super) fn new(code: i32, guard: Option<Guard<'cmd>>) -> Self {
        Self { code, guard }
    }

    /// Get the exit code
    pub fn code(&self) -> i32 {
        self.code
    }

    /// Did the process exit successfully?
    pub fn success(&self) -> bool {
        self.code == 0
    }

    /// Assert that the process exited successfully
    pub fn expect_success(&self) {
        assert_eq!(
            0, self.code,
            "process exited with error status: {}",
            self.code
        );
    }

    /// Assert that the process exited with the given code
    pub fn expect_code(&self, code: i32) {
        assert_eq!(
            code, self.code,
            "process exited with status code: {} (expected {})",
            self.code, code
        )
    }
}

impl fmt::Debug for ExitStatus<'_> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "ExitStatus({})", self.code)
    }
}