huskarl-core 0.4.1

Base library for huskarl (OAuth2 client) ecosystem.
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
42
43
44
45
46
47
48
49
50
51
52
53
54

//! Encodings for binary secrets.

mod base64;
mod binary;
mod hex;
mod string;

use std::str::Utf8Error;

use snafu::Snafu;

use crate::platform::MaybeSendSync;

pub use base64::Base64Encoding;
pub use binary::BinaryEncoding;
pub use hex::HexEncoding;
pub use string::StringEncoding;

/// Trait for decoding raw bytes into a typed secret.
pub trait SecretDecoder: Clone + MaybeSendSync {
    /// The type of secret this encoding produces.
    type Output: Clone + MaybeSendSync;

    /// Decodes raw bytes into the secret type.
    ///
    /// # Errors
    ///
    /// Returns an error if the bytes cannot be decoded (e.g., invalid UTF-8,
    /// invalid hex characters).
    fn decode(&self, bytes: &[u8]) -> Result<Self::Output, DecodingError>;
}

/// Errors that can occur when decoding a secret.
#[derive(Debug, Snafu)]
pub enum DecodingError {
    /// The bytes are not valid UTF-8.
    #[snafu(display("Invalid UTF-8"))]
    InvalidUtf8 {
        /// The underlying error.
        source: Utf8Error,
    },
    /// The string is not valid hexadecimal.
    #[snafu(display("Invalid hex"))]
    InvalidHex {
        /// The underlying error.
        source: ::hex::FromHexError,
    },
    /// The string is not valid base64.
    #[snafu(display("Invalid base64"))]
    InvalidBase64 {
        /// The underlying error.
        source: ::base64::DecodeError,
    },
}