dbase32 1.7.0

A base32 encoding with a sorted-order alphabet

The Dbase32 encoding is a base32 variant designed for document-oriented databases, specifically for encoding document IDs.

It uses an alphabet whose symbols are in ASCII/UTF-8 sorted order:

3456789ABCDEFGHIJKLMNOPQRSTUVWXY

This means that unlike RFC-3548 Base32 encoding, the sort-order of the encoded data will match the sort-order of the binary data.

The dbase32 package provides a high-performance C implementation of the encoding, plus a pure-Python fallback.

Dbase32 is licensed LGPLv3+, requires Python 3.4 or newer, and fully supports Python 3.5.

Examples

Encoding and decoding:

>>> from dbase32 import db32enc, db32dec
>>> db32enc(b'binary foo')
'FCNPVRELI7J9FUUI'
>>> db32dec('FCNPVRELI7J9FUUI')
b'binary foo'

Validation:

>>> from dbase32 import isdb32, check_db32
>>> isdb32('../very/naughty/')
False
>>> check_db32('../very/naughty/')
Traceback (most recent call last):
  ...
ValueError: invalid Dbase32: '../very/naughty/'

Generating 120-bit Dbase32-encoded random IDs:

>>> from dbase32 import random_id
>>> random_id()
'FOLQCPOFDVADYMVGQDI49Y7F'
>>> random_id()
'IFL63RNSQ9NN5ANMUQD6BQSJ'

Dbase32 resources

• Documentation

• Report a bug

• Browse the source

• Launchpad project

A Novacut component

Dbase32 is being developed as part of the Novacut project. Packages are available for Ubuntu in the Novacut Stable Releases PPA and the Novacut Daily Builds PPA.

If you have questions or need help getting started with Dbase32, please stop by the #novacut IRC channel on freenode.