Skip to main content

An application that provides tools for displaying QR codes on your Django site.

Project description

Django QR Code

Latest PyPI version Downloads Documentation Status Build and Test Maintainability

This is an application that provides tools for displaying QR codes on your Django site.

This application depends on the Segno QR Code generator library.

This app makes no usage of the Django models and therefore do not use any database.

Only Python >= 3.10 is supported.

Features

  • Generate QR codes as embedded SVG or PNG images in HTML templates.
  • Customize QR codes with various parameters (size, error correction, border, etc.).
  • Generate URLs for QR code images.
  • Support for specific application QR codes (e.g., contact info, Wi-Fi config).
  • Cache QR code images for performance.
  • Secure QR code image serving with URL protection and user authentication.

Installation

Binary Package from PyPi

In order to use this app in a Django project, the simplest way is to install it from PyPi:

pip install django-qr-code

From the Source Code

In order to modify or test this app you may want to install it from the source code.

Clone the GitHub repository and install dependencies:

git clone https://github.com/dprog-philippe-docourt/django-qr-code
pip install -r requirements.txt -r requirements-dev.txt
python manage.py collectstatic --no-input

Usage

Start by adding qr_code to your INSTALLED_APPS setting like this:

INSTALLED_APPS = (
    # ...,
    'qr_code',
)

You need to load the tags provided by this app in your template with:

{% load qr_code %}

The source code on GitHub contains a simple demo app. Please check out the templates folder for an example of template, and the setting and urls files for an example of configuration and integration.

Example: Inline QR Code

Generate a simple QR code:

{% qr_from_text "Hello World!" size="T" %}

Example: URL QR Code

Generate a URL for a QR code image:

<img src="{% qr_url_from_text "Hello World!" %}" alt="Hello World!">

Advanced Usage of Tags

Refer to the official documentation for tags for more detailed information and advanced usage examples.

Demo Application

If you want to try this app, you may want to use the demo application shipped alongside the source code.

Get the source code from GitHub, follow the installation instructions above, and run the runserver command of Django:

python manage.py runserver

The demo application should be running at http://127.0.0.1:8000/qr-code-demo/.

If you have Docker Compose installed, you can simply run the following from a terminal (this will save you the burden of setting up a proper python environment):

cd scripts
./run-demo-app.sh

The demo application should be running at http://127.0.0.1:8910/qr-code-demo/.

Generating Image Object Representing a QR Code

If you do not want to use Django tags for rendering QR code in a template, you can simply use the API in your code. For instance, qr_code.qrcode.maker.make_qr_code_image will return bytes representing an image according to the image_format passed in the qr_code_options parameter.

Refer to the official API documentation for more detailed information.

Testing

Get the source code from GitHub, follow the installation instructions above, and run the test command of Django:

python manage.py test

This will run the test suite with the locally installed version of Python and Django.

If you have Docker Compose installed, you can simply run the following from a terminal (this will save you the burden of setting up a proper python environment):

cd scripts
./run-tests.sh

This will run the test suite with all supported versions of Python and Django. The test results are stored within tests_result folder.

Projects Using this App

This app is used in the following projects:

  • MyGym Web: a web platform for managing sports clubs. The QR codes are used for importing members' contact information in a phone book.
  • Gymna-Score: a web platform for entering scores during gymnastics competitions organized by the Association Cantonale Jurassienne de Gymnastique (ACJG). The QR codes are used to provide an easy way for the public to follow an ongoing competition. They are also used to authenticate judges that need to enter scores.
  • AC-Ju: a website that generates digital vouchers that can be redeemed at affiliate merchants.

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

django_qr_code-4.1.0.tar.gz (25.8 kB view details)

Uploaded Source

Built Distribution

django_qr_code-4.1.0-py3-none-any.whl (24.7 kB view details)

Uploaded Python 3

File details

Details for the file django_qr_code-4.1.0.tar.gz.

File metadata

  • Download URL: django_qr_code-4.1.0.tar.gz
  • Upload date:
  • Size: 25.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.0 CPython/3.9.19

File hashes

Hashes for django_qr_code-4.1.0.tar.gz
Algorithm Hash digest
SHA256 0d236a2385385cb8570a7191597120be6abfc5ca2ad49aabe2b182ddb28c12b0
MD5 11ed9557015b1da287c094324cf7bd65
BLAKE2b-256 5552aa10881dec67bdd016a90edb309384c7271791c4eda1e2ce5b0eaab06df2

See more details on using hashes here.

File details

Details for the file django_qr_code-4.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for django_qr_code-4.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 000ae66411a13ce9b21c2631177b3f457614528c8866ebff3f7e991f4b6082b7
MD5 a38771d8d4fcd7246977799893a605d6
BLAKE2b-256 fb2697fbc45a02c66b8ed7e6b013962b4c59ab8a8d731ec1906fe0bc5db52399

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