Skip to main content

Multibase implementation for Python

Project description

py-multibase

https://img.shields.io/pypi/v/py-multibase.svg https://img.shields.io/travis/multiformats/py-multibase.svg?branch=master https://codecov.io/gh/multiformats/py-multibase/branch/master/graph/badge.svg Documentation Status

Multibase implementation for Python

Multibase is a protocol for distinguishing base encodings and other simple string encodings, and for ensuring full compatibility with program interfaces.

It answers the question: Given data d encoded into string s, how can I tell what base d is encoded with?

Base encodings exist because transports have restrictions, use special in-band sequences, or must be human-friendly. When systems chose a base to use, it is not always clear which base to use, as there are many tradeoffs in the decision. Multibase is here to save programs and programmers from worrying about which encoding is best.

It solves the biggest problem: a program can use multibase to take input or produce output in whichever base is desired.

The important part is that the value is self-describing, letting other programs elsewhere know what encoding it is using.

Installation

$ pip install py-multibase

Sample Usage

>>> # encoding a buffer
>>> from multibase import encode, decode
>>> encode('base58btc', 'hello world')
b'zStV1DL6CwTryKyV'
>>> encode('base64', 'hello world')
b'mGhlbGxvIHdvcmxk'
>>> # decoding a multibase
>>> decode('mGhlbGxvIHdvcmxk')
b'hello world'
>>> decode(b'zStV1DL6CwTryKyV')
b'hello world'
>>> decode(encode('base2', b'hello world'))
b'hello world'

Supported codecs

  • base2

  • base8

  • base10

  • base16

  • base16

  • base16

  • base32hex

  • base32

  • base32z

  • base36

  • base36upper

  • base58flickr

  • base58btc

  • base64

  • base64url

History

1.0.3 (2020-10-26)

  • Add base36 and base36 upper encodings

  • Fix issue with base16 encoding

1.0.0 (2018-10-19)

  • Re-implement encoding for base32 and base64, as the implementation was buggy

  • Add extensive tests for all encodings

0.1.0 (2017-09-02)

  • First release on PyPI.

Project details


Download files

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

Source Distribution

py-multibase-1.0.3.tar.gz (23.4 kB view hashes)

Uploaded source

Built Distribution

py_multibase-1.0.3-py2.py3-none-any.whl (6.4 kB view hashes)

Uploaded 3 8

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page