la-stack 0.4.4

Fast, stack-allocated linear algebra for fixed dimensions
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

#![forbid(unsafe_code)]

//! Shared helpers for benchmark operations that cannot recover from failure.

use std::fmt::Display;

/// Convert a fallible benchmark operation into its successful value or abort.
pub(crate) trait OrAbort {
    /// Successful value produced by the operation.
    type Output;

    /// Return the successful value or panic with the named operation.
    ///
    /// # Panics
    ///
    /// Panics when the benchmark operation contains an error or no value.
    fn or_abort(self, operation: &str) -> Self::Output;
}

impl<T, E: Display> OrAbort for Result<T, E> {
    type Output = T;

    fn or_abort(self, operation: &str) -> Self::Output {
        match self {
            Ok(value) => value,
            Err(err) => panic!("{operation} failed: {err}"),
        }
    }
}

impl<T> OrAbort for Option<T> {
    type Output = T;

    fn or_abort(self, operation: &str) -> Self::Output {
        self.unwrap_or_else(|| panic!("{operation} returned no result"))
    }
}

#[cfg(test)]
mod tests {
    #[test]
    fn returns_result_and_option_values() {
        assert_eq!(
            <Result<_, &str> as super::OrAbort>::or_abort(Ok(7), "successful result"),
            7
        );
        assert_eq!(
            <Option<_> as super::OrAbort>::or_abort(Some(11), "present option"),
            11
        );
    }

    #[test]
    #[should_panic(expected = "fallible setup failed: fixture error")]
    fn result_error_preserves_context_and_error() {
        <Result<(), &str> as super::OrAbort>::or_abort(Err("fixture error"), "fallible setup");
    }

    #[test]
    #[should_panic(expected = "optional setup returned no result")]
    fn missing_option_preserves_context() {
        <Option<()> as super::OrAbort>::or_abort(None, "optional setup");
    }
}