Enum PlmError 

pub enum PlmError {
    Unreachable(String),
    SignIn(String),
    Forbidden(String),
    NotFound(String),
    Conflict(String),
    TooLarge(String),
    Throttled(String),
    Refused {
        status: u16,
        message: String,
    },
    Malformed(String),
    Version {
        server: String,
        min_client: String,
        client: String,
        reason: String,
    },
}

Why a call to the PLM did not do what was asked. Each variant keeps the server’s own sentence; Display shows it as the user should read it.

Variants

Unreachable(String)

No answer at all: the server is down, the address is wrong, the network dropped.

SignIn(String)

401: the credential is missing, expired or revoked. Sign in again.

Forbidden(String)

403: signed in, but the account or the token’s scope may not do this.

NotFound(String)

404: the part, revision or route does not exist.

Conflict(String)

409: locked by someone else, not checked out, or not editable. For a document write it arrives after write() returned, through the store’s write-behind error lane.

TooLarge(String)

413: over the server’s attachment limit.

Throttled(String)

429: the sign-in throttle.

Refused

Any other refusal (400, 5xx), with its status.

Fields

status: u16

message: String

Malformed(String)

The answer was not what the contract says (unparseable JSON, a missing field).

Version

Signed in, but this app and this server do not serve each other. Both versions are named. The file stores stay usable; the boot that falls back to them says so after this sentence.

Fields

server: String

min_client: String

client: String

reason: String

Implementations

impl PlmError

pub fn status(&self) -> Option<u16>

The HTTP status behind a refusal, if there was one.

pub fn from_response(response: &PlmResponse) -> Self

Map a non-success answer to its refusal, keeping the server’s sentence ({"error": "..."}, else the body text, else a sentence of our own).

Trait Implementations

impl Clone for PlmError

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 PlmError

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

Formats the value using the given formatter.

impl Display for PlmError

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

Formats the value using the given formatter.

impl PartialEq for PlmError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for PlmError