Metadata-Version: 2.4
Name: qr-verbose
Version: 1.1.1
Summary: A QR code generator with detailed visualization
Author-email: Nikolay Malkovsky <malkovskynv@gmail.com>
License: MIT
Project-URL: Homepage, https://sourcecraft.dev/malkovskynv/qr-verbose
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: qrcode
Requires-Dist: numpy
Requires-Dist: pillow
Dynamic: license-file

<!-- [![asdasdas](https://img.shields.io/badge/docs-1.0.0-blue
)](https://malkovskynv.sourcecraft.site/qr-verbose/) -->

[![PyPI](https://img.shields.io/pypi/v/qr-verbose)](https://pypi.org/project/qr-verbose/)

# QR Verbose

`qr-verbose` is a Python package for generating QR codes with detailed visualization desined mainly for educational purposes. You can generate a scannable QR code with `qr-verbose`, more importantly you can also generate the same QR with intermediate level information rarely available in QR code generators/encoders.

![](docs/images/repo_url_verbose.png)

## Installation

Install the required dependencies:

```bash
pip install qr-verbose
```
or from sources
```bash
git clone https://git@git.sourcecraft.dev/malkovskynv/qr-verbose.git
cd qr-verbose
pip install .
```

`qr-verbose` is provided as CLI entry point, check

```bash
qr-verbose --help
```

If `qr-verbose` is not available check the `PATH` variable, when the package is installed pip will show a warning about CLI script not being part of the `PATH`. You can either add the Python bin path to the `PATH` variable or specify the full path to the installed location of the script.

## Usage

You can generate a regular scannable QR code like this

```bash
qr-verbose -m 2 -v 3 \
    --logo-path docs/images/logo_example.png \
    --logo-radius=3.5 \
    -e M \
    -o regular.png \
    t.me/a_zachem_eto_nuzhno  
```

![](https://malkovskynv.sourcecraft.site/qr-verbose/images/regular.png){align=center width=400px}

The same but unmasked and with visual data layout

```bash
qr-verbose -m -1 -v 3 \
    --logo-path docs/images/logo_example.png \
    --logo-radius=3.5 \
    -e M \
    -t ascii \
    -o ascii.png \
    t.me/a_zachem_eto_nuzhno  
```

![ascii](https://malkovskynv.sourcecraft.site/qr-verbose/images/ascii.png){align=center width=400px}

The QR at the top of the README is generated via the following command (annotations are manual)
```bash
qr-verbose -m 0 -v 3 \
    --logo-path docs/images/logo_example.png \
    --logo-radius=3.5 \
    --logo-transparency=255 \
    -t color \
    -e M \
    -o repo_url.png \
    --white-data-background \
    sourcecraft.dev/malkovskynv/qr-verbose
```


More examples can be found in the [docs](https://malkovskynv.sourcecraft.site/qr-verbose/tutorial.html)
