Instalação
pip install base64hub # the library, in a virtual environment
pipx install base64hub # the b64 command, isolated
Python 3.9 ou mais novo, e nada mais. O pacote usa só a biblioteca padrão, então a instalação não traz nenhum outro código junto.
Codificar, decodificar, validar
Quatro funções, com os tipos que você esperaria em 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='
O encode aceita str (convertida para UTF-8) ou bytes e retorna str. O decode retorna bytes e lança base64hub.Base64Error, uma subclasse de ValueError, quando a entrada não é Base64. O validate nunca lança exceção: ele retorna um dict com valid, variant, padded, bytes e error, que traz o motivo quando a entrada é inválida e None nos outros casos.
base64hub vs o módulo base64
O módulo base64 padrão é correto e rápido. Ele também é rígido onde as pessoas colam entradas bagunçadas e permissivo onde deveria reclamar. Estas são as saídas reais dele no 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
Módulo base64 | base64hub | |
|---|---|---|
Preenchimento = ausente | Incorrect padding | aceito |
| Entrada URL-safe | urlsafe_b64decode separado | aceita pelo decode |
| Caracteres inválidos | descartados, a menos que validate=True | ValueError |
| Tipo de retorno do encode | bytes | str |
URIs data: | não | data_uri(), e removido ao decodificar |
Se você só codifica os seus próprios dados, a biblioteca padrão basta; Base64 em Python mostra como. Use o base64hub quando a entrada vem de usuários, logs, JSON ou URLs e você quer um resultado correto ou um erro claro.
O comando b64
pipx install base64hub instala o mesmo comando b64 da CLI nativa:
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
A versão em Python lê a entrada para a memória antes de processá-la; a versão em Go trabalha em fluxo. Todo o resto, incluindo flags e códigos de saída, é idêntico. A documentação do Python lista todas as funções e flags.
Perguntas frequentes
Como instalar uma ferramenta Base64 de linha de comando com Python?
pipx install base64hub coloca o comando b64 no seu PATH, num ambiente próprio. pip install base64hub dentro de um ambiente virtual também funciona.
Por que o base64.b64decode dá Incorrect padding?
A biblioteca padrão exige um tamanho múltiplo de 4. O base64hub.decode() acrescenta sozinho o = que falta, então decode("SGVsbG8sIGh1YiE") retorna b'Hello, hub!'.
Quais versões do Python o base64hub suporta?
Python 3.9 ou mais novo. O pacote não tem dependências fora da biblioteca padrão.
Como decodificar Base64 URL-safe em Python sem saber a variante?
Chame o base64hub.decode(): ele aceita o alfabeto padrão e o URL-safe na mesma string. Com a biblioteca padrão, você mesmo precisa escolher entre b64decode e urlsafe_b64decode.