# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-qrcode
VERSION=		8.2
KEYWORDS=		python
VARIANTS=		v12 v13
SDESC[v12]=		QR Code image generator (3.12)
SDESC[v13]=		QR Code image generator (3.13)
HOMEPAGE=		https://github.com/lincolnloop/python-qrcode
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/dd/b8/d2d6d731733f51684bbf76bf34dab3b70a9148e8f2cef2bb544fccec681a
DISTFILE[1]=		qrcode-8.2-py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v12]=		single
SPKGS[v13]=		single

OPTIONS_AVAILABLE=	PY312 PY313
OPTIONS_STANDARD=	none
VOPTS[v12]=		PY312=ON PY313=OFF
VOPTS[v13]=		PY312=OFF PY313=ON

DISTNAME=		qrcode-8.2.dist-info

GENERATED=		yes

[PY312].USES_ON=			python:v12,wheel

[PY313].USES_ON=			python:v13,wheel

post-install:
	# Fix python shebangs
	(cd ${STAGEDIR}${PYTHON_SITELIBDIR}/qrcode &&\
		${SED} -i'' -e "s|/usr/bin/env python|${LOCALBASE}/bin/python3|" \
		console_scripts.py)

[FILE:2750:descriptions/desc.single]
=============================
Pure python QR Code generator
=============================

Generate QR codes.

A standard install uses pypng_ to generate PNG files and can also render QR
codes directly to the console. A standard install is just::

    pip install qrcode

For more image functionality, install qrcode with the pil dependency so
that pillow_ is installed and can be used for generating images::

    pip install "qrcode[pil]"

.. _pypng: https://pypi.python.org/pypi/pypng
.. _pillow: https://pypi.python.org/pypi/Pillow

What is a QR Code?
==================

A Quick Response code is a two-dimensional pictographic code used for its
fast
readability and comparatively large storage capacity. The code consists of
black modules arranged in a square pattern on a white background. The
information encoded can be made up of any kind of data (e.g., binary,
alphanumeric, or Kanji symbols)

Usage
=====

From the command line, use the installed qr script::

    qr "Some text" > test.png

Or in Python, use the make shortcut function:

.. code:: python

    import qrcode
    img = qrcode.make('Some data here')
    type(img)  # qrcode.image.pil.PilImage
    img.save("some_file.png")

Advanced Usage
--------------

For more control, use the QRCode class. For example:

.. code:: python

    import qrcode
    qr = qrcode.QRCode(
        version=1,
        error_correction=qrcode.constants.ERROR_CORRECT_L,
        box_size=10,
        border=4,
    )
    qr.add_data('Some data')
    qr.make(fit=True)

    img = qr.make_image(fill_color="black", back_color="white")

The version parameter is an integer from 1 to 40 that controls the size of
the QR Code (the smallest, version 1, is a 21x21 matrix).
Set to None and use the fit parameter when making the code to determine
this automatically.

fill_color and back_color can change the background and the painting
color of the QR, when using the default image factory. Both parameters
accept
RGB color tuples.

.. code:: python

    img = qr.make_image(back_color=(255, 195, 235), fill_color=(55, 95,
35))

The error_correction parameter controls the error correction used for the
QR Code. The following four constants are made available on the qrcode
package:

ERROR_CORRECT_L
    About 7% or less errors can be corrected.
ERROR_CORRECT_M (default)
    About 15% or less errors can be corrected.
ERROR_CORRECT_Q
    About 25% or less errors can be corrected.
ERROR_CORRECT_H.
    About 30% or less errors can be corrected.

The box_size parameter controls how many pixels each "box" of the QR code
is.

The border parameter controls how many boxes thick the border should be
(the default is 4, which is the minimum according to the specs).

Other image factories
=====================


[FILE:117:distinfo]
16e64e0716c14960108e85d853062c9e8bba5ca8252c0b4d0231b9df4060ff4f        45986 python-src/qrcode-8.2-py3-none-any.whl