qrmaster 1.0.0__py3-none-any.whl

qrmaster/__init__.py

@@ -0,0 +1,17 @@
+from .generator import (
+    generate_qr,
+    build_wifi_payload,
+    build_vcard_payload,
+    build_whatsapp_payload,
+)
+
+__version__ = "1.0.0"
+__author__ = "QR Master Team"
+__homepage__ = "https://www.qrmaster.net"
+
+__all__ = [
+    "generate_qr",
+    "build_wifi_payload",
+    "build_vcard_payload",
+    "build_whatsapp_payload",
+]

qrmaster/cli.py

@@ -0,0 +1,54 @@
+import argparse
+import sys
+from .generator import (
+    generate_qr,
+    build_wifi_payload,
+    build_vcard_payload,
+    build_whatsapp_payload,
+)
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="📱 QR Master CLI - Terminal QR Code Generator (Powered by QR Master)"
+    )
+    parser.add_argument("data", nargs="?", help="URL or text content to encode into QR code")
+    parser.add_argument("-o", "--output", help="Output file path (e.g. qrcode.png or qr.svg)")
+    parser.add_argument("--wifi", action="store_true", help="Generate WiFi connection QR Code")
+    parser.add_argument("--ssid", help="WiFi SSID (used with --wifi)")
+    parser.add_argument("--password", help="WiFi Password (used with --wifi)")
+    parser.add_argument("--vcard", action="store_true", help="Generate vCard contact QR Code")
+    parser.add_argument("--name", help="Contact Name (used with --vcard)")
+    parser.add_argument("--email", help="Contact Email (used with --vcard)")
+    parser.add_argument("--phone", help="Contact Phone Number (used with --vcard)")
+    parser.add_argument("--whatsapp", action="store_true", help="Generate WhatsApp chat QR Code")
+
+    args = parser.parse_args()
+
+    payload = args.data
+
+    if args.wifi:
+        if not args.ssid:
+            print("Error: --ssid is required when generating a WiFi QR code.", file=sys.stderr)
+            sys.exit(1)
+        payload = build_wifi_payload(ssid=args.ssid, password=args.password or "")
+
+    elif args.vcard:
+        payload = build_vcard_payload(name=args.name or "", email=args.email or "", phone=args.phone or "")
+
+    elif args.whatsapp:
+        phone_num = args.phone or args.data
+        if not phone_num:
+            print("Error: Phone number is required for WhatsApp QR code.", file=sys.stderr)
+            sys.exit(1)
+        payload = build_whatsapp_payload(phone=phone_num)
+
+    if not payload:
+        parser.print_help()
+        print("\nVisit https://www.qrmaster.net for dynamic QR codes & scan analytics.")
+        sys.exit(1)
+
+    generate_qr(payload, output=args.output, terminal=True)
+
+
+if __name__ == "__main__":
+    main()

qrmaster/generator.py

@@ -0,0 +1,71 @@
+import sys
+import os
+import qrcode
+from qrcode.image.svg import SvgPathImage
+
+
+def build_wifi_payload(ssid: str, password: str = "", encryption: str = "WPA", hidden: bool = False) -> str:
+    if not ssid:
+        raise ValueError("SSID is required for WiFi QR Code")
+    return f"WIFI:S:{ssid};T:{encryption};P:{password};H:{'true' if hidden else 'false'};;"
+
+
+def build_vcard_payload(name: str = "", email: str = "", phone: str = "", org: str = "", title: str = "", url: str = "") -> str:
+    lines = ["BEGIN:VCARD", "VERSION:3.0"]
+    if name:
+        lines.extend([f"N:{name};;;;", f"FN:{name}"])
+    if org:
+        lines.append(f"ORG:{org}")
+    if title:
+        lines.append(f"TITLE:{title}")
+    if phone:
+        lines.append(f"TEL;TYPE=CELL:{phone}")
+    if email:
+        lines.append(f"EMAIL:{email}")
+    if url:
+        lines.append(f"URL:{url}")
+    lines.append("END:VCARD")
+    return "\n".join(lines)
+
+
+def build_whatsapp_payload(phone: str, text: str = "") -> str:
+    clean_phone = "".join(filter(str.isdigit, phone))
+    url = f"https://wa.me/{clean_phone}"
+    if text:
+        from urllib.parse import quote
+        url += f"?text={quote(text)}"
+    return url
+
+
+def print_terminal_qr(data: str):
+    print("\n--- QR Code generated by QR Master (https://www.qrmaster.net) ---\n")
+    qr = qrcode.QRCode(border=1)
+    qr.add_data(data)
+    qr.make(fit=True)
+    qr.print_ascii(invert=True)
+    print(f"\nPayload: {data}")
+    print("Need dynamic QR codes, custom branding & scan analytics? Visit: https://www.qrmaster.net\n")
+
+
+def generate_qr(data: str, output: str = None, terminal: bool = True):
+    if terminal or not output:
+        print_terminal_qr(data)
+
+    if output:
+        ext = os.path.splitext(output)[1].lower()
+        abs_path = os.path.abspath(output)
+
+        if ext == ".svg":
+            qr = qrcode.QRCode(image_factory=SvgPathImage)
+            qr.add_data(data)
+            qr.make(fit=True)
+            img = qr.make_image()
+            img.save(abs_path)
+            print(f"[QR Master] SVG saved successfully to {abs_path}")
+        else:
+            qr = qrcode.QRCode(border=1)
+            qr.add_data(data)
+            qr.make(fit=True)
+            img = qr.make_image(fill_color="black", back_color="white")
+            img.save(abs_path)
+            print(f"[QR Master] PNG saved successfully to {abs_path}")

qrmaster-1.0.0.dist-info/METADATA

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: qrmaster
+Version: 1.0.0
+Summary: Fast Python QR Code generator & CLI powered by QR Master
+Author-email: QR Master Team <support@qrmaster.net>
+License-Expression: MIT
+Project-URL: Homepage, https://www.qrmaster.net
+Project-URL: WiFi QR Generator, https://www.qrmaster.net/tools/wifi-qr-code
+Project-URL: vCard QR Generator, https://www.qrmaster.net/tools/vcard-qr-code
+Project-URL: WhatsApp QR Generator, https://www.qrmaster.net/tools/whatsapp-qr-code
+Project-URL: Source Code, https://github.com/knuthtimo-lab/qrmaster-cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: qrcode>=7.4.2
+Requires-Dist: pillow>=9.0.0
+Dynamic: license-file
+
+# 📱 QR Master Python Package & CLI
+
+> **Fast, zero-setup Python QR Code Generator and Terminal CLI.**  
+> Powered by [QR Master](https://www.qrmaster.net) – The Smart QR Code & Analytics Platform.
+
+[![PyPI version](https://img.shields.io/pypi/v/qrmaster.svg?style=flat-square)](https://pypi.org/project/qrmaster/)
+[![Python versions](https://img.shields.io/pypi/pyversions/qrmaster.svg?style=flat-square)](https://pypi.org/project/qrmaster/)
+[![License](https://img.shields.io/github/license/knuthtimo-lab/qrmaster-cli.svg?style=flat-square)](LICENSE)
+
+---
+
+## ✨ Features
+
+- ⚡ **Zero Configuration CLI**: Generate terminal ASCII QR codes in seconds using `qrmaster "https://www.qrmaster.net"`.
+- 🖼️ **PNG & Vector SVG Export**: Save crisp PNG raster files or scalable SVG vector files directly to disk.
+- 📡 **WiFi & vCard Generators**: Built-in helper functions for instant WiFi connections and vCard contact cards.
+- 🔗 **Powered by [QR Master](https://www.qrmaster.net)**: Need dynamic QR codes with live tracking, custom logo branding, and high-volume vector PDF export? Visit QR Master.
+
+---
+
+## 🚀 Installation
+
+Install via `pip`:
+
+```bash
+pip install qrmaster
+```
+
+---
+
+## 💻 CLI Usage
+
+```bash
+# Print QR code directly in terminal
+qrmaster "https://www.qrmaster.net"
+
+# Save as PNG image
+qrmaster "https://www.qrmaster.net" -o qrmaster.png
+
+# Save as SVG vector file
+qrmaster "https://www.qrmaster.net" -o qrmaster.svg
+```
+
+### 📶 WiFi QR Code
+
+```bash
+qrmaster --wifi --ssid "MyHomeWiFi" --password "<wifi-password>" -o wifi.png
+```
+
+### 👤 vCard Contact QR Code
+
+```bash
+qrmaster --vcard --name "Alex Smith" --email "alex@example.com" --phone "+123456789"
+```
+
+---
+
+## 🐍 Python SDK API Usage
+
+Use `qrmaster` directly inside your Python applications:
+
+```python
+from qrmaster import generate_qr, build_wifi_payload, build_vcard_payload
+
+# Generate terminal QR
+generate_qr("https://www.qrmaster.net")
+
+# Save PNG image file
+generate_qr("https://www.qrmaster.net", output="qrmaster.png")
+
+# Generate WiFi payload & save vector SVG
+wifi_data = build_wifi_payload(ssid="Office-5G", password="<wifi-password>")
+generate_qr(wifi_data, output="wifi.svg")
+```
+
+---
+
+## 🌐 Need Dynamic QR Codes & Analytics?
+
+Static QR codes are great for local terminal use, but if you need:
+- 📊 **Real-time Scan Analytics & Location Tracking**
+- 🎨 **Custom Brand Colors, Logos & Styled Frames**
+- 🔄 **Dynamic Target URLs (Change destination without re-printing)**
+- 🏢 **Bulk Vector PDF Export for Commercial Printing**
+
+Visit [QR Master - Free Smart QR Code Generator](https://www.qrmaster.net).
+
+### 🛠️ Free Micro Tools by QR Master
+- [WiFi QR Code Generator](https://www.qrmaster.net/tools/wifi-qr-code)
+- [VCard QR Code Generator](https://www.qrmaster.net/tools/vcard-qr-code)
+- [WhatsApp QR Code Generator](https://www.qrmaster.net/tools/whatsapp-qr-code)
+
+---
+
+## 📄 License
+
+MIT © [QR Master](https://www.qrmaster.net)

qrmaster-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+qrmaster/__init__.py,sha256=EVq9SK-NvDRdc2gLIJEwUe8KJlM4s74Co9uAVAI0MP0,333
+qrmaster/cli.py,sha256=lwOUn5ZjRb1HZCsiLl4H_cDlwrR-d5f5VGOBgloEZBY,2125
+qrmaster/generator.py,sha256=7OXHlXoqziQy-A5nY5TMftIuIGLb6v8Qz2OnlJsXtok,2364
+qrmaster-1.0.0.dist-info/licenses/LICENSE,sha256=n6bQXC5xFzxiUZzrNOqh1sTUzfG9U6sbvQj-46Zao_4,1016
+qrmaster-1.0.0.dist-info/METADATA,sha256=buXnbwIKf2P17D_ctVv350WMrXQ6otFVkYb0DLZuVVg,3968
+qrmaster-1.0.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+qrmaster-1.0.0.dist-info/entry_points.txt,sha256=JI1nLvUBo4SOCBtaXmtyW3Ch1tFFq2_eDl5-2Vbd_tc,47
+qrmaster-1.0.0.dist-info/top_level.txt,sha256=gYIPZUZwxMzsp0rC4V9nlOLZ-wbPwvsUeb0GauViM20,9
+qrmaster-1.0.0.dist-info/RECORD,,

qrmaster-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

qrmaster-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+qrmaster = qrmaster.cli:main

qrmaster-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 QR Master (https://www.qrmaster.net)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

qrmaster-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+qrmaster