Struct Refusal 

pub struct Refusal {
    pub status: u16,
    pub code: Option<String>,
    pub retry: Option<Retry>,
    pub message: String,
    pub details: Map<String, Value>,
}

A non-2xx answer to an upload, preflight, or mirror request.

Fields

status: u16

code: Option<String>

The server’s stable identifier for this refusal, when it sent one. None means a server without the vocabulary, to be read by status.

retry: Option<Retry>

message: String

For a person: the body’s message, else X-Reason, else the raw body.

details: Map<String, Value>

The numbers behind the message: limit, used, retry_after, mime.

Implementations

impl Refusal

pub fn from_response(status: u16, headers: &HeaderMap, body: &str) -> Self

Read a refusal out of a response. body may be empty (a HEAD has none), in which case the headers carry everything Magnitude sends.

pub fn code(&self) -> Option<&str>

pub fn limit(&self) -> Option<u64>

The per-file limit the server named, for a blob_too_large.

pub fn retry_after(&self) -> Option<Duration>

pub fn is_size_limit(&self) -> bool

The file is bigger than this server takes — a property of the file’s size, so worth remembering. A quota refusal is deliberately NOT this: it shares the 413 but says nothing about size.

pub fn is_mime(&self) -> bool

This server does not take this kind of file — worth remembering.

pub fn worth_retrying_here(&self) -> bool

Whether sending the same request to the same server again, right now, has any chance. A coded server is believed; an uncoded one is retried unless the status is one that never changes on a retry.

pub fn describe(&self, host: &str) -> String

One sentence for the person waiting on the upload.

Trait Implementations

impl Clone for Refusal

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 Refusal

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

Formats the value using the given formatter.

impl Eq for Refusal

impl PartialEq for Refusal

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Refusal