base64-ng 2.0.1

no_std-first Base64 encoding and decoding with strict RFC 4648 APIs and optional SIMD
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
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

//! Explicit expert compatibility configurations.
//!
//! These ordinary codecs match the corresponding policy combinations in
//! `base64` 0.23.0. They are neither WHATWG forgiving Base64 nor secret
//! codecs. Strict applications should use the `STRICT_*` presets instead.

use super::{
    alphabet::{STANDARD_ALPHABET, URL_SAFE_ALPHABET},
    specifications::{
        Base64, DecodePadding, EncodePadding, RuntimeSpec, TrailingBits, compatibility_codec,
    },
};

macro_rules! preset {
    ($name:ident, $alphabet:expr, $encode:expr, $decode:expr, $trailing:expr, $doc:literal) => {
        #[doc = $doc]
        pub const $name: Base64<RuntimeSpec> =
            compatibility_codec($alphabet, $encode, $decode, $trailing);
    };
}

preset!(
    STANDARD_PADDED_PADDING_INDIFFERENT,
    STANDARD_ALPHABET,
    EncodePadding::Padded,
    DecodePadding::Indifferent,
    TrailingBits::RequireCanonical,
    "Standard encoding with padding and padding-indifferent canonical decoding."
);
preset!(
    STANDARD_UNPADDED_PADDING_INDIFFERENT,
    STANDARD_ALPHABET,
    EncodePadding::Unpadded,
    DecodePadding::Indifferent,
    TrailingBits::RequireCanonical,
    "Standard encoding without padding and padding-indifferent canonical decoding."
);
preset!(
    URL_SAFE_PADDED_PADDING_INDIFFERENT,
    URL_SAFE_ALPHABET,
    EncodePadding::Padded,
    DecodePadding::Indifferent,
    TrailingBits::RequireCanonical,
    "URL-safe encoding with padding and padding-indifferent canonical decoding."
);
preset!(
    URL_SAFE_UNPADDED_PADDING_INDIFFERENT,
    URL_SAFE_ALPHABET,
    EncodePadding::Unpadded,
    DecodePadding::Indifferent,
    TrailingBits::RequireCanonical,
    "URL-safe encoding without padding and padding-indifferent canonical decoding."
);

preset!(
    STANDARD_PADDED_ALLOW_NONCANONICAL_TRAILING_BITS,
    STANDARD_ALPHABET,
    EncodePadding::Padded,
    DecodePadding::RequireCanonical,
    TrailingBits::AllowNonCanonical,
    "Standard padded encoding and decoding that permits noncanonical trailing bits."
);
preset!(
    STANDARD_UNPADDED_ALLOW_NONCANONICAL_TRAILING_BITS,
    STANDARD_ALPHABET,
    EncodePadding::Unpadded,
    DecodePadding::Forbid,
    TrailingBits::AllowNonCanonical,
    "Standard unpadded encoding and decoding that permits noncanonical trailing bits."
);
preset!(
    URL_SAFE_PADDED_ALLOW_NONCANONICAL_TRAILING_BITS,
    URL_SAFE_ALPHABET,
    EncodePadding::Padded,
    DecodePadding::RequireCanonical,
    TrailingBits::AllowNonCanonical,
    "URL-safe padded encoding and decoding that permits noncanonical trailing bits."
);
preset!(
    URL_SAFE_UNPADDED_ALLOW_NONCANONICAL_TRAILING_BITS,
    URL_SAFE_ALPHABET,
    EncodePadding::Unpadded,
    DecodePadding::Forbid,
    TrailingBits::AllowNonCanonical,
    "URL-safe unpadded encoding and decoding that permits noncanonical trailing bits."
);

preset!(
    STANDARD_PADDED_FULL_COMPATIBILITY,
    STANDARD_ALPHABET,
    EncodePadding::Padded,
    DecodePadding::Indifferent,
    TrailingBits::AllowNonCanonical,
    "Standard padded encoding with padding-indifferent, noncanonical-bit decoding."
);
preset!(
    STANDARD_UNPADDED_FULL_COMPATIBILITY,
    STANDARD_ALPHABET,
    EncodePadding::Unpadded,
    DecodePadding::Indifferent,
    TrailingBits::AllowNonCanonical,
    "Standard unpadded encoding with padding-indifferent, noncanonical-bit decoding."
);
preset!(
    URL_SAFE_PADDED_FULL_COMPATIBILITY,
    URL_SAFE_ALPHABET,
    EncodePadding::Padded,
    DecodePadding::Indifferent,
    TrailingBits::AllowNonCanonical,
    "URL-safe padded encoding with padding-indifferent, noncanonical-bit decoding."
);
preset!(
    URL_SAFE_UNPADDED_FULL_COMPATIBILITY,
    URL_SAFE_ALPHABET,
    EncodePadding::Unpadded,
    DecodePadding::Indifferent,
    TrailingBits::AllowNonCanonical,
    "URL-safe unpadded encoding with padding-indifferent, noncanonical-bit decoding."
);