b64s - Base64 with UTF-8 str input and output

The b64s module provides two simple functions, encode and decode, that thinly wrap functionality from the base64 module in the standard library, so that:

• All arguments and return values are str.
• UTF-8 encoding is assumed and used.

License

This software is public domain. It is released under CC0 1.0 Universal, a public domain dedication.

See COPYING for details.

Usage

You can install the PyPI package, or clone the repository.

>>> import b64s

>>> b64s.encode('The Hebrew phrase for “snowboarder” is גולש סנובורד. 🏂')
'VGhlIEhlYnJldyBwaHJhc2UgZm9yIOKAnHNub3dib2FyZGVy4oCdIGlzINeS15XXnNepINeh16DXldeR15XXqNeTLiDwn4+C'

>>> b64s.decode('VGhlIEhlYnJldyBwaHJhc2UgZm9yIOKAnHNub3dib2FyZGVy4oCdIGlzINeS15XXnNepINeh16DXldeR15XXqNeTLiDwn4+C')
'The Hebrew phrase for “snowboarder” is גולש סנובורד. 🏂'

What’s here

The interesting files are:

• b64s/__init__.py – encode and decode functions.
• test_b64s.py – Unit tests.
• scratchpad.ipynb – Notebook for trying things out.

Acknowledgements

Thanks to Michael Kagan for help with one of the examples.