ファイルを選択
  1. base64hub
  2. ダウンロード
  3. Python パッケージ
v1.0.0 · オープンソース · MIT

PyPI の base64hub:Python 用 Base64 ライブラリと CLI

PyPI の base64hub は、標準ライブラリの Base64 を使いやすい API で包んだパッケージです。テキストを渡せば Base64 文字列が返り、デコードは現実の入力に対応し、b64 コマンドも付いています。

pip install base64hub
無料 アカウント不要・キー不要 MIT オープンソースライセンス ゼロ 実行時の依存関係 更新日 2026/11/22

インストール

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_b64decodedecode が受け付ける
無効な文字validate=True でなければ黙って捨てるValueError
encode の戻り値の型bytesstr
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 のどちらを使うか自分で選ぶ必要があります。

base64hub のほかの製品