Enum VerificationResult 

pub enum VerificationResult {
    Ok,
    Unauthorized,
}

Result of a secret / credential verification operation.

This enum is used throughout the authentication pipeline (hash verification, credential repository checks, login services) to distinguish a successful verification from an unauthorized outcome without revealing why it failed (e.g. wrong password vs. unknown user) when higher layers deliberately collapse those states to resist user enumeration.

Semantics

• VerificationResult::Ok — Supplied value matched the stored/expected secret.
• VerificationResult::Unauthorized — Value did not match, or the subject/identity was intentionally treated as non-existent/mismatched for security uniformity.

Conversions

• VerificationResult::from(bool) maps true -> Ok, false -> Unauthorized.
• bool::from(VerificationResult) returns true for Ok, false otherwise.

When to Use

Prefer this over Result<bool, E> when:

• You want an explicit success vs. unauthorized domain signal
• Errors/exceptions are reserved strictly for infrastructural failures

Side‑Channel Guidance

Combine it with constant‑time hash verification and unified handling to avoid exposing whether an identifier exists.

Example

use axum_gate::verification_result::VerificationResult;

fn check(match_flag: bool) -> VerificationResult {
    VerificationResult::from(match_flag)
}

assert_eq!(check(true), VerificationResult::Ok);
assert_eq!(check(false), VerificationResult::Unauthorized);

Variants

Ok

The verification succeeded (value matched).

Unauthorized

The supplied value failed verification (non-match / unauthorized).

Trait Implementations

impl Clone for VerificationResult

fn clone(&self) -> VerificationResult

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for VerificationResult

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

Formats the value using the given formatter.

impl From<VerificationResult> for bool

fn from(result: VerificationResult) -> Self

Converts to this type from the input type.

impl From<bool> for VerificationResult

fn from(value: bool) -> Self

Converts to this type from the input type.

impl PartialEq for VerificationResult

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for VerificationResult

impl Eq for VerificationResult

impl StructuralPartialEq for VerificationResult