base64url-python/README.md

URL-safe Base64 for Python

A simple module for encoding without padding, fixing Python standard library's flaws.

Replaces the standard library's base64.urlsafe_b64encode and base64.urlsafe_b64decode with a cleaner implementation that returns strings instead of bytes and avoids unnecessary padding.

Features

• URL safe: Uses only characters that are safe for URLs and filenames
• No padding: Removes trailing = characters for cleaner output
• String output: Returns proper strings instead of bytes (unlike Python's standard library)
• Fast: Based on Python stdlib, with constant-time padding restoration

Installation

pip install b64url

Or for your project using uv:

uv add b64url

Usage

import b64url

text = b64url.enc(bytes(4))  # Returns str "AAAAAA"
data = b64url.dec(text)      # Returns the original bytes

enc(data: bytes) -> str

Encode bytes to a web-safe Base64 string without padding.

dec(s: str) -> bytes

Decode a web-safe Base64 string to bytes. Padding is optional.