Datei hochladen
  1. base64hub
  2. Doku
  3. Python-Paket

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.

ArgumentStandardWirkung
urlFalseURL-sicheres Alphabet (- und _).
padTrue=-Padding anhängen.
wrap0Nach 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üsselBedeutung
validTrue genau dann, wenn decode gelingen würde.
variantstandard, url, mixed oder either; None bei ungültiger Eingabe.
paddedDie bereinigte Länge einschließlich = ist ein Vielfaches von 4; None bei ungültiger Eingabe.
bytesDekodierte Größe; None bei ungültiger Eingabe.
errorBei 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