Data.ByteString.Short.Base64

This module contains ShortByteString-valued combinators for implementing the RFC 4648 specification of the Base64 encoding format. This includes lenient decoding variants, as well as internal and external validation for canonicity.

Encoding

encodeBase64 :: ShortByteString -> ShortText

Encode a ShortByteString value as Base64 ShortText with padding.

See: RFC-4648 section 4

Examples:

>>> encodeBase64 "Sun"
"U3Vu"

encodeBase64' :: ShortByteString -> ShortByteString

Encode a ShortByteString value as a Base64 ShortByteString value with padding.

See: RFC-4648 section 4

Examples:

>>> encodeBase64' "Sun"
"U3Vu"

Decoding

decodeBase64 :: ShortByteString -> Either Text ShortByteString

Decode a padded Base64-encoded ShortByteString value.

See: RFC-4648 section 4

Examples:

>>> decodeBase64 "U3Vu"
Right "Sun"

>>> decodeBase64 "U3V"
Left "Base64-encoded bytestring requires padding"

>>> decodebase64 "U3V="
Left "non-canonical encoding detected at offset: 2"

decodeBase64Lenient :: ShortByteString -> ShortByteString

Leniently decode an unpadded Base64-encoded ShortByteString value. This function will not generate parse errors. If input data contains padding chars, then the input will be parsed up until the first pad character.

Note: This is not RFC 4648-compliant.

Examples:

>>> decodeBase64Lenient "U3Vu"
"Sun"

>>> decodeBase64Lenient "U3V"
"Su"

>>> decodebase64Lenient "U3V="
"Su"

Validation

isBase64 :: ShortByteString -> Bool

Tell whether a ShortByteString value is base64 encoded.

Examples:

>>> isBase64 "U3Vu"
True

>>> isBase64 "U3V"
False

>>> isBase64 "U3V="
False

isValidBase64 :: ShortByteString -> Bool

Tell whether a ShortByteString value is a valid Base64 format.

This will not tell you whether or not this is a correct Base64url representation, only that it conforms to the correct shape. To check whether it is a true Base64 encoded ShortByteString value, use isBase64.

Examples:

>>> isValidBase64 "U3Vu"
True

>>> isValidBase64 "U3V"
True

>>> isValidBase64 "U3V="
True

>>> isValidBase64 "%"
False