Charger un fichier
  1. base64hub
  2. Docs
  3. Paquet Python

Référence du paquet Python

base64hub sur PyPI est un module qui ne dépend que de la bibliothèque standard, pour Python 3.9 et ultérieur, avec cinq fonctions, une exception et la commande b64.

Installation

pip install base64hub      # library, inside a virtual environment
pipx install base64hub     # b64 command
from base64hub import encode, decode, validate, data_uri, sniff_mime, Base64Error

Le paquet fournit des annotations de type (py.typed).

encode(data, *, url=False, pad=True, wrap=0)

Encode des octets, ou une str en UTF-8, et renvoie une str.

ArgumentPar défautEffet
urlFalseAlphabet URL-safe (- et _).
padTrueAjoute le remplissage =.
wrap0Insère \n tous les N caractères, jamais à la fin ; 76 correspond à MIME.
encode("Hello, hub!")                  # 'SGVsbG8sIGh1YiE='
encode("Привет", url=True, pad=False)  # '0J_RgNC40LLQtdGC'
encode(b"foobar", wrap=4)              # 'Zm9v\nYmFy'
encode(b"\xfb\xff\xbf")                # '+/+/'

decode(text)

Décode du Base64 en bytes. Les espaces, tabulations et sauts de ligne, un préfixe data:...;base64,, le remplissage manquant et les deux alphabets sont acceptés. Une entrée invalide lève Base64Error, une sous-classe de ValueError ; pour un caractère fautif, position et char indiquent où et lequel.

decode("SGVsbG8sIGh1YiE")               # b'Hello, hub!'
decode("Zm9v YmFy")                     # b'foobar'
decode("data:text/plain;base64,SGk=")   # b'Hi'

try:
    decode("Zm9v!")
except Base64Error as e:
    print(e, e.position)                # invalid character '!' at position 4 4

Comme Base64Error est une ValueError, les blocs except ValueError existants continuent de fonctionner.

validate(text)

Vérifie un texte sans lever d’exception et renvoie un dict qui a toujours les mêmes clés.

validate("-_-_")
# {'valid': True, 'variant': 'url', 'padded': True, 'bytes': 3, 'error': None}
validate("Zm9v!")["error"]
# "invalid character '!' at position 4"
CléSignification
validTrue exactement quand decode réussirait.
variantstandard, url, mixed ou either ; None si invalide.
paddedLa longueur nettoyée, = compris, est un multiple de 4 ; None si invalide.
bytesTaille décodée ; None si invalide.
errorLa raison si invalide, sinon None.

data_uri(data, mime=None) et sniff_mime(data)

data_uri construit une chaîne data:<mime>;base64,<payload>, avec l’alphabet standard et le remplissage, jamais coupée. Sans mime, c’est sniff_mime qui choisit le type : PNG, JPEG, GIF, WebP, PDF et SVG d’après leur signature, text/plain;charset=utf-8 pour du texte UTF-8, sinon application/octet-stream.

data_uri(b"Hi")                         # 'data:text/plain;charset=utf-8;base64,SGk='
data_uri(b"a,b", mime="text/csv")       # 'data:text/csv;base64,YSxi'
sniff_mime(b"\x89PNG\r\n\x1a\n")        # 'image/png'

La commande b64

pipx install base64hub installe b64. Options, messages et codes de sortie correspondent à la référence de la CLI. La version Python charge toute l’entrée en mémoire avant de la traiter ; pour de très gros fichiers, utilisez la version Go.

Comparaison avec le module base64

La bibliothèque standard rejette les entrées sans remplissage (binascii.Error: Incorrect padding), ignore sans rien dire les caractères hors de l’alphabet sauf si vous passez validate=True, et demande une fonction à part pour les entrées URL-safe. base64hub accepte ce qui peut l’être sans risque et lève une exception pour le reste. Plus de détails sur le module standard dans Base64 en Python.

Mis à jour 22 nov. 2026