#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub enum FailPolicy {
FailOpen,
FailClosed,
FailClosedWithFallback,
}
impl FailPolicy {
pub fn continues_on_failure(&self) -> bool {
matches!(self, FailPolicy::FailOpen)
}
pub fn halts_on_failure(&self) -> bool {
!self.continues_on_failure()
}
}
impl Default for FailPolicy {
fn default() -> Self {
FailPolicy::FailClosed
}
}
impl core::fmt::Display for FailPolicy {
fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
let name = match self {
FailPolicy::FailOpen => "fail-open",
FailPolicy::FailClosed => "fail-closed",
FailPolicy::FailClosedWithFallback => "fail-closed-with-fallback",
};
f.write_str(name)
}
}
#[cfg(test)]
mod tests {
use super::*;
const ALL: [FailPolicy; 3] = [
FailPolicy::FailOpen,
FailPolicy::FailClosed,
FailPolicy::FailClosedWithFallback,
];
#[test]
fn every_variant_is_covered_and_halting_is_the_majority() {
for policy in ALL {
let halts = match policy {
FailPolicy::FailOpen => false,
FailPolicy::FailClosed => true,
FailPolicy::FailClosedWithFallback => true,
};
assert_eq!(policy.halts_on_failure(), halts, "{policy}");
assert_eq!(policy.continues_on_failure(), !halts, "{policy}");
}
}
#[test]
fn only_fail_open_continues() {
let continuing: Vec<_> = ALL
.into_iter()
.filter(FailPolicy::continues_on_failure)
.collect();
assert_eq!(continuing, vec![FailPolicy::FailOpen]);
}
#[test]
fn default_is_fail_closed() {
assert_eq!(FailPolicy::default(), FailPolicy::FailClosed);
}
#[test]
fn display_is_stable_for_logs() {
assert_eq!(FailPolicy::FailOpen.to_string(), "fail-open");
assert_eq!(FailPolicy::FailClosed.to_string(), "fail-closed");
assert_eq!(
FailPolicy::FailClosedWithFallback.to_string(),
"fail-closed-with-fallback"
);
}
}