Skip to main content

Error

Enum Error 

Source
#[non_exhaustive]
pub enum Error { InvalidTypeName { name: String, }, UnexpectedItem { expected: MessageType, got: MessageType, }, UnsendableFilterValue { filter: String, value: String, }, Config { msg: String, }, ReqWest { reqwest: Error, }, ValidationFailure { failures: Failures, }, RateLimited { attempts: u32, limit: RateLimit, }, ResourceNotFound { resource: Box<ResourceComponent>, }, Serde { error: Error, }, }
Expand description

All different error types this crate uses.

Variants (Non-exhaustive)§

This enum is marked as 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.
§

InvalidTypeName

if an invalid type was requested

Fields

§name: String

the type name that was invalid

§

UnexpectedItem

if there is a mismatch between the expected return type of the crossref api and this rust client

Fields

§expected: MessageType

the message type this client expected

§got: MessageType

the message type crossref actually returned

§

UnsendableFilterValue

a filter value crossref has no way to read back

Crossref splits the filter value on , after percent-decoding it, so a value carrying one arrives as two filters – container-title:A, B becomes container-title:A plus a filter called B. There is no form that survives the split, so the request is refused rather than sent to be rejected with a 400.

Fields

§filter: String

the filter whose value cannot be sent, e.g. container-title

§value: String

the value that carries the ,

§

Config

a config error

Fields

§msg: String

the notification

§

ReqWest

an error that occurred while operating with reqwest

Fields

§reqwest: Error

the underlying transport error

§

ValidationFailure

crossref refused the request and said why

Answered with a 400 and a validation-failure body, which is what an unknown filter, sort field or field query produces.

Fields

§failures: Failures

what crossref objected to

§

RateLimited

crossref kept answering 429 until the retry budget ran out

The client paces itself against the limit crossref reports, so this normally means requests are also being made outside it – from another process, or another Crossref built separately rather than cloned.

Fields

§attempts: u32

how many times the request was sent

§limit: RateLimit

the budget crossref last reported

§

ResourceNotFound

When crossref could not find anything

Fields

§resource: Box<ResourceComponent>

the resource that could not be resolved

§

Serde

if a error in serde occurred

Fields

§error: Error

the underlying (de)serialization error

Trait Implementations§

Source§

impl Debug for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Display for Error

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Error for Error

Source§

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

Returns the lower-level source of this error, if any. Read more
1.0.0 · Source§

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

1.0.0 · Source§

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

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

Source§

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. Read more
Source§

impl From<Error> for Error

Source§

fn from(source: Error) -> Self

Converts to this type from the input type.
Source§

impl From<Error> for Error

Source§

fn from(source: Error) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl !RefUnwindSafe for Error

§

impl !UnwindSafe for Error

§

impl Freeze for Error

§

impl Send for Error

§

impl Sync for Error

§

impl Unpin for Error

§

impl UnsafeUnpin for Error

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self> ⓘ

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> PolicyExt for T
where T: ?Sized,

Source§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more
Source§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more