Skip to main content

python-barcode

build status version on pypi licence

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

python-barcode

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: Pillow 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
['code39', 'code128', 'ean', 'ean13', 'ean8', 'gs1', 'gtin',
 'isbn', 'isbn10', 'isbn13', 'issn', 'jan', 'pzn', 'upc', 'upca']
>>> EAN = barcode.get_barcode_class('ean13')
>>> EAN
<class 'barcode.ean.EuropeanArticleNumber13'>
>>> ean = EAN('5901234123457')
>>> ean
<barcode.ean.EuropeanArticleNumber13 object at 0x00BE98F0>
>>> fullname = ean.save('ean13_barcode')
>>> fullname
'ean13_barcode.svg'
# Example with PNG
>>> from barcode.writer import ImageWriter
>>> ean = EAN('5901234123457', writer=ImageWriter())
>>> fullname = ean.save('ean13_barcode')
'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) # Pillow (ImageWriter) produces RAW format here
# New in v0.5.0
>>> from barcode import generate
>>> name = generate('EAN13', '5901234123457', output='barcode_svg')
>>> name
'barcode_svg.svg'
# with file like object
>>> fp = StringIO()
>>> generate('EAN13', '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:

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

Try `python-barcode -h` for help.

Changelog

v0.9.1

  • Officially support Python 3.7

  • Refer to Pillow in the docs, rather than PIL.

v0.9.0

  • Removed buggy Barcode.raw attribute.

  • Various CLI errors ironed out.

  • Make the default value for writer_options` consistent across writers.

v0.8.3

  • Fix pushing of releases to GitHub.

v0.8.2

  • Fix crashes when attempting to use the CLI app.

  • Properly include version numbers in SVG comments.

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.

Metadata

Release files for python-barcode 0.10.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-barcode 0.10.0
File Size Uploaded
python-barcode-0.10.0.tar.gz 227.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for python-barcode 0.10.0
File Interpreter ABI Platform
python_barcode-0.10.0-py3-none-any.whl Python 3 none any Details

Total release size: 438.8 kB

Release files / python-barcode-0.10.0.tar.gz

Download URL python-barcode-0.10.0.tar.gz
Size 227.2 kB
Tags Source
SHA-256 checksum
How to use checksums
f5eceb695aa71281b33b505549f93ddcbe4c41562b1a46bd632ebaab3705c369
BLAKE2b-256 checksum
How to use checksums
6f95fe173b976123716d8b02ff19da1d6e3c88d65e89bcddc7808f2b816b2070
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.0.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.5.6

Release files / python_barcode-0.10.0-py3-none-any.whl

Download URL python_barcode-0.10.0-py3-none-any.whl
Size 211.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5f6bbdd42dd9e5ead4a3526070924638b24930cd8d52c162d2aff62a47086ea5
BLAKE2b-256 checksum
How to use checksums
10aafaaabf936994dc3457f25b2222e2feb8b1ba391df033ce94bc99f0ba17da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/40.0.0 requests-toolbelt/0.9.1 tqdm/4.32.1 CPython/3.5.6

Release history Release notifications | RSS feed

0.16.1

2 release files

0.16.0

2 release files

0.14.0

2 release files

0.13.1

2 release files

0.13.0

2 release files

0.12.0

2 release files

0.11.0

2 release files

This release

0.10.0 This release

2 release files

0.9.0

2 release files

0.8.3

2 release files

0.8.2

2 release files

0.8.1

2 release files

0.8

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page