base64-0.4.2.3: A modern RFC 4648-compliant Base64 library
Copyright(c) 2019-2020 Emily Pillmore
LicenseBSD-style
MaintainerEmily Pillmore <emilypi@cohomolo.gy>
Stabilitystable
Portabilitynon-portable
Safe HaskellTrustworthy
LanguageHaskell2010

Data.ByteString.Short.Base64

Description

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.

Synopsis

Encoding

encodeBase64 :: ShortByteString -> ShortText Source #

Encode a ShortByteString value as Base64 ShortText with padding.

See: RFC-4648 section 4

Examples:

>>> encodeBase64 "Sun"
"U3Vu"

encodeBase64' :: ShortByteString -> ShortByteString Source #

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 Source #

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 Source #

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 Source #

Tell whether a ShortByteString value is base64 encoded.

Examples:

>>> isBase64 "U3Vu"
True
>>> isBase64 "U3V"
False
>>> isBase64 "U3V="
False

isValidBase64 :: ShortByteString -> Bool Source #

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