Metadata-Version: 2.4
Name: streepjescode
Version: 1.1.0
Summary: Generate nicely formatted barcodes (UPC-A and EAN)
License: MIT
License-File: LICENSE
Keywords: barcode,UPC
Author: Philipp Hagemeister
Author-email: phihag@phihag.de
Requires-Python: >=3.10,<4.0.0
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Project-URL: Bug Tracker, http://codeberg.org/jessebot/streepjescode/issues
Project-URL: Documentation, http://git.open.engineering/jessebot/streepjescode
Project-URL: Homepage, http://git.open.engineering/jessebot/streepjescode
Project-URL: Repository, http://codeberg.org/jessebot/streepjescode
Description-Content-Type: text/markdown

# streepjescode

Generate well-formatted, production-ready Barcodes.

By default, existing Python barcode libraries like [python-barcode](https://pypi.org/project/python-barcode/) generate good barcodes, but any and all formatting of the text is left up to the user. streepjescode generates a nicely formatted barcode with interleaved text out of the box:

![Example barcode](example_path.svg)

Depending on your renderer (and true by default), text in the barcode is *not* an SVG `<text>` element, as such an elment may render differently on different machines depending on font availability.

This library is currently limited to UPC-A/EAN and EPS/SVG – that's all we (the original authors) needed. Patches welcome!

# Installation

You should use something like pipx to install this, so it doesn't interfere with any of your existing libraries.

```sh
$ pipx install streepjescode
```

# Usage

## In Python

```python
>>> from streepjescode import GTIN
>>> GTIN('123456789012').write('output.svg')
```

## Via the Command Line

```sh
$ streepjescode 123456789012 -o output.svg
# the streepjescode command is also available as barcode
$ barcode 123456789012 -o output.svg
```

## Quickstart from source

```bash
~$ git clone https://codeberg.org/jessebot/streepjescode.git
~$ cd streepjescode
~/streepjescode$ make
help                 List all commands
install-poetry       install or update poetry
install              install via poetry
update               Update the dependencies as according to the pyproject.toml file
lint                 Run code formatters and linter
fix-code-style       Fix code formatting
tox-listenvs         List all tox test environments
tox                  Run pytest via tox with all environments
tox-py36             Run pytest via tox with *python v3.6*
tox-py37             Run pytest via tox with *python v3.7*
tox-py38             Run pytest via tox with *python v3.8*
tox-py39             Run pytest via tox with *python v3.9*
pytest               Run pytest
pytest-ci            Run pytest with CI settings
publish              Release new version to PyPi
makemessages         Make and compile locales message files
```

# Attribution

This project was forked from [boxine/beautiful_barcode](https://github.com/boxine/beautiful_barcode) in order to add a no AI policy, build for the latest version of Python (and poetry), and maybe also add a proper CLI for convenience.

## License

[MIT](./LICENSE)

## Fun Facts

streepjescode means barcode in Dutch :)

