上传文件
  1. base64hub
  2. 下载
  3. Python 包
v1.0.0 · 开源 · MIT

PyPI 上的 base64hub:Python Base64 库和命令行工具

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 或更高版本。这个包只使用标准库,安装时不会引入其他任何代码。

编码、解码、校验

四个函数,类型都符合 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 编码)或 bytes,返回 str。decode 返回 bytes,遇到不是 Base64 的输入时抛出 base64hub.Base64Error,它是 ValueError 的子类。validate 从不抛出异常:它返回一个包含 valid、variant、padded、bytes 和 error 的字典,输入无效时 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=TrueValueError
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 及更高版本。除标准库外,这个包没有任何依赖。

不知道是哪种变体时,怎样在 Python 中解码 URL 安全的 Base64?

调用 base64hub.decode():它在同一个字符串中同时接受标准字母表和 URL 安全字母表。用标准库的话,你得自己在 b64decode 和 urlsafe_b64decode 之间做选择。

base64hub 的更多产品