treepoem 1.3.0

A cleverly named, but very simple python barcode renderer wrapping the BWIPP library and ghostscript command line tool, Python 2.7 and 3.3+ compatible.

Installation

Install from pip:

pip install treepoem

You’ll also need Ghostscript installed. On Ubuntu/Debian this can be installed with:

apt-get install ghostscript

On Mac OS X use:

brew install ghostscript

Otherwise refer to your distribution’s package manager, though it’s likely to be called ghostscript too.

API

generate_barcode(barcode_type, data, options)

Generates a barcode and returns it as a PIL image file object (specifically, a PIL.EpsImagePlugin.EpsImageFile).

barcode_type is the name of the barcode type to generate (see below).

data is the string of data to embed in the barcode - the amount that can be embedded varies by type.

options is a dictionary of strings-to-strings of extra options to be passed to BWIPP, as per its docs.

For example, this generates a QR code image, and saves it to a file using standard PIL Image.save():

>>> import treepoem
>>> image = treepoem.generate_barcode(
...     barcode_type='qrcode',  # One of the BWIPP supported codes.
...     data='barcode payload',
...     options={},
... )
>>> image.save('barcode.png')

barcode_types

This is a set of the ~100 names of the barcode types that the vendored version of BWIPP supports. If you’re looking for whether a specific type is supported, check here.

The library is tested with these specific, common types:

• qrcode - QR Code
• azteccode - Aztec Code
• pdf417 - PDF417
• interleaved2of5 - Interleaved 2 of 5
• code128 - Code 128
• code39 - Code 39

What’s so clever about the name?

Barcode.

Bark ode.

Tree poem.

History

1.3.0 (2017-06-21)

• Upgrade BWIPP from 2015-11-24 to 2017-06-20. This has a number of bug fixes, and supports more barcode types. It has also changed the pixel-for-pixel output of some formats, although they still encode the same information - notably QR codes, which are tested in treepoem’s test suite. You can read its changelog in the vendored copy in the treepoem repo.

1.2.0 (2017-06-21)

• Add treepoem.barcode_types, a set of all the names of supported barcode types, and error if asked to generate a barcode of an unknown type.

1.1.0 (2017-04-13)

• Support Windows.

1.0.1 (2016-03-30)

• Add the missing BWIPP files.

1.0.0 (2016-03-23)

• Use $PATH to find gs binary.
• Rename PostscriptError to TreepoemError.
• Add basic setup.py.
• Setup Travis CI build.
• Setup Tox