ファイルを選択
  1. base64hub
  2. ドキュメント
  3. Python パッケージ

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 を返します。

引数デフォルト効果
urlFalseURLセーフなアルファベット(- と _)。
padTrue= パディングを付ける。
wrap0N 文字ごとに \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"
キー意味
validdecode が成功する場合にだけ True。
variantstandard、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