TagGenerator 1.0.0

A reusable Django app for QR Code generation

Django QRCode Generator

Welcome to Django QRCode Generator : A sleek, reusable Django app that creates stunning, customizable QR codes on the fly. With advanced styling options like rounded modules and radial gradients, you can generate QR codes that are not only functional but also visually appealing.

---

✨ Features

• Dynamic Generation: Instantly generate QR codes for any text or URL.
• Advanced Styling: Beautiful QR codes with rounded modules and gradient colors.
• Plug-and-Play: Seamlessly integrate with any Django project.
• Custom Template Tag: Easily embed QR codes in your templates using {% qrcode_url %}.
• Responsive UI: A simple frontend interface for quick testing and demos.

---

🚀 Installation

Install the package directly from PyPI:

pip install django-qrcode

---

⚡ Quick Start

1. Add to Installed Apps

In your Django project's settings.py, add QrCode to your INSTALLED_APPS:

INSTALLED_APPS = [
    # ... your other apps
    "QrCode",
]

2. Include URL Configuration

Update your main urls.py file to include the QRCode app URLs:

from django.urls import include, path

urlpatterns = [
    # ... your other URL patterns
    path("qrcode/", include("QrCode.urls", namespace="qrcode")),
]

3. Embed QR Code in Templates

Use the custom template tag to render a QR code in your template:

{% load qrcode_tags %}
<img src="{% qrcode_url 'https://example.com' %}" alt="QR Code">

4. Try the Demo Frontend

Navigate to the QRCode app’s homepage to see a live demo:

http://<your-domain>/qrcode/

---

🛠 Development & Testing

Clone the repository and set up your development environment:

git clone https://github.com/yourusername/TagGenerator.git
cd TagGenerator
pip install -r requirements.txt
pip install -e .

Run tests with:

python manage.py test

And enjoy continuous integration with our GitHub Actions workflow!

---

🚢 Publishing to PyPI

To release a new version:

1. Tag the Release:

   git tag v1.0.0
   git push --tags
   

2. Build the Distribution:

   python setup.py sdist bdist_wheel
   

3. Upload with Twine:

   twine upload dist/*
   

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.

---

🤝 Contributing

Contributions are welcome! If you'd like to enhance this project, please check the issues and submit a pull request.

---

🙏 Acknowledgements

• Built with Django and qrcode.
• Inspired by the need for beautiful and integrated QR code solutions in Django.

---

Happy Coding! 🎉