Enum ProviderFailure 

pub enum ProviderFailure {
    UnknownProvider {
        name: ProviderName,
    },
    Unavailable {
        name: ProviderName,
        source: ProviderCreateError,
    },
    CreateFailed {
        name: ProviderName,
        source: ProviderCreateError,
    },
}

Failure recorded for one provider candidate.

Variants

UnknownProvider

No provider matched the candidate name.

Fields

name: ProviderName

Candidate provider name.

Unavailable

A provider matched the candidate name but is unavailable.

Fields

name: ProviderName

Candidate provider name.

source: ProviderCreateError

Provider-level unavailability error.

CreateFailed

A provider matched the candidate name but failed while creating a service.

Fields

name: ProviderName

Candidate provider name.

source: ProviderCreateError

Provider-level creation error.

Implementations

impl ProviderFailure

pub fn unknown(name: &str) -> Result<Self, ProviderRegistryError>

Creates an unknown-provider failure.

Parameters

• name: Candidate provider name.

Returns

Unknown-provider failure.

pub fn unavailable( name: &str, reason: &str, ) -> Result<Self, ProviderRegistryError>

Creates an unavailable-provider failure.

Parameters

• name: Candidate provider name.
• reason: Human-readable unavailability reason.

Returns

Unavailable-provider failure.

pub fn create_failed( name: &str, reason: &str, ) -> Result<Self, ProviderRegistryError>

Creates a provider-creation failure.

Parameters

• name: Candidate provider name.
• reason: Human-readable creation failure reason.

Returns

Provider-creation failure.

pub fn unavailable_from_error( name: &str, source: ProviderCreateError, ) -> Result<Self, ProviderRegistryError>

Creates an unavailable-provider failure from a provider-level error.

Parameters

• name: Candidate provider name.
• source: Provider-level unavailability error.

Returns

Unavailable-provider failure preserving the source error.

Errors

Returns ProviderRegistryError when name is not valid.

pub fn create_failed_from_error( name: &str, source: ProviderCreateError, ) -> Result<Self, ProviderRegistryError>

Creates a provider-creation failure from a provider-level error.

Parameters

• name: Candidate provider name.
• source: Provider-level creation error.

Returns

Provider-creation failure preserving the source error.

Errors

Returns ProviderRegistryError when name is not valid.

pub fn name(&self) -> &str

Gets the candidate provider name.

Returns

Candidate name associated with this failure.

pub fn provider_name(&self) -> &ProviderName

Gets the candidate provider name.

Returns

Candidate name associated with this failure.

Trait Implementations

impl Clone for ProviderFailure

fn clone(&self) -> ProviderFailure

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProviderFailure

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

Formats the value using the given formatter.

impl Display for ProviderFailure

fn fmt(&self, formatter: &mut Formatter<'_>) -> FmtResult

Formats the value using the given formatter.

impl Error for ProviderFailure

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.