Referenz zum Python-Paket
base64hub auf PyPI ist ein Modul für Python ab 3.9, das nur die Standardbibliothek nutzt, mit fünf Funktionen, einer Ausnahme und dem Befehl 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
Das Paket liefert Type Hints mit (py.typed).
encode(data, *, url=False, pad=True, wrap=0)
Kodiert Bytes oder einen str als UTF-8 und gibt einen str zurück.
| Argument | Standard | Wirkung |
|---|---|---|
url | False | URL-sicheres Alphabet (- und _). |
pad | True | =-Padding anhängen. |
wrap | 0 | Nach je N Zeichen \n einfügen, keins am Ende; 76 ist 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)
Dekodiert Base64 in bytes. Leerzeichen, Tabs und Zeilenumbrüche, ein Präfix data:...;base64,, fehlendes Padding und beide Alphabete werden akzeptiert. Ungültige Eingaben lösen Base64Error aus, eine Unterklasse von ValueError; bei einem falschen Zeichen sagen position und char, wo es steht und welches es ist.
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
Da Base64Error ein ValueError ist, funktionieren bestehende except ValueError-Blöcke weiter.
validate(text)
Prüft Text, ohne eine Ausnahme auszulösen, und gibt jedes Mal ein Dict mit denselben Schlüsseln zurück.
validate("-_-_")
# {'valid': True, 'variant': 'url', 'padded': True, 'bytes': 3, 'error': None}
validate("Zm9v!")["error"]
# "invalid character '!' at position 4"
| Schlüssel | Bedeutung |
|---|---|
valid | True genau dann, wenn decode gelingen würde. |
variant | standard, url, mixed oder either; None bei ungültiger Eingabe. |
padded | Die bereinigte Länge einschließlich = ist ein Vielfaches von 4; None bei ungültiger Eingabe. |
bytes | Dekodierte Größe; None bei ungültiger Eingabe. |
error | Bei ungültiger Eingabe der Grund, sonst None. |
data_uri(data, mime=None) und sniff_mime(data)
data_uri baut einen String data:<mime>;base64,<payload>: Standardalphabet, mit Padding, nie umbrochen. Ohne mime wählt sniff_mime den Typ: PNG, JPEG, GIF, WebP, PDF und SVG an der Signatur, text/plain;charset=utf-8 für UTF-8-Text, sonst 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'
Der Befehl b64
pipx install base64hub installiert b64. Flags, Meldungen und Exit-Codes entsprechen der CLI-Referenz. Der Python-Build liest die gesamte Eingabe in den Speicher, bevor er sie verarbeitet; für sehr große Dateien nehmen Sie den Go-Build.
Vergleich mit dem Modul base64
Die Standardbibliothek lehnt Eingaben ohne Padding ab (binascii.Error: Incorrect padding), verwirft stillschweigend Zeichen außerhalb des Alphabets, wenn Sie nicht validate=True übergeben, und braucht für URL-sichere Eingaben eine eigene Funktion. base64hub akzeptiert, was sich gefahrlos akzeptieren lässt, und löst für alles andere eine Ausnahme aus. Mehr zum Standardmodul unter Base64 in Python.
Aktualisiert 22.11.2026