Skip to main content

Create standard barcodes with Python. No external modules needed (optional PIL support included).

Project description

python-barcode

This library provides a simple way to create barcodes using only the Python standard lib. The barcodes are created as SVG objects.

Please report any bugs at https://github.com/WhyNotHugo/python-barcode/issues

Requirements

  • Setuptools/distribute for installation.

  • Python 3.5 or above

  • Program to open SVG objects (your browser should do it)

  • Optional: PIL to render barcodes as images (PNG, JPG, …)

Installation

The best way is to use pip: pip install python-barcode.

You can also install manually by downloading the tarball, extracting it, and running python setup.py install.

Provided Barcodes

  • EAN-8

  • EAN-13

  • EAN-14

  • UPC-A

  • JAN

  • ISBN-10

  • ISBN-13

  • ISSN

  • Code 39

  • Code 128

  • PZN

Todo

  • Add documentation

  • Add more codes

Usage

Interactive:

>>> import barcode
>>> barcode.PROVIDED_BARCODES
[u'code39', u'code128', u'ean', u'ean13', u'ean8', u'gs1', u'gtin',
 u'isbn', u'isbn10', u'isbn13', u'issn', u'jan', u'pzn', u'upc', u'upca']
>>> EAN = barcode.get_barcode_class('ean13')
>>> EAN
<class 'barcode.ean.EuropeanArticleNumber13'>
>>> ean = EAN(u'5901234123457')
>>> ean
<barcode.ean.EuropeanArticleNumber13 object at 0x00BE98F0>
>>> fullname = ean.save('ean13_barcode')
>>> fullname
u'ean13_barcode.svg'
# Example with PNG
>>> from barcode.writer import ImageWriter
>>> ean = EAN(u'5901234123457', writer=ImageWriter())
>>> fullname = ean.save('ean13_barcode')
u'ean13_barcode.png'
# New in v0.4.2
>>> from StringIO import StringIO
>>> fp = StringIO()
>>> ean.write(fp)
# or
>>> f = open('/my/new/file', 'wb')
>>> ean.write(f) # PIL (ImageWriter) produces RAW format here
# New in v0.5.0
>>> from barcode import generate
>>> name = generate('EAN13', u'5901234123457', output='barcode_svg')
>>> name
u'barcode_svg.svg'
# with file like object
>>> fp = StringIO()
>>> generate('EAN13', u'5901234123457', writer=ImageWriter(), output=fp)
>>>

Now open ean13_barcode.[svg|png] in a graphic app or simply in your browser and see the created barcode. That’s it.

Commandline:

$ pybarcode create "My Text" outfile
New barcode saved as outfile.svg.
$ pybarcode create -t png "My Text" outfile
New barcode saved as outfile.png.

Try `pybarcode -h` for help.

Changelog

v0.8.1

  • Improve README rendering, and point to this fork’s location (the outdated README on PyPI was causing some confusion).

v0.8.0

  • First release under the name python-barcode.

Previous Changelog

This project is a fork of pyBarcode, which, apparently, is no longer maintained. v0.8.0 is our first release, and is the latest master from that parent project.

v0.8

  • Code 128 added.

  • Data for charsets and bars moved to subpackage barcode.charsets.

  • Merged in some improvements.

v0.7

  • Fixed some issues with fontsize and fontalignment.

  • Added Python 3 support. It’s not well tested yet, but the tests run without errors with Python 3.3. Commandline script added.

v0.6

  • Changed save and write methods to take the options as a dict not as keyword arguments (fix this in your code). Added option to left align the text under the barcode. Fixed bug with EAN13 generation.

v0.5.0

  • Added new generate function to do all generation in one step.

  • Moved writer from a subpackage to a module (this breaks some existing code). UPC is now rendered as real UPC, not as EAN13 with the leading “0”.

v0.4.3

  • Fixed bug in new write method (related to PIL) and updated docs.

v0.4.2

  • Added write method to support file like objects as target.

v0.4.1

  • Bugfix release. Removed redundancy in input validation.

  • EAN8 was broken. It now works as expected.

v0.4

  • Removed **options from writers __init__ method. These options never had effect. They were always overwritten by default_options.

  • New config option available: text_distance (the distance between barcode and text).

v0.4b2

  • Basic documentation included. The barcode object now has a new attribute called raw to have the rendered output without saving to disk.

v0.4b1

  • Support for rendering barcodes as images is implemented. PIL is required to use it.

v0.3

  • Compression for SVG output now works.

v0.3b1

  • Writer API has changed for simple adding new (own) writers.

  • SVG output is now generated with xml.dom module instead of stringformatting (makes it more robust).

v0.2.1

  • API of render changed. Now render takes keyword arguments instead of a dict.

v0.2

  • More tests added.

v0.1

  • First release.

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

python-barcode-0.8.2.tar.gz (225.6 kB view details)

Uploaded Source

Built Distribution

python_barcode-0.8.2-py3-none-any.whl (214.3 kB view details)

Uploaded Python 3

File details

Details for the file python-barcode-0.8.2.tar.gz.

File metadata

File hashes

Hashes for python-barcode-0.8.2.tar.gz
Algorithm Hash digest
SHA256 8e74839e8760a97405d6547665931240f544c33528f0326fd9471f385ef99f29
MD5 656e39a4d29082e5da5cbb7d502b7d25
BLAKE2b-256 8c0c2d2546ef3b4a99f017fe368936ee8a989aca6ecc84bd9ec45114e7faef68

See more details on using hashes here.

File details

Details for the file python_barcode-0.8.2-py3-none-any.whl.

File metadata

File hashes

Hashes for python_barcode-0.8.2-py3-none-any.whl
Algorithm Hash digest
SHA256 8ca56876030164cec6e7d41fcda89f295a6f472a1c9f7dfd955c6b71a01c9a7a
MD5 cd1860b6dac44008a44f6ec3cf03f73d
BLAKE2b-256 3153ba059da36d0edf0db763acde4c739ce9ab3d262deb12d1ec29e88501261d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page