Enum PubSubError 

#[non_exhaustive]
pub enum PubSubError {
    Connect(Box<dyn StdError + Send + Sync>),
    Admin {
        name: String,
        source: Box<dyn StdError + Send + Sync>,
    },
    Receive {
        subscription: String,
        source: Box<dyn StdError + Send + Sync>,
    },
    Publish {
        topic: String,
        source: Box<dyn StdError + Send + Sync>,
    },
    NotConnected,
    InvalidDescriptor(String),
}

Errors returned by the Google Cloud Pub/Sub broker.

One enum for the whole crate, variants by source, per the RustStream broker conventions. The wrapped sources are boxed std errors so the public API does not leak the client’s error types.

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.

Connect(Box<dyn StdError + Send + Sync>)

Building a client (authentication or connection setup) failed.

Admin

A topic or subscription admin call failed.

Fields

name: String

The resource the call was about.

source: Box<dyn StdError + Send + Sync>

The client’s failure.

Receive

The streaming pull failed permanently (transient failures are retried by the client).

Fields

subscription: String

The subscription the stream was pulling from.

source: Box<dyn StdError + Send + Sync>

The client’s failure.

Publish

Publishing to a topic failed.

Fields

topic: String

The topic the message was published to.

source: Box<dyn StdError + Send + Sync>

The client’s failure.

NotConnected

The handle is used before connect filled the shared connection, or after shutdown.

InvalidDescriptor(String)

A subscription descriptor is invalid.

Trait Implementations

impl Debug for PubSubError

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

Formats the value using the given formatter.

impl Display for PubSubError

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

Formats the value using the given formatter.

impl Error for PubSubError

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.