{"id":26273918,"url":"https://github.com/dadananjesha/taggenerator","last_synced_at":"2026-02-14T03:39:38.676Z","repository":{"id":281375841,"uuid":"216060653","full_name":"DadaNanjesha/TagGenerator","owner":"DadaNanjesha","description":"TagGenerator is a lightweight Django project featuring a reusable app for generating stylish QR codes. It’s designed for seamless integration, allowing you to quickly embed and customize QR codes in your web applications.","archived":false,"fork":false,"pushed_at":"2025-03-14T01:39:14.000Z","size":904,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-01T05:04:00.448Z","etag":null,"topics":["ci-cd","django-application","djnago-project","docker","open-source","open-source-project","publishing","pypi-package","qr-code-generator","qrcode","tag-generation"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/TagGenerator/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DadaNanjesha.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-18T16:03:06.000Z","updated_at":"2025-03-28T20:31:26.000Z","dependencies_parsed_at":"2025-03-08T21:43:40.902Z","dependency_job_id":null,"html_url":"https://github.com/DadaNanjesha/TagGenerator","commit_stats":null,"previous_names":["dadananjesha/taggenerator","dadananjesha/tag-generator"],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadaNanjesha%2FTagGenerator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadaNanjesha%2FTagGenerator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadaNanjesha%2FTagGenerator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DadaNanjesha%2FTagGenerator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DadaNanjesha","download_url":"https://codeload.github.com/DadaNanjesha/TagGenerator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252590552,"owners_count":21772936,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ci-cd","django-application","djnago-project","docker","open-source","open-source-project","publishing","pypi-package","qr-code-generator","qrcode","tag-generation"],"created_at":"2025-03-14T09:17:16.393Z","updated_at":"2025-10-05T02:23:31.100Z","avatar_url":"https://github.com/DadaNanjesha.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n# TagGenerator - Django QR Code Generator 💫📱\n\n[![PyPI version](https://img.shields.io/pypi/v/django-qrcode.svg)](https://pypi.org/project/django-qrcode/) \n[![Python Version](https://img.shields.io/badge/Python-3.8%2B-blue.svg)](https://www.python.org/) \n[![Django Version](https://img.shields.io/badge/Django-3.2%2B-brightgreen.svg)](https://www.djangoproject.com/) \n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) \n[![Latest Release](https://img.shields.io/github/release/DadaNanjesha/tag-generator.svg)](https://github.com/DadaNanjesha/tag-generator/releases) \n[![django status](https://github.com/DadaNanjesha/TagGenerator/actions/workflows/django.yml/badge.svg)](https://github.com/DadaNanjesha/TagGenerator/actions/workflows/django.yml?query=branch%3Amain)\n[![python-publish status](https://github.com/DadaNanjesha/TagGenerator/actions/workflows/python-publish.yml/badge.svg)](https://github.com/DadaNanjesha/TagGenerator/actions/workflows/python-publish.yml?query=branch%3Amain)\n[![publish-docker status](https://github.com/DadaNanjesha/TagGenerator/actions/workflows/publish-docker.yml/badge.svg)](https://github.com/DadaNanjesha/TagGenerator/actions/workflows/publish-docker.yml?query=branch%3Amain)\n\n_TagGenerator is a sleek, reusable Django app for generating stylish, customizable QR codes on the fly. Easily integrate it into your web applications and give your project that extra visual flair!_\n\n---\n\n## 📖 Table of Contents\n\n- [Overview](#overview)\n- [Key Features](#key-features)\n- [Flow Diagram](#flow-diagram)\n- [Project Structure](#project-structure)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Deployments](#deployments)\n- [Releases \u0026 Packages](#releases--packages)\n- [Contributing](#contributing)\n- [License](#license)\n- [Acknowledgements](#acknowledgements)\n\n---\n\n## 🔍 Overview\n\nIn today’s fast-paced digital world, QR codes serve as an essential bridge between offline and online experiences. **TagGenerator** delivers a dynamic, stylish QR code generation solution for Django projects. With advanced styling options like rounded modules and radial gradients, you can create QR codes that are both functional and visually appealing.\n\n---\n\n## ✨ Key Features\n\n- **⚡ Dynamic Generation:** Create QR codes in real time for any URL or text.\n- **🎨 Advanced Styling:** Customize QR codes with rounded modules, gradient colors, and more.\n- **🔌 Reusable Django App:** Seamlessly plug into any Django project with minimal setup.\n- **📝 Custom Template Tag:** Easily render QR codes in templates using `{% qrcode_url %}`.\n- **🐳 Docker Ready:** Simplify deployments with a pre-built Docker image.\n- **🛠️ CI/CD Integration:** Automated testing and releases with GitHub Actions.\n\n---\n\n## 🔄 Flow Diagram\n\n```mermaid\nflowchart TD\n    A[📥 Input: Text or URL] --\u003e B[🔧 QR Code Generation]\n    B --\u003e C[🎨 Apply Styling Options]\n    C --\u003e D[📤 Output: Styled QR Code Image]\n    D --\u003e E[🖥️ Embed in Django Templates]\n```\n\n---\n\n## 🗂️ Project Structure\n\n```plaintext\nTagGenerator/\n├── .github/                  # GitHub Actions workflows for CI/CD 🚀\n├── Dockerfile                # Docker configuration for containerized deployment 🐳\n├── QrCode/                   # Reusable Django app for QR code generation\n│   ├── migrations/           # Database migrations\n│   ├── templates/            # Django templates (includes custom tag usage)\n│   ├── templatetags/         # Custom template tags (e.g., qrcode_tags.py) 🏷️\n│   ├── urls.py               # URL configuration for the QRCode app\n│   └── views.py              # Views to render QR codes\n├── TagGenerator/             # Main Django project directory\n│   ├── settings.py           # Project settings (including app configurations)\n│   ├── urls.py               # Root URL configurations\n│   └── wsgi.py               # WSGI configuration for deployment\n├── manage.py                 # Django project management script\n├── requirements.txt          # Python dependencies 📦\n├── setup.py                  # Setup script for packaging and PyPI publishing\n├── LICENSE                   # MIT License\n└── README.md                 # Project documentation (this file) 📖\n```\n\n---\n\n## 💻 Installation\n\n### From PyPI\n\nInstall the package directly via pip:\n\n```bash\npip install TagGenerator\n```\n\n### Manual Setup\n\n1. **Clone the Repository:**\n\n   ```bash\n   git clone https://github.com/DadaNanjesha/tag-generator.git\n   cd tag-generator\n   ```\n\n2. **Set Up a Virtual Environment:**\n\n   ```bash\n   python -m venv venv\n   source venv/bin/activate  # Windows: venv\\Scripts\\activate\n   ```\n\n3. **Install Dependencies:**\n\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Install in Editable Mode (for development):**\n\n   ```bash\n   pip install -e .\n   ```\n\n---\n\n## 🚀 Usage\n\n### Integrate into Your Django Project\n\n1. **Add to Installed Apps:**  \n   In your `settings.py`:\n\n   ```python\n   INSTALLED_APPS = [\n       # ... other apps\n       \"QrCode\",\n   ]\n   ```\n\n2. **Include URL Configuration:**  \n   Update your project's `urls.py`:\n\n   ```python\n   from django.urls import include, path\n\n   urlpatterns = [\n       # ... other URL patterns\n       path(\"qrcode/\", include(\"QrCode.urls\", namespace=\"qrcode\")),\n   ]\n   ```\n\n3. **Embed QR Code in Templates:**  \n   Load the custom template tag and render a QR code:\n\n   ```django\n   {% load qrcode_tags %}\n   \u003cimg src=\"{% qrcode_url 'https://example.com' %}\" alt=\"QR Code\"\u003e\n   ```\n\n4. **Demo:**  \n   Access the demo at `http://\u003cyour-domain\u003e/qrcode/` to see your QR code in action.\n\n---\n\n## 🐳 Deployments\n\n### Docker Deployment\n\nUse Docker for a consistent environment:\n\n1. **Build the Docker Image:**\n\n   ```bash\n   docker build -t dadananjesha/tag-generator .\n   ```\n\n2. **Run the Docker Container:**\n\n   ```bash\n   docker run -d -p 8000:8000 dadananjesha/tag-generator\n   ```\n\nVisit `http://localhost:8000/qrcode/` to view your app.\n\n### CI/CD\n\nTagGenerator leverages GitHub Actions for continuous integration. Check out the workflows in the [`.github/workflows`](.github/workflows) directory for more details.\n\n---\n\n## 🏷️ Releases \u0026 Packages\n\n- **Releases:**  \n  The latest release is [v1.0.2](https://github.com/DadaNanjesha/tag-generator/releases/tag/v1.0.2) (Mar 8, 2025). Each release includes detailed notes on fixes and new features.\n\n- **Packages:**  \n  TagGenerator is available on [PyPI](https://pypi.org/project/django-qrcode/). We follow Semantic Versioning to ensure stability.\n\n- **Publishing Workflow:**  \n  To release a new version:\n  1. **Tag the Release:**\n     ```bash\n     git tag vX.Y.Z\n     git push --tags\n     ```\n  2. **Build the Distribution:**\n     ```bash\n     python setup.py sdist bdist_wheel\n     ```\n  3. **Upload with Twine:**\n     ```bash\n     twine upload dist/*\n     ```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! Here’s how you can help:\n\n1. **Fork the Repository**\n2. **Create a Feature Branch:**\n   ```bash\n   git checkout -b feature/your-feature-name\n   ```\n3. **Commit Your Changes:**  \n   Write clear, descriptive commit messages.\n4. **Push and Submit a Pull Request:**  \n   Please open an issue first for major changes.\n\n---\n\n## ⭐️ Support \u0026 Call-to-Action\n\nIf you find this project useful, please consider:\n- **Starring** the repository ⭐️\n- **Forking** the project to contribute enhancements\n- **Following** for updates on future improvements\n\nYour engagement helps increase visibility and encourages further collaboration!\n\n---\n\n## 📜 License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n\n## 🙏 Acknowledgements\n\n- **Built With:** Django, Python, and the qrcode library.\n- **Inspiration:** Designed to provide an elegant and customizable QR code solution.\n- **CI/CD:** Thanks to GitHub Actions for seamless integration and deployment.\n\n---\n\n*Happy coding and may your QR codes always be stylish! 🚀✨*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdadananjesha%2Ftaggenerator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdadananjesha%2Ftaggenerator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdadananjesha%2Ftaggenerator/lists"}