Python パッケージ リファレンス
PyPI の base64hub は標準ライブラリだけで書かれた Python 3.9 以降向けのモジュールで、5 つの関数、1 つの例外、b64 コマンドを備えています。
インストール
pip install base64hub # library, inside a virtual environment
pipx install base64hub # b64 command
from base64hub import encode, decode, validate, data_uri, sniff_mime, Base64Error
パッケージには型ヒント(py.typed)が含まれています。
encode(data, *, url=False, pad=True, wrap=0)
バイト列、または str を UTF-8 としてエンコードし、str を返します。
| 引数 | デフォルト | 効果 |
|---|---|---|
url | False | URLセーフなアルファベット(- と _)。 |
pad | True | = パディングを付ける。 |
wrap | 0 | N 文字ごとに \n を入れる。末尾には入れない。76 は 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)
Base64 を bytes にデコードします。空白、タブ、改行、data:...;base64, 接頭辞、パディングの欠落、両方のアルファベットを受け付けます。無効な入力では ValueError のサブクラスである Base64Error を送出し、問題の文字については position と char で位置と文字がわかります。
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
Base64Error は ValueError なので、既存の except ValueError ブロックはそのまま動きます。
validate(text)
例外を送出せずにテキストをチェックし、常に同じキーを持つ dict を返します。
validate("-_-_")
# {'valid': True, 'variant': 'url', 'padded': True, 'bytes': 3, 'error': None}
validate("Zm9v!")["error"]
# "invalid character '!' at position 4"
| キー | 意味 |
|---|---|
valid | decode が成功する場合にだけ True。 |
variant | standard、url、mixed、either のいずれか。無効なときは None。 |
padded | = を含めた整形後の長さが 4 の倍数かどうか。無効なときは None。 |
bytes | デコード後のサイズ。無効なときは None。 |
error | 無効なときはその理由、それ以外は None。 |
data_uri(data, mime=None) と sniff_mime(data)
data_uri は data:<mime>;base64,<payload> 形式の文字列を作ります。標準アルファベットでパディング付き、折り返しはしません。mime を省略すると sniff_mime がタイプを選びます。PNG、JPEG、GIF、WebP、PDF、SVG はシグネチャで判定し、UTF-8 テキストなら text/plain;charset=utf-8、それ以外は 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'
b64 コマンド
pipx install base64hub で b64 がインストールされます。フラグ、メッセージ、終了コードは CLI リファレンス と同じです。Python 版は入力全体をメモリに読み込んでから処理します。非常に大きなファイルには Go 版を使ってください。
base64 モジュールとの比較
標準ライブラリは、パディングのない入力を拒否し(binascii.Error: Incorrect padding)、validate=True を渡さない限りアルファベット外の文字を黙って捨て、URLセーフな入力には別の関数が必要です。base64hub は受け付けても安全なものを受け付け、それ以外では例外を送出します。標準モジュールについては Python での Base64 で詳しく説明しています。
更新日 2026/11/22