Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

A library for encoding binary data as a sequence of english words

Project description

Build Status Coverage

A python library for encoding binary data as a sequence of english words.

Based on, and compatible with http://web.archive.org/web/20101031205747/http://www.tothink.com/mnemonic/

Installation

Recommended method is to use the version from pypi

$ pip install mnemonicode

Please note that this library supports python 3 only.

Usage

Python mnemonicode exposes four functions: mnformat and mnparse for handling conversions to and from formatted strings, and mnencode and mndecode for working with lower level lists of tuples of words.

String encoding

Encode a byte array as a sequence of grouped words, formatted as a single string:

>>> mnformat(b"cucumber")
'paris-pearl-ultra--gentle-press-total';

Decode a mnemonicode string into a byte array:

>>> mnparse('scoop-limit-recycle--ferrari-album')
b'tomato'

Both functions allow specifying the word and group separator. It is safe for the word separator to match part of the group separator, but not the other way round. Word and group separators that overlap with word in the dictionary should obviously be avoided.

An example using custom separators:

>>> mnemonicode.mnformat(
...     b'apricot', group_separator=', uhhh, ', word_separator=', um, '
... )
'arctic, um, dilemma, um, single, uhhh, presto, um, mask, um, jet'

Tuple encoding

Encode a bytes object as an iterator of tuples of words:

>>> list(mnencode(b"avocado"))
[('bicycle', 'visible', 'robert'), ('cloud', 'unicorn', 'jet')]

Decode an iterator of tuples of words to get a byte array:

>>> mndecode([('turtle', 'special', 'recycle'), ('ferrari', 'album')])
b'potato'

License

The project is licensed under the BSD license. See LICENSE for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
mnemonicode-1.4.4.tar.gz (15.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page