Gerador de QR Code Personalizado

Este projeto oferece um gerador de QR Code flexível e personalizável que permite aos usuários criar códigos QR únicos com vários estilos para marcadores, bordas e módulos de dados.

Características

• Gera códigos QR com estilos personalizáveis
• Múltiplos estilos de marcadores (Quadrado, Arredondado, Círculo, Quarto de Círculo, Estrela, Diamante, Cruz)
• Vários estilos de borda (Quadrado, Arredondado, Círculo, Quarto de Círculo, Quarto de Círculo Suave, Quarto Circular, Circular, Quadrado Arredondado)
• Diferentes estilos de linha para módulos de dados (Quadrado, Quadrado com Espaço, Círculo, Arredondado, Barras Verticais, Barras Horizontais)
• Opção para adicionar uma imagem central ao código QR

Instalação

1. Clone este repositório:

   git clone https://github.com/nathanvsn/gerador-qr-code-personalizado.git
   cd gerador-qr-code-personalizado
   

2. Crie um ambiente virtual (opcional, mas recomendado):

   python -m venv venv
   source venv/bin/activate  # No Windows, use `venv\Scripts\activate`
   

3. Instale as dependências necessárias:

   pip install -r requirements.txt
   

Uso

Aqui está um exemplo básico de como usar o Gerador de QR Code Personalizado:

from qr_code_generator.generator import QRCodeGenerator
from qr_code_generator.styles.marker_styles import MarkerStyle
from qr_code_generator.styles.border_styles import BorderStyle
from qr_code_generator.styles.line_styles import LineStyle

qr_generator = QRCodeGenerator()
qr_img = qr_generator.create_custom_qr(
    "https://www.exemplo.com.br",
    size=10,
    border=4,
    marker_style=MarkerStyle.PLUS,
    border_style=BorderStyle.CIRCLE,
    line_style=LineStyle.ROUNDED,
    center_image="caminho/para/imagem_central.png"
)
qr_img.save("qr_code_personalizado.png")
qr_img.show()

Opções de Personalização

Opções de Personalização

Estilos de Marcadores

Estilo	Código	Visualização
Quadrado	MarkerStyle.SQUARE
Arredondado	MarkerStyle.ROUNDED
Círculo	MarkerStyle.CIRCLE
Quarto de Círculo	MarkerStyle.QUARTER_CIRCLE
Estrela	MarkerStyle.STAR
Diamante	MarkerStyle.DIAMOND
Cruz	MarkerStyle.PLUS

Estilos de Borda

Estilo	Código	Visualização
Quadrado	BorderStyle.SQUARE
Arredondado	BorderStyle.ROUNDED
Círculo	BorderStyle.CIRCLE
Quarto de Círculo	BorderStyle.QUARTER_CIRCLE
Quarto de Círculo Suave	BorderStyle.SMOOTH_QUARTER_CIRCLE
Quarto Circular	BorderStyle.CIRCULAR_QUARTER
Circular	BorderStyle.CIRCULAR
Quadrado Arredondado	BorderStyle.ROUNDED_SQUARE

Estilos de Linha

• LineStyle.SQUARE (Quadrado)
• LineStyle.GAPPED_SQUARE (Quadrado com Espaço)
• LineStyle.CIRCLE (Círculo)
• LineStyle.ROUNDED (Arredondado)
• LineStyle.VERTICAL_BARS (Barras Verticais)
• LineStyle.HORIZONTAL_BARS (Barras Horizontais)

Exemplos

Aqui estão alguns exemplos de diferentes estilos de códigos QR que você pode criar:

1. Estilo circular com módulos de dados arredondados:

   qr_img = qr_generator.create_custom_qr(
       "https://www.exemplo.com.br",
       marker_style=MarkerStyle.CIRCLE,
       border_style=BorderStyle.CIRCLE,
       line_style=LineStyle.ROUNDED
   )

2. Marcadores em estrela com borda quadrada:

   qr_img = qr_generator.create_custom_qr(
       "https://www.exemplo.com.br",
       marker_style=MarkerStyle.STAR,
       border_style=BorderStyle.SQUARE,
       line_style=LineStyle.SQUARE
   )

3. Marcadores em diamante com barras verticais para módulos de dados:

   qr_img = qr_generator.create_custom_qr(
       "https://www.exemplo.com.br",
       marker_style=MarkerStyle.DIAMOND,
       border_style=BorderStyle.ROUNDED_SQUARE,
       line_style=LineStyle.VERTICAL_BARS
   )

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

1. Faça um fork do repositório
2. Crie sua branch de feature (git checkout -b feature/NovaFuncionalidade)
3. Faça commit de suas mudanças (git commit -m 'Adiciona alguma NovaFuncionalidade')
4. Faça push para a branch (git push origin feature/NovaFuncionalidade)
5. Abra um Pull Request

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

Agradecimentos

• qrcode - A biblioteca base para geração de QR Code
• Pillow - Para processamento de imagens
• cairosvg - Para conversão de SVG para PNG

Contato

Nathan Nóbrega - [email protected]

Link do Projeto: https://github.com/nathanvsn/gerador-qr-code-personalizado