Struct serde_with::base64::Base64

pub struct Base64<ALPHABET: Alphabet = Standard, PADDING: Format = Padded>(/* private fields */);

Available on crate feature base64 only.

Serialize bytes with base64

The type serializes a sequence of bytes as a base64 string. It works on any type implementing AsRef<[u8]> for serialization and TryFrom<Vec<u8>> for deserialization.

The type allows customizing the character set and the padding behavior. The ALPHABET is a type implementing Alphabet. PADDING specifies if serializing should emit padding. Deserialization always supports padded and unpadded formats. formats::Padded emits padding and formats::Unpadded leaves it off.

use serde_with::base64::{Base64, Bcrypt, BinHex, Standard};
use serde_with::formats::{Padded, Unpadded};

#[serde_as]
#[derive(Serialize, Deserialize)]
struct B64 {
    // The default is the same as Standard character set with padding
    #[serde_as(as = "Base64")]
    default: Vec<u8>,
    // Only change the character set, implies padding
    #[serde_as(as = "Base64<BinHex>")]
    charset_binhex: Vec<u8>,

    #[serde_as(as = "Base64<Standard, Padded>")]
    explicit_padding: Vec<u8>,
    #[serde_as(as = "Base64<Bcrypt, Unpadded>")]
    no_padding: Vec<u8>,
}

let b64 = B64 {
    default: b"Hello World".to_vec(),
    charset_binhex: b"Hello World".to_vec(),
    explicit_padding: b"Hello World".to_vec(),
    no_padding: b"Hello World".to_vec(),
};
let json = serde_json::json!({
    "default": "SGVsbG8gV29ybGQ=",
    "charset_binhex": "5'8VD'mI8epaD'3=",
    "explicit_padding": "SGVsbG8gV29ybGQ=",
    "no_padding": "QETqZE6eT07wZEO",
});

// Test serialization and deserialization
assert_eq!(json, serde_json::to_value(&b64).unwrap());
assert_eq!(b64, serde_json::from_value(json).unwrap());

Trait Implementations

impl<'de, T, ALPHABET, FORMAT> DeserializeAs<'de, T> for Base64<ALPHABET, FORMAT>

where T: TryFrom<Vec<u8>>, ALPHABET: Alphabet, FORMAT: Format,

fn deserialize_as<D>(deserializer: D) -> Result<T, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T, ALPHABET> SerializeAs<T> for Base64<ALPHABET, Padded>

where T: AsRef<[u8]>, ALPHABET: Alphabet,

fn serialize_as<S>(source: &T, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T, ALPHABET> SerializeAs<T> for Base64<ALPHABET, Unpadded>

where T: AsRef<[u8]>, ALPHABET: Alphabet,

fn serialize_as<S>(source: &T, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.