Enum OnFailure 

pub enum OnFailure {
    Deny,
    Allow,
}

What to do when a hook cannot answer.

The default is Self::Deny. A hook exists to have a say over whether a call happens and in what form, so a configured hook is by construction something whose opinion the operator wanted; when it cannot speak, nobody knows what it would have said. The two failure modes are not symmetric: allowing on a broken guard quietly removes a control the operator believes is in place, while denying on a broken observer produces a loud failure that gets fixed within the minute. Prefer the failure that announces itself.

Self::Allow is there because “observer” is a real use — a hook that logs or notifies has no business stopping a turn when its network call times out. It is a per-hook choice, and it is written down in the file rather than inferred.

The in-process binding has no equivalent and needs none: an Interceptor that would rather be ignored returns HookOutcome::Allow itself, in code it already owns. Failing is what a host cannot describe from inside a crash, and that is the case this enum answers.

Variants

Deny

Treat a broken hook as a refusal.

What a refusal costs depends on when the hook was asked. Before the call it does not run; afterwards it already has, so the model is shown the failure in place of the output. Both are the same ruling — a guard that could not speak has not cleared anything — and after the call it is the only part of it still available.

Allow

Treat a broken hook as no opinion, and carry on.

Trait Implementations

impl Clone for OnFailure

fn clone(&self) -> OnFailure

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for OnFailure

impl Debug for OnFailure

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for OnFailure

fn default() -> OnFailure

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for OnFailure

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for OnFailure

impl PartialEq for OnFailure

fn eq(&self, other: &OnFailure) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for OnFailure

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for OnFailure