https://github.com/eliahkagan/b64s

Base64 with UTF-8 str input and output
https://github.com/eliahkagan/b64s

Last synced: about 23 hours ago
JSON representation

Base64 with UTF-8 str input and output

• Host: GitHub
• URL: https://github.com/eliahkagan/b64s
• Owner: EliahKagan
• License: cc0-1.0
• Created: 2023-03-20T17:58:05.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-09-11T17:56:10.000Z (about 2 months ago)
• Last Synced: 2024-09-12T03:55:19.021Z (about 2 months ago)
• Language: Python
• Size: 400 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: COPYING

Awesome Lists containing this project

README

        


# b64s - Base64 with UTF-8 str input and output

The [`b64s` module](b64s/__init__.py) provides two simple functions, `encode`

and `decode`, that thinly wrap functionality from the [`base64`

module](https://docs.python.org/3/library/base64.html) 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](https://creativecommons.org/publicdomain/zero/1.0/), a public domain

dedication.

See [**`COPYING`**](COPYING) for details.

## Usage

You can install [the PyPI package](https://pypi.org/project/b64s/), or [clone

the repository](https://github.com/EliahKagan/b64s).

```python

>>> 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`](b64s/__init__.py) – `encode` and `decode` functions.

- [`test_b64s.py`](test_b64s.py) – Unit tests.

- [`scratchpad.ipynb`](scratchpad.ipynb) – Notebook for trying things out.

## Acknowledgements

Thanks to [Michael Kagan](https://web.lemoyne.edu/~kagan/index.html) for help

with one of the examples.