Skip to main content

Library to generate PDFs for printing labels

Project description

pypi PyPI Downloads

pylabels2

pylabels2 is a Python library for creating PDFs to print sheets of labels. It uses the ReportLab PDF toolkit to produce the PDF.

This is a fork of davis-junior/pylabels

The original project was written by Blair Bonnett found at bcbnz/pylabels

See also erikvw/django-pylabels for integration into Django.

Installation

pip install pylabels2

Usage

Note: In this fork, the module has been renamed from labels to pylabels.

Install:

from pylabels import Specification, Sheet

Create a callable that adds content to a single label:

def draw_label(label, width, height, label_data):
    label.add(shapes.String(2, 2, str(label_data), fontName="Helvetica", fontSize=40))

Create a Specification for the layout of the labels on a sheet:

specs = Specification(210, 297, 2, 8, 90, 25, corner_radius=2)

Create a Sheet and pass it the spec and callable:

sheet = Sheet(specs, draw_label, border=True)

Add labels to the sheet:

sheet.add_label("Hello World1")
sheet.add_label("Hello World2")
# etc ...

Save the sheet to file as PDF:

sheet.save("basic.pdf")

Or save to BytesIO buffer:

buffer = sheet.save_to_buffer()

See detailed examples below.

Overview

Basically, the user creates a set of specifications of the label sizes etc., writes a callback function which does the actual drawing, and gives these two items to a Sheet object. Items are then added to the sheet using the add_label() method (or add_labels() to add all items from an iterable).

The callback function is called once for each item, being given a ReportLab Drawing object representing the label, its width and height, and the item to draw on the label. Any of the standard ReportLab drawing methods can be used, with pylabels automatically adding a clipping path around each label to prevent it interfering with other labels.

Once all the items have been added, the labels can be saved as a PDF, a preview of a page can be saved as an image, or returned as a BytesIO buffer.

Watermarks during testing

You can add a watermark to each label by passing watermark parameters to the save or save_buffer methods:

watermark = ("Sample", ("Helvetica", 12))
sheet.save_buffer(watermark)

or

watermark = ("Sample", ("Helvetica", 12))
sheet.save(file_obj, watermark)

Examples

The following examples are available in the demos directory:

  • Basic - an introduction to the basic use of pylabels.
  • Partial pages - how to produce partial pages (i.e., pages with some of the labels previously used).
  • Repeated - how to use the count parameter to add multiple copies of the same label.
  • Background colours - examples of solid, striped and hatched backgrounds of different colours on each label.
  • Page background - how to add a background image for each page.
  • Padding - how to add padding to the labels.
  • Nametags - creates a set of nametags from the list of names in the names.txt file. Includes the use of two custom fonts, font size selection, and centred text.
  • Image preview - generates image previews of two of the pages from the nametags demo.
  • Addresses - print mailing labels (From a CSV file) on a standard Avery 5160 label page.
  • Django demo - Download a PDF of labels with barcodes directly from the browser in a Django project (uses save_to_buffer instead of save).

Demo fonts

The following fonts are used in the demo scripts and are included in the demos folder:

License

Copyright (C) 2012, 2013, 2014, 2015 Blair Bonnett

pylabels is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

pylabels is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with pylabels. If not, see http://www.gnu.org/licenses/.

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

pylabels2-1.4.4.tar.gz (658.5 kB view details)

Uploaded Source

Built Distribution

pylabels2-1.4.4-py3-none-any.whl (659.6 kB view details)

Uploaded Python 3

File details

Details for the file pylabels2-1.4.4.tar.gz.

File metadata

  • Download URL: pylabels2-1.4.4.tar.gz
  • Upload date:
  • Size: 658.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for pylabels2-1.4.4.tar.gz
Algorithm Hash digest
SHA256 12dd72ef717ff6f551350f10616ae163799fa4501f56541bd82061c63dfa64f8
MD5 b0e9b491ca763e7216aeeb60a11089ba
BLAKE2b-256 efbf1887bfb7ec2a43032af1ca87c4d099dba9ca4875d77c2ea8f53c5c9ff509

See more details on using hashes here.

File details

Details for the file pylabels2-1.4.4-py3-none-any.whl.

File metadata

  • Download URL: pylabels2-1.4.4-py3-none-any.whl
  • Upload date:
  • Size: 659.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.4

File hashes

Hashes for pylabels2-1.4.4-py3-none-any.whl
Algorithm Hash digest
SHA256 edac8c8bfba0e17f95dfce1f018554561756518408c897e0196a646fdb0ce7cd
MD5 0ed9f0e985dc58423226738f8b561893
BLAKE2b-256 80669b7f3d95591f520f5d5101544ca53abbddb395fc2c79efb4620a02f7c4a0

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