Metadata-Version: 2.4
Name: Flask-QRcode
Version: 3.2.2
Summary: A concise Flask extension to render QR codes on Jinja2 templates using python-qrcode
Keywords: flask,qrcode,qr,jinja2
Author: Marco Agner
Author-email: Marco Agner <marco@agner.io>
License-Expression: GPL-3.0-or-later
License-File: COPYING
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Flask
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
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: Programming Language :: Python :: 3.15
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Dist: flask>=0.12.3
Requires-Dist: qrcode>=6.1
Requires-Dist: pillow>=9.1.0
Requires-Python: >=3.7
Project-URL: Homepage, https://github.com/marcoagner/Flask-QRcode
Project-URL: Documentation, https://marcoagner.github.io/Flask-QRcode/
Project-URL: Source, https://github.com/marcoagner/Flask-QRcode
Project-URL: Issues, https://github.com/marcoagner/Flask-QRcode/issues
Description-Content-Type: text/markdown

Flask-QRcode
============
[![PyPI version](https://badge.fury.io/py/Flask-QRcode.svg)](https://badge.fury.io/py/Flask-QRcode)

> A concise Flask extension to easily render QR codes on Jinja2 templates using
[python-qrcode](https://github.com/lincolnloop/python-qrcode)

You can read the [full documentation here](https://marcoagner.github.io/Flask-QRcode/).

![](QRcode.png)

## Installation
    
```
pip install Flask-QRcode
```

## Usage:

### Extend the app:

```
from flask_qrcode import QRcode
# [...]
QRcode(app)
# [...]
```

### Then use it within your templates:

#### Basic usage:

    <img src="{{ qrcode(STRING_TO_ENCODE) }}">
    
### More examples:
For more examples, just run the sample application in this repository.

[Sample Application](https://github.com/marcoagner/Flask-QRcode/tree/master/sample_application)

## Contributing:

Thank you for considering contributing to this package.

As this is a simple package, the process is pretty straightforward...

1. Fork this repository
2. Checkout from master with to a feature branch with a name related to what is being contributed (e.g. "colored-qrcodes")

\**It's highly recommended that your contribution either creates a new **feature**, **fixes** something OR **refactors** the code and does not mix these (e.g. one PR fixing some existent feature and refactoring non-related code).*

3. Install dependencies and flask_qrcode on editable mode
    ```
    uv sync --group dev
    ```
4. Do your magic
5. Provide new tests for your work and check that both this and the old ones
   are passing
6. Pull Request!

## Testing:

1. Install dependencies and flask_qrcode on editable mode
```
uv sync --group dev
```
2. Run pytest
```
uv run pytest
```
