Enum ForgeError 

#[non_exhaustive]
pub enum ForgeError {
    InvalidResource(ResourceError),
    WrongResource {
        resource: String,
        expected: String,
    },
    NotBound {
        namespace: String,
    },
    Unsupported {
        operation: String,
        hint: String,
    },
    NotFound {
        what: String,
    },
    AlreadyExists {
        resource: String,
        forge_id: Option<u64>,
    },
    Moved {
        what: String,
        location: String,
    },
    Unauthorized(String),
    Forbidden(String),
    Rejected {
        status: u16,
        message: String,
    },
    RateLimited {
        retry_after_secs: Option<u64>,
    },
    Unavailable(String),
    BindRejected(String),
    LinkFailed(String),
    Webhook(String),
    Config(String),
    Protocol(String),
    CapabilityChanged {
        namespace: String,
        capability: String,
        available: bool,
        reason: String,
    },
}

A failed forge operation.

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.

InvalidResource(ResourceError)

The input is not a valid forge-qualified resource.

WrongResource

The resource is valid but not on this adapter’s forge, or not the shape the operation needs (a namespace where a repo was expected).

Fields

resource: String

What was given.

expected: String

What the operation expected, in words.

NotBound

No namespace binding covers this resource, so the adapter holds no credential for it.

Fields

namespace: String

The namespace (host/owner) that has no binding.

Unsupported

The forge (or this namespace on it) cannot do this — see crate::Capabilities. hint says what a human can do instead.

Fields

operation: String

The operation that was refused.

hint: String

Why, and what to do instead.

NotFound

The resource does not exist, or the credential cannot see it (forges deliberately do not distinguish the two).

Fields

what: String

What was looked up.

AlreadyExists

Refused to create something that already exists. Carries the forge id so the core can tell its own earlier attempt from a squatter.

Fields

resource: String

The resource that exists.

forge_id: Option<u64>

The forge’s numeric id for it, when known.

Moved

The forge answered with a redirect the adapter will not follow — a renamed or transferred repository, usually.

Fields

what: String

What was requested.

location: String

Where the forge pointed.

Unauthorized(String)

The forge rejected the adapter’s credentials (expired, revoked, wrong key). Re-binding or rotating the key is the fix, not a retry.

Forbidden(String)

Authenticated, but not permitted — usually a permission the owner has not approved on the installation.

Rejected

The forge refused the request as invalid or conflicting (a rule violation, a validation failure).

Fields

status: u16

The forge’s status code.

message: String

The forge’s message.

RateLimited

Rate-limited. Retry after the given number of seconds, if the forge said.

Fields

retry_after_secs: Option<u64>

Seconds to wait, when the forge said.

Unavailable(String)

The forge could not be reached or failed (network, 5xx, timeout).

BindRejected(String)

A namespace bind callback did not match the bind that was started — wrong or stale state, or an installation on the wrong owner.

LinkFailed(String)

Linking a member’s forge account did not complete (expired, denied).

Webhook(String)

A webhook failed verification or could not be parsed. Always treat as hostile input: do not act on it.

Config(String)

The adapter or the bootstrap config is incomplete or invalid.

Protocol(String)

The forge answered with something the adapter does not understand.

CapabilityChanged

A capability of the namespace turned out different from what was planned with (a forge plan without a feature). The adapter has updated its own copy; the caller persists the change and plans again.

Fields

namespace: String

The namespace.

capability: String

Which crate::Capabilities field.

available: bool

Its new value.

reason: String

What the forge said.

Implementations

impl ForgeError

pub fn is_retryable(&self) -> bool

Whether retrying the same operation later can succeed without anyone changing anything. Rejections, auth failures and bad input are not.

Trait Implementations

impl Clone for ForgeError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ForgeError

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

Formats the value using the given formatter.

impl Display for ForgeError

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

Formats the value using the given formatter.

impl Eq for ForgeError

impl Error for ForgeError

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<ResourceError> for ForgeError

fn from(e: ResourceError) -> Self

Converts to this type from the input type.

impl PartialEq for ForgeError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for ForgeError