Enum ProviderError 

#[non_exhaustive]
pub enum ProviderError {
    NotFound {
        what: String,
    },
    Unauthorized {
        host: String,
    },
    RateLimited {
        host: String,
        retry_after: Option<Duration>,
    },
    Transport(String),
    MalformedResponse(String),
    Unsupported,
    InvalidConfig(String),
    Io(Arc<Error>),
}

Every failure mode a ReleaseProvider can surface.

Clone is derived so callers can route error values through retry policies or stash them in rendered diagnostics without losing the underlying io::Error. The Io variant wraps in Arc for that reason — the same pattern used in rtb-credentials::CredentialError.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

NotFound

Release or asset does not exist, or the caller lacks permission to see it (drafts for unauthenticated callers map here).

Fields

what: String

Describes what was missing: a tag name, an asset filename, or a repo coordinate.

Unauthorized

The host rejected our credentials.

Fields

host: String

The host that issued the 401.

RateLimited

The host rate-limited us. retry_after is populated when the response carried a Retry-After header or equivalent.

Fields

host: String

The host that issued the rate-limit response.

retry_after: Option<Duration>

Duration the host asked us to wait before retrying. None when the response didn’t carry a Retry-After.

Transport(String)

The request didn’t reach the server, or the response never completed.

MalformedResponse(String)

The server replied with a body we couldn’t parse into the expected shape.

Unsupported

The call is not applicable to this backend. Bitbucket Cloud surfaces this for list_releases — there is no native listing endpoint and synthesising one by walking tags defeats the point of the abstraction.

InvalidConfig(String)

Factory-time validation failed — invalid host, missing required params, HTTP-only URL where HTTPS is mandatory, etc.

Io(Arc<Error>)

Wrapped std::io::Error — Arc keeps the enum Clone without losing the underlying kind.

Trait Implementations

impl Clone for ProviderError

fn clone(&self) -> ProviderError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderError

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

Formats the value using the given formatter.

impl Diagnostic for ProviderError

fn code(&self) -> Option<Box<dyn Display + '_>>

Unique diagnostic code that can be used to look up more information about this Diagnostic. Ideally also globally unique, and documented in the toplevel crate’s documentation for easy searching. Rust path format (foo::bar::baz) is recommended, but more classic codes like E0123 or enums will work just fine.

fn help(&self) -> Option<Box<dyn Display + '_>>

Additional help text related to this Diagnostic. Do you have any advice for the poor soul who’s just run into this issue?

fn severity(&self) -> Option<Severity>

Diagnostic severity. This may be used by ReportHandlers to change the display format of this diagnostic.

fn url<'a>(&'a self) -> Option<Box<dyn Display + 'a>>

URL to visit for a more detailed explanation/help about this Diagnostic.

fn source_code(&self) -> Option<&dyn SourceCode>

Source code to apply this Diagnostic’s Diagnostic::labels to.

fn labels(&self) -> Option<Box<dyn Iterator<Item = LabeledSpan> + '_>>

Labels to apply to this Diagnostic’s Diagnostic::source_code

fn related<'a>( &'a self, ) -> Option<Box<dyn Iterator<Item = &'a dyn Diagnostic> + 'a>>

Additional related Diagnostics.

fn diagnostic_source(&self) -> Option<&dyn Diagnostic>

The cause of the error.

impl Display for ProviderError

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

Formats the value using the given formatter.

impl Error for ProviderError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Arc<Error>> for ProviderError

fn from(source: Arc<Error>) -> Self

Converts to this type from the input type.

impl From<Error> for ProviderError

fn from(err: Error) -> Self

Converts to this type from the input type.