Enum RefusalKind 

pub enum RefusalKind {
    VersionUnsupported,
    VersionBlocked,
    ServiceUnknown,
    RateLimited,
    ShuttingDown,
    Other(ErrorCode),
}

Stable, matchable classification of a broker HelloReply::Refused code.

This is the consumer-facing decision surface for the broker’s refusal codes: the wire carries an ErrorCode i32, but a future broker may add codes a consumer’s build predates. Matching on RefusalKind keeps consumer retry logic exhaustive and forward-compatible — any unrecognized code lands in RefusalKind::Other rather than silently mismatching.

Variants

VersionUnsupported

The requested version is below the backend’s min_version or otherwise not offered. Caller should upgrade/downgrade, not blindly retry.

VersionBlocked

The requested version is explicitly blocked (e.g. yanked). Do not retry with the same version.

ServiceUnknown

The service name is unknown to this broker. A configuration error; retrying will not help.

RateLimited

The broker is rate-limiting this peer. Honour retry_after_ms.

ShuttingDown

The broker is shutting down. Retry against a fresh broker.

Other(ErrorCode)

Any other refusal code (peer rejected, internal, fd pressure, spawn failure, unspecified, or a code newer than this build understands).

Implementations

impl RefusalKind

pub fn from_code(code: ErrorCode) -> Self

Map a wire ErrorCode to its RefusalKind.

Trait Implementations

impl Clone for RefusalKind

fn clone(&self) -> RefusalKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RefusalKind

impl Debug for RefusalKind

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

Formats the value using the given formatter.

impl Eq for RefusalKind

impl PartialEq for RefusalKind

fn eq(&self, other: &RefusalKind) -> 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 StructuralPartialEq for RefusalKind