Загрузить файл
  1. base64hub
  2. Скачать
  3. Пакет для Python
v1.0.0 · Открытый код · MIT

base64hub в PyPI: библиотека Base64 и CLI для Python

base64hub в PyPI оборачивает Base64 из стандартной библиотеки в более удобный API: на входе текст, на выходе строки Base64, декодирование понимает данные такими, какими их вставляют на практике, а в комплекте есть команда b64.

pip install base64hub
Бесплатно без аккаунта и ключа MIT открытая лицензия Ноль зависимостей во время выполнения Обновлено 22 нояб. 2026 г.

Установка

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
модуль base64base64hub
Нет дополнения =Incorrect paddingпринимается
URL-safe на входеотдельная urlsafe_b64decodeпринимает decode
Недопустимые символыотбрасываются, если не указать validate=TrueValueError
Тип результата encodebytesstr
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.

Ещё от base64hub