Установка
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) или байты и возвращает 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-safe на входе | отдельная urlsafe_b64decode | принимает decode |
| Недопустимые символы | отбрасываются, если не указать validate=True | ValueError |
| Тип результата encode | bytes | str |
data: URI | нет | data_uri(), при декодировании префикс отбрасывается |
Если вы кодируете только собственные данные, стандартной библиотеки достаточно; как с ней работать, показано в статье Base64 в Python. base64hub пригодится, когда данные приходят от пользователей, из логов, JSON или URL и нужен либо правильный результат, либо понятная ошибка.
Команда b64
pipx install base64hub даёт ту же команду b64, что и нативный CLI:
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
Сборка для Python сначала читает входные данные в память, а сборка на Go работает потоково. Всё остальное, включая флаги и коды выхода, совпадает. Все функции и флаги описаны в документации пакета для Python.
Вопросы и ответы
Как установить утилиту Base64 для командной строки через Python?
pipx install base64hub добавляет команду b64 в PATH, а сам пакет живёт в отдельном окружении. Подойдёт и pip install base64hub внутри виртуального окружения.
Почему base64.b64decode пишет Incorrect padding?
Стандартная библиотека требует длину, кратную 4. base64hub.decode() сам добавляет недостающие =, поэтому decode("SGVsbG8sIGh1YiE") возвращает b'Hello, hub!'.
Какие версии Python поддерживает base64hub?
Python 3.9 и новее. У пакета нет зависимостей вне стандартной библиотеки.
Как декодировать URL-safe Base64 в Python, не зная варианта?
Вызовите base64hub.decode(): он принимает стандартный и URL-safe алфавит даже в одной строке. Со стандартной библиотекой придётся самому выбирать между b64decode и urlsafe_b64decode.