Giliard Godoi

Giliard Godoi

Machine Learning. Análise e visualização de dados. Inteligência Artificial. Computação Evolutiva. Algoritmos Genéticos. Otimização combinatória. Teoria dos Grafos. Pythonista.

Gerando QR code com Python

Criando QR codes com Python

Por esses dias eu queria produzir um QR code para um link do site da Câmara de Vereadores de Santo Antônio da Platina - PR.

A maioria dos geradores disponíveis na internet produzem imagens padrões, e seria interessante customizar esse QR code com as cores dominantes do site da instituição.

Como bom programador Python eu utilizei uma biblioteca chamada qrcode. Ela está disponível no PyPl (link) e também nesse repositório: github.com/lincolnloop/python-qrcode.

Como funciona os QR codes

Eu tentei encontrar algum artigo didático sobre a geração de QR code e como eles funcionam, porém não encontrei uma resposta satisfatória.

Porém, quis o destino (ou o algortimo do Twitter) que eu esbarrasse com essa thread que faz uma introdução bem legal e com várias imagens ilustrativas.

Seria interessante dar uma olhada nessa thread antes de continuar lendo essa postagem.

Outra referência interessante é esse artigo da empresa responsável pela criação do QR code, Denso Wave, contando um pouco da história da criação do QR code.

QR code: development history

Instalação

Para instalar a biblioteca segui as instruções apresentadas no repositório. A adição do comando [pil] força a instalação da biblioteca Pillow, responsável por gerar e trabalhar com alguns formatos de imagens (.png por exemplo).

! pip install qrcode[pil]

Gerando QR Codes

O meu objetivo é produzir um QR code que direcione uma pessoa até a página web em que está disponível a pauta das reuniões da Câmara Municipal.

Então, a url que eu vou codificar é a seguinte:

url = "https://sapl.santoantoniodaplatina.pr.leg.br/sessao/pauta-sessao"

Nesse tutorial vamos explorar a criação das imagens através da classe QRCode, que fornece opções algumas opções avançadas.

O código abaixo apresenta uma forma de utilizar a classe QRCode, alguns parâmertos dela, e as funções necessárias para produzir um QR code.

import qrcode

qr = qrcode.QRCode(
    version=4, # está relacionado ao tamanho e quantidade de informações que o QR Code pode codificar
    error_correction=qrcode.constants.ERROR_CORRECT_L, # Robustez e correção de erros de leitura
    box_size=7, # influencia no tamanho da imagem
    border=4, # borda da imagem até o início do QR Code
)

qr.add_data(url) # adiciona dados para serem codificados

qr.make(fit=True) # se o parâmetro `fit` está marcado como True
# a versão do QR code pode ser alterada para suportar a codificação de uma 
# quantidade maior de informações. Faça o seguinte teste: inicie o objeto `qr`
# com o parâmetro `version=1` e o parâmetro `fit` na função `make` como False.
# É esperado que uma exceção seja gerada nessas condições.

img = qr.make_image()
# esse método possui os seguintes valores padrões
# img = qr.make_image(fill_color="black", back_color="white")

print(type(img)) 
img

<class 'qrcode.image.pil.PilImage'>

png

Observe que alterando o parâmetro error_correction para qrcode.constants.ERROR_CORRECT_Haltera-se o padrão da imagem. Isso significa também que existe uma maior redundância na codificação de informações que torna o QR code mais robusto a danos ou obstruções que impeçam a leitura dos dados codificados.

qr = qrcode.QRCode(
    version=4,
    error_correction=qrcode.constants.ERROR_CORRECT_H,
    box_size=7,
    border=4,
)

qr.add_data(url)
qr.make(fit=True)
img = qr.make_image()

print(type(img))

img

<class 'qrcode.image.pil.PilImage'>

png

Customização

qrcodes oferece possibilidade de customizar as cores do QR code com a máscara SolidFillColorMask, ou opções de gradiente, além de inserir imagens no background.

Também é possível escolher entre diferentes estilos de formas e desenhos para o QR code.

# factory para gerar uma imagem que poderá ser transformada em .png e jpeg
from qrcode.image.styledpil import StyledPilImage

# customização de cores, gradientes, e imagem no background
from qrcode.image.styles.colormasks import (SolidFillColorMask,
                                            RadialGradiantColorMask,
                                            SquareGradiantColorMask,
                                            HorizontalGradiantColorMask,
                                            VerticalGradiantColorMask,
                                            ImageColorMask)

# customização sobre a forma dos traços
from qrcode.image.styles.moduledrawers import (RoundedModuleDrawer,
                                               VerticalBarsDrawer, 
                                               HorizontalBarsDrawer,
                                               GappedSquareModuleDrawer,
                                               CircleModuleDrawer)

# definindo um tom de azul para a cor do QR code
custom_blue_color = SolidFillColorMask(front_color=(0, 48, 107))

Para saber como instânciar essas classes que oferecem diferentes opções, dê um help.

# help(RadialGradiantColorMask)
# help(SquareGradiantColorMask)
# help(HorizontalGradiantColorMask)
# help(VerticalGradiantColorMask)

RoundedModuleDrawer

qr = qrcode.QRCode(error_correction=qrcode.constants.ERROR_CORRECT_L, 
                   box_size=10,  
                   border=4)

qr.add_data(url)

qr.make_image(image_factory = StyledPilImage, 
              module_drawer = RoundedModuleDrawer(), 
              color_mask = custom_blue_color )

png

CircleModuleDrawer

qr.make_image(image_factory = StyledPilImage, 
              module_drawer = CircleModuleDrawer(), 
              color_mask = custom_blue_color)

png

GappedSquareModuleDrawer

qr.make_image(image_factory = StyledPilImage, 
              module_drawer = GappedSquareModuleDrawer(), 
              color_mask = custom_blue_color )

png

HorizontalBarsDrawer

qr.make_image(image_factory = StyledPilImage, 
              module_drawer = HorizontalBarsDrawer(), 
              color_mask = custom_blue_color)

png

VerticalBarsDrawer

qr.make_image(image_factory = StyledPilImage, 
              module_drawer = VerticalBarsDrawer(), 
              color_mask = custom_blue_color )

png