Enviar um arquivo
  1. base64hub
  2. Downloads
  3. Pacote Python
v1.0.0 · Código aberto · MIT

base64hub no PyPI: biblioteca Base64 e CLI para Python

O base64hub no PyPI envolve o Base64 da biblioteca padrão numa API mais amigável: texto na entrada e strings Base64 na saída, uma decodificação que lida com entradas do mundo real, e o comando b64.

pip install base64hub
Grátis sem conta, sem chave MIT licença de código aberto Zero dependências em tempo de execução Atualizado 22 de nov. de 2026

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 base64base64hub
Preenchimento = ausenteIncorrect paddingaceito
Entrada URL-safeurlsafe_b64decode separadoaceita pelo decode
Caracteres inválidosdescartados, a menos que validate=TrueValueError
Tipo de retorno do encodebytesstr
URIs data:nãodata_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.

Mais do base64hub