Primer commit
This commit is contained in:
@@ -0,0 +1,177 @@
|
||||
Metadata-Version: 2.1
|
||||
Name: viivakoodi
|
||||
Version: 0.8.0
|
||||
Summary: Create standard barcodes with Python. No external modules needed (optional PIL support included).
|
||||
Home-page: https://github.com/kxepal/viivakoodi
|
||||
Author: Thorsten Weimann, Alexander Shorin
|
||||
Author-email: kxepal@gmail.com
|
||||
License: MIT
|
||||
Classifier: Development Status :: 4 - Beta
|
||||
Classifier: Environment :: Console
|
||||
Classifier: Intended Audience :: Developers
|
||||
Classifier: License :: OSI Approved :: MIT License
|
||||
Classifier: Operating System :: OS Independent
|
||||
Classifier: Programming Language :: Python
|
||||
Classifier: Programming Language :: Python :: 2
|
||||
Classifier: Programming Language :: Python :: 2.6
|
||||
Classifier: Programming Language :: Python :: 2.7
|
||||
Classifier: Programming Language :: Python :: 3
|
||||
Classifier: Programming Language :: Python :: 3.3
|
||||
Classifier: Programming Language :: Python :: 3.4
|
||||
Classifier: Topic :: Software Development :: Libraries :: Python Modules
|
||||
Classifier: Topic :: Multimedia :: Graphics
|
||||
License-File: LICENSE
|
||||
|
||||
Viivakoodi
|
||||
==========
|
||||
|
||||
`Viivakoodi` (`barcode in Suomi <https://fi.wikipedia.org/wiki/Viivakoodi>`_)
|
||||
is the fork of `pyBarcode <https://bitbucket.org/whitie/python-barcode/>`_
|
||||
project.
|
||||
|
||||
This library provides a simple way to create barcodes using only the
|
||||
Python standardlib. The barcodes where created as SVG objects.
|
||||
|
||||
Report bugs at https://github.com/kxepal/viivakoodi/issues/
|
||||
|
||||
|
||||
Requirements
|
||||
------------
|
||||
|
||||
- Setuptools/distribute for installation (new in version 0.7beta4)
|
||||
- Python 2.6 or above (including Python 3.x)
|
||||
- On Python 2.6, 3.0, 3.1: argparse (for the commandline script)
|
||||
- Program to open SVG objects (your browser should do it)
|
||||
- Optional: PIL to render barcodes as images (PNG, JPG, ...)
|
||||
|
||||
|
||||
Installation
|
||||
------------
|
||||
|
||||
Make sure you have setuptools/distribute installed.
|
||||
|
||||
Unpack the downloaded file, cd into the viivakoodi directory and run
|
||||
`python setup.py install`. Or just copy the barcode dir somewhere in
|
||||
your PYTHONPATH.
|
||||
|
||||
The best way is to use pip: `pip install viivakoodi`.
|
||||
|
||||
|
||||
Provided Barcodes
|
||||
-----------------
|
||||
|
||||
EAN-8, EAN-13, UPC-A, JAN, ISBN-10, ISBN-13, ISSN, Code 39, Code 128, PZN
|
||||
|
||||
|
||||
Todo
|
||||
----
|
||||
|
||||
- Add documentation
|
||||
- Add more codes
|
||||
- Improve Python 3 support
|
||||
- Add simple GUI
|
||||
|
||||
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{2,3} create "My Text" outfile
|
||||
New barcode saved as outfile.svg.
|
||||
$ pybarcode{2,3} create -t png "My Text" outfile
|
||||
New barcode saved as outfile.png.
|
||||
|
||||
Try `pybarcode -h` for help.
|
||||
|
||||
Changelog
|
||||
---------
|
||||
|
||||
:v0.8: Code 128 added. Data for charsets and bars moved to subpackage
|
||||
barcode.charsets.
|
||||
|
||||
: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.
|
||||
|
||||
Reference in New Issue
Block a user