Instalación
pip install base64hub # the library, in a virtual environment
pipx install base64hub # the b64 command, isolated
Python 3.9 o posterior, nada más. El paquete solo usa la biblioteca estándar, así que instalarlo no trae ningún otro código.
Codificar, decodificar, validar
Cuatro funciones, con los tipos que esperarías en 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 recibe str (que se codifica como UTF-8) o bytes y devuelve str. decode devuelve bytes y lanza base64hub.Base64Error, una subclase de ValueError, si la entrada no es Base64. validate nunca lanza excepciones: devuelve un dict con valid, variant, padded, bytes y error, que contiene el motivo cuando la entrada no es válida y None en caso contrario.
base64hub frente al módulo base64
El módulo estándar base64 es correcto y rápido. También es estricto donde la gente pega entradas desordenadas y permisivo donde debería quejarse. Estas son sus salidas reales en 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 | |
|---|---|---|
Falta el relleno = | Incorrect padding | se acepta |
| Entrada URL-safe | urlsafe_b64decode aparte | la acepta decode |
| Caracteres no válidos | se descartan salvo con validate=True | ValueError |
| Tipo que devuelve encode | bytes | str |
URI data: | no | data_uri(), y se quita al decodificar |
Si solo codificas tus propios datos, la biblioteca estándar basta; Base64 en Python explica cómo. Recurre a base64hub cuando la entrada viene de usuarios, logs, JSON o URL y quieres un resultado correcto o un error claro.
El comando b64
pipx install base64hub te da el mismo comando b64 que la CLI nativa:
$ b64 "Hello, hub!"
SGVsbG8sIGh1YiE=
$ b64 --url --no-pad "Привет"
0J_RgNC40LLQtdGC
La versión de Python lee la entrada en memoria antes de procesarla; la de Go trabaja en flujo. Todo lo demás, incluidas las opciones y los códigos de salida, es idéntico. La documentación de Python recoge todas las funciones y opciones.
Preguntas frecuentes
¿Cómo instalo una herramienta de línea de comandos Base64 con Python?
pipx install base64hub pone el comando b64 en tu PATH, en su propio entorno. pip install base64hub dentro de un entorno virtual también sirve.
¿Por qué base64.b64decode dice Incorrect padding?
La biblioteca estándar exige una longitud múltiplo de 4. base64hub.decode() añade por su cuenta los = que faltan, así que decode("SGVsbG8sIGh1YiE") devuelve b'Hello, hub!'.
¿Qué versiones de Python admite base64hub?
Python 3.9 y posteriores. El paquete no tiene dependencias fuera de la biblioteca estándar.
¿Cómo decodifico Base64 URL-safe en Python sin saber la variante?
Llama a base64hub.decode(): acepta el alfabeto estándar y el URL-safe en la misma cadena. Con la biblioteca estándar tienes que elegir tú entre b64decode y urlsafe_b64decode.