macaroons 0.3.0

Cookie-like bearer credentials with caveats for distributed authorization
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

use std::{fmt, result};
use std::error::Error as StdError;

#[derive(Debug, Eq, PartialEq, Copy, Clone)]
pub enum Error {
    VerificationFailed,
    FirstPartyCaveatFailed,
    Base64,
    PacketLength,
    SignatureLength,
    MalformedPacket,
    PacketOrdering,
    UnknownPacketType,
    MissingIdentifier,
    MissingSignature,
}

impl fmt::Display for Error {
    fn fmt(&self, fmt: &mut fmt::Formatter) -> fmt::Result {
        write!(fmt, "{}", self.description())
    }
}

impl StdError for Error {
    fn description(&self) -> &str {
        match *self {
            Error::VerificationFailed => "the token is inauthentic",
            Error::FirstPartyCaveatFailed => "a first-party caveat failed to verify",
            Error::Base64 => "unable to decode Base64",
            Error::PacketLength => "unable to decode packet length, or packet too long",
            Error::SignatureLength => "signature length incorrect",
            Error::MalformedPacket => "packet not properly structured",
            Error::PacketOrdering => "packet types are not in the right order",
            Error::UnknownPacketType => "packet found with unknown type",
            Error::MissingIdentifier => "no 'identifier' found at beginning of token",
            Error::MissingSignature => "no 'signature' found in token",
        }
    }
}

pub type Result<T> = result::Result<T, Error>;