Enum ArticleFailureKind 

pub enum ArticleFailureKind {
    NotFound,
    ServerDown,
    AuthFailed,
    PermissionDenied,
    DecodeError,
    Timeout,
    ConnectionClosed,
    Protocol,
    Other,
}

Why an article failed. Drives retry decisions, hopeless tracking, and circuit-breaker logic.

Variants

NotFound

430 — article not present on this server. Could be retention drift or never posted; try other servers.

ServerDown

50x or service unavailable — transient server-side issue. Try another server; circuit-break this one if it persists.

AuthFailed

481 / 482 — authentication failed for this account on this server. Don’t keep retrying with the same credentials.

PermissionDenied

403 / explicit forbidden — permanent rejection for this account on this server. Functionally identical to AuthFailed for retry purposes but distinguished for diagnostics.

DecodeError

yEnc decode failure or file-assembly mismatch. Could be corruption on this server (try another) or genuine corruption on every server.

Timeout

Read/write timeout. Transient — retry on the same or another server.

ConnectionClosed

TCP socket closed mid-transfer (RST, EOF, etc.).

Protocol

NNTP protocol violation or unexpected response shape.

Other

Catch-all when classification isn’t possible at the emit site.

Implementations

impl ArticleFailureKind

pub fn is_per_server(self) -> bool

True if this failure is specific to the server that produced it — the article may still be obtainable from another provider.

pub fn counts_toward_hopeless(self) -> bool

True if the failure suggests the article is gone everywhere once every server has been tried (hopeless-tracker should count it).

pub fn should_break_server(self) -> bool

True if this server is unlikely to recover within the lifetime of the current download — circuit-breaker hint.

pub fn as_str(self) -> &'static str

Short stable identifier suitable for logs/metrics labels.

Trait Implementations

impl Clone for ArticleFailureKind

fn clone(&self) -> ArticleFailureKind

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ArticleFailureKind

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

Formats the value using the given formatter.

impl Hash for ArticleFailureKind

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ArticleFailureKind

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

impl Eq for ArticleFailureKind

impl StructuralPartialEq for ArticleFailureKind