Installation
pip install base64hub # the library, in a virtual environment
pipx install base64hub # the b64 command, isolated
Python 3.9 oder neuer, sonst nichts. Das Paket nutzt nur die Standardbibliothek, die Installation zieht also keinen weiteren Code nach.
Kodieren, dekodieren, prüfen
Vier Funktionen mit den Typen, die Sie in Python erwarten würden:
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 nimmt str (als UTF-8 kodiert) oder Bytes und gibt str zurück. decode gibt bytes zurück und löst bei Eingaben, die kein Base64 sind, base64hub.Base64Error aus, eine Unterklasse von ValueError. validate löst nie eine Ausnahme aus: Es gibt ein Dict mit valid, variant, padded, bytes und error zurück; error enthält bei ungültiger Eingabe den Grund, sonst None.
base64hub im Vergleich zum Modul base64
Das Standardmodul base64 ist korrekt und schnell. Es ist aber streng, wo Leute unsaubere Eingaben einfügen, und nachlässig, wo es sich beschweren sollte. Das sind seine echten Ausgaben unter 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
Modul base64 | base64hub | |
|---|---|---|
Fehlendes =-Padding | Incorrect padding | wird akzeptiert |
| URL-sichere Eingabe | eigene Funktion urlsafe_b64decode | von decode akzeptiert |
| Ungültige Zeichen | verworfen, außer mit validate=True | ValueError |
| Rückgabetyp von encode | bytes | str |
data:-URIs | nein | data_uri(), beim Dekodieren entfernt |
Wenn Sie nur eigene Daten kodieren, reicht die Standardbibliothek; Base64 in Python zeigt, wie. Greifen Sie zu base64hub, wenn Eingaben von Nutzern, aus Logs, JSON oder URLs kommen und Sie entweder ein korrektes Ergebnis oder einen klaren Fehler wollen.
Der Befehl b64
pipx install base64hub liefert denselben Befehl b64 wie das native CLI:
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
Der Python-Build liest die Eingabe in den Speicher, bevor er sie verarbeitet; der Go-Build streamt. Alles andere, auch Flags und Exit-Codes, ist identisch. Die Python-Doku listet jede Funktion und jedes Flag.
Häufige Fragen
Wie installiere ich ein Base64-Kommandozeilentool mit Python?
pipx install base64hub legt den Befehl b64 in einer eigenen Umgebung auf Ihren PATH. pip install base64hub in einer virtuellen Umgebung funktioniert ebenfalls.
Warum meldet base64.b64decode Incorrect padding?
Die Standardbibliothek besteht auf einer Länge, die ein Vielfaches von 4 ist. base64hub.decode() ergänzt das fehlende = selbst, decode("SGVsbG8sIGh1YiE") liefert also b'Hello, hub!'.
Welche Python-Versionen unterstützt base64hub?
Python 3.9 und neuer. Das Paket hat keine Abhängigkeiten außerhalb der Standardbibliothek.
Wie dekodiere ich URL-sicheres Base64 in Python, ohne die Variante zu kennen?
Rufen Sie base64hub.decode() auf: Es akzeptiert das Standard- und das URL-sichere Alphabet im selben String. Mit der Standardbibliothek müssen Sie selbst zwischen b64decode und urlsafe_b64decode wählen.