Installation
pip install base64hub # the library, in a virtual environment
pipx install base64hub # the b64 command, isolated
Python 3.9 ou ultérieur, rien d’autre. Le paquet n’utilise que la bibliothèque standard : son installation n’apporte aucun autre code.
Encoder, décoder, valider
Quatre fonctions, avec les types que l’on attend en Python :
from base64hub import encode, decode, validate, data_uri
encode("Hello, hub!") # 'SGVsbG8sIGh1YiE='
encode("Привет", url=True, pad=False) # '0J_RgNC40LLQtdGC'
encode(b"foobar", wrap=4) # 'Zm9v\nYmFy'
decode("SGVsbG8sIGh1YiE") # b'Hello, hub!'
decode("data:text/plain;base64,SGk=") # b'Hi'
validate("+/+/")["variant"] # 'standard'
data_uri(b"Hi") # 'data:text/plain;charset=utf-8;base64,SGk='
encode prend une str (encodée en UTF-8) ou des octets et renvoie une str. decode renvoie des bytes et lève base64hub.Base64Error, une sous-classe de ValueError, pour une entrée qui n’est pas du Base64. validate ne lève jamais d’exception : il renvoie un dict avec valid, variant, padded, bytes et error, qui contient la raison quand l’entrée est invalide et None sinon.
base64hub ou le module base64
Le module standard base64 est correct et rapide. Il est aussi strict là où l’on colle des entrées désordonnées, et laxiste là où il devrait protester. Voici ses sorties réelles sous Python 3.13 :
import base64
base64.b64decode("SGVsbG8sIGh1YiE") # binascii.Error: Incorrect padding
base64.b64decode("Zm9v!YmFy") # b'foobar', the "!" is dropped silently
base64.b64decode("-_-_") # b'', URL-safe characters are dropped
module base64 | base64hub | |
|---|---|---|
Remplissage = manquant | Incorrect padding | accepté |
| Entrée URL-safe | urlsafe_b64decode séparé | acceptée par decode |
| Caractères invalides | ignorés sauf avec validate=True | ValueError |
| Type renvoyé par encode | bytes | str |
URI data: | non | data_uri(), et retirées au décodage |
Si vous n’encodez que vos propres données, la bibliothèque standard suffit ; Base64 en Python montre comment faire. Passez à base64hub quand l’entrée vient d’utilisateurs, de journaux, de JSON ou d’URL et que vous voulez soit un résultat correct, soit une erreur claire.
La commande b64
pipx install base64hub vous donne la même commande b64 que la CLI native :
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
La version Python charge l’entrée en mémoire avant de la traiter ; la version Go travaille en flux. Tout le reste, options et codes de sortie compris, est identique. La documentation Python liste chaque fonction et chaque option.
FAQ
Comment installer un outil Base64 en ligne de commande avec Python ?
pipx install base64hub place la commande b64 dans votre PATH, dans son propre environnement. pip install base64hub dans un environnement virtuel fonctionne aussi.
Pourquoi base64.b64decode affiche-t-il « Incorrect padding » ?
La bibliothèque standard exige une longueur multiple de 4. base64hub.decode() ajoute lui-même les = manquants : decode("SGVsbG8sIGh1YiE") renvoie donc b'Hello, hub!'.
Quelles versions de Python base64hub prend-il en charge ?
Python 3.9 et versions ultérieures. Le paquet n’a aucune dépendance en dehors de la bibliothèque standard.
Comment décoder du Base64 URL-safe en Python sans connaître la variante ?
Appelez base64hub.decode() : il accepte l’alphabet standard et l’alphabet URL-safe dans la même chaîne. Avec la bibliothèque standard, c’est à vous de choisir entre b64decode et urlsafe_b64decode.