インストール
pip install base64hub # the library, in a virtual environment
pipx install base64hub # the b64 command, isolated
必要なのは Python 3.9 以降だけです。パッケージは標準ライブラリしか使わないので、インストールしても他のコードは入ってきません。
エンコード、デコード、検証
関数は 4 つで、型は Python で期待するとおりです。
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 は str(UTF-8 としてエンコード)またはバイト列を受け取り、str を返します。decode は bytes を返し、Base64 でない入力には ValueError のサブクラスである base64hub.Base64Error を送出します。validate は例外を送出せず、valid、variant、padded、bytes、error を持つ dict を返します。error には、入力が無効なときは理由が、それ以外は None が入ります。
base64hub と base64 モジュールの違い
標準の base64 モジュールは正確で高速です。ただ、雑な入力が貼り付けられる場面では厳しすぎ、文句を言うべき場面では甘すぎます。以下は 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
base64 モジュール | base64hub | |
|---|---|---|
= パディングの欠落 | Incorrect padding | 受け付ける |
| URLセーフな入力 | 別関数の urlsafe_b64decode | decode が受け付ける |
| 無効な文字 | validate=True でなければ黙って捨てる | ValueError |
| encode の戻り値の型 | bytes | str |
data: URI | なし | data_uri()。デコード時は取り除く |
自分のデータをエンコードするだけなら、標準ライブラリで十分です。その方法は Python での Base64 で紹介しています。ユーザー、ログ、JSON、URL から来る入力を扱い、正しい結果か明確なエラーのどちらかが欲しいときに base64hub を使ってください。
b64 コマンド
pipx install base64hub で、ネイティブ版の CLI と同じ b64 コマンドが使えるようになります。
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
Python 版は入力をメモリに読み込んでから処理し、Go 版はストリーム処理します。それ以外は、フラグも終了コードもまったく同じです。すべての関数とフラグは Python パッケージのドキュメント にあります。
よくある質問
Python で Base64 のコマンドラインツールをインストールするには?
pipx install base64hub を実行すると、専用の環境に b64 コマンドが入り、PATH から使えるようになります。仮想環境の中で pip install base64hub としてもかまいません。
base64.b64decode で Incorrect padding と出るのはなぜですか?
標準ライブラリは長さが 4 の倍数であることを求めるからです。base64hub.decode() は足りない = を自分で補うので、decode("SGVsbG8sIGh1YiE") は b'Hello, hub!' を返します。
base64hub はどの Python バージョンに対応していますか?
Python 3.9 以降です。標準ライブラリ以外の依存関係はありません。
種類がわからない URLセーフな Base64 を Python でデコードするには?
base64hub.decode() を呼びます。標準と URLセーフのアルファベットを、1 つの文字列の中で混在していても受け付けます。標準ライブラリでは、b64decode と urlsafe_b64decode のどちらを使うか自分で選ぶ必要があります。