betterqr 0.1.0__tar.gz

betterqr-0.1.0/PKG-INFO

@@ -0,0 +1,5 @@
+Metadata-Version: 2.4
+Name: betterqr
+Version: 0.1.0
+Author: DevX-Dragon
+Requires-Dist: pillow>=10.0.0

betterqr-0.1.0/README.md

@@ -0,0 +1,4 @@
+![image](https://cdn.hackclub.com/019ead26-8c58-711a-bd9b-c3dcc19c367f/image.png)
+
+# BetterQR
+The upgraded qrcode library for Python. Features an CLI and normal code support as well!. Comes packed with many features.

betterqr-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["setuptools>=61.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "betterqr"
+version = "0.1.0"
+authors = [{ name = "DevX-Dragon" }]
+dependencies = [
+    "pillow>=10.0.0"
+]
+
+[project.scripts]
+betterqr = "betterqr.cli:main"

betterqr-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

betterqr-0.1.0/src/betterqr/__init__.py

@@ -0,0 +1,6 @@
+from .core import (
+    QR, WiFi, VCard, MeCard, GeoLocation,
+    Event, SMS, Email, Phone, Crypto, batch
+)
+__version__ = "2.0.0"
+__all__ = ["QR","WiFi","VCard","MeCard","GeoLocation","Event","SMS","Email","Phone","Crypto","batch"]

betterqr-0.1.0/src/betterqr/cli.py

@@ -0,0 +1,307 @@
+"""
+betterqr CLI
+============
+The cleanest QR code generator in your terminal.
+
+BASIC USAGE
+  betterqr "https://example.com"                    → qr.png
+  betterqr "Hello World" out.png
+  betterqr "https://example.com" out.svg
+
+SHAPES
+  betterqr "text" -s circle
+  betterqr "text" -s rounded
+  betterqr "text" -s diamond / star / gapped
+
+COLORS
+  betterqr "text" --fill "#6C3082" --back "#F3E8FF"
+  betterqr "text" --fill "#000" --back transparent
+
+GRADIENTS
+  betterqr "text" --gradient "#FF6B6B" "#4ECDC4"
+  betterqr "text" --gradient "#1d4ed8" "#7c3aed" --gradient-dir radial
+
+LOGO
+  betterqr "https://mysite.com" --logo logo.png
+  betterqr "https://mysite.com" --logo logo.png --logo-ratio 0.3 -e H
+
+FRAME & LABEL
+  betterqr "Scan Me!" --frame rounded --label "Visit our site"
+  betterqr "Scan Me!" --frame fancy --label "WiFi Password: abc123"
+
+ANIMATION (saves .gif)
+  betterqr "Hello" out.gif --effect shimmer
+  betterqr "Hello" out.gif --effect matrix --fps 12
+  betterqr "Hello" out.gif --effect wave --frames 30
+
+DATA TYPES
+  betterqr --wifi MyNet MyPassword
+  betterqr --wifi MyNet MyPassword --security WEP
+  betterqr --contact "Jane Doe" --phone "+1-555-0199" --email "jane@example.com"
+  betterqr --geo 51.5074 -0.1278
+  betterqr --sms "+1-555-0199" "Hello!"
+  betterqr --email "hi@example.com" "Subject" "Body text"
+  betterqr --phone "+1-800-555-0199"
+
+TERMINAL PREVIEW
+  betterqr "Hello" --print
+  betterqr "Hello" --print --invert
+Note: Add stuff here as well if you contribute lol
+"""
+import argparse
+import sys
+import os
+
+
+def _color(s):
+    """Validate a color argument."""
+    if s.lower() == 'transparent': return s
+    if not s.startswith('#'): s = '#' + s
+    s = s.lstrip('#')
+    if len(s) not in (3, 6):
+        raise argparse.ArgumentTypeError(f"Invalid color '{s}'. Use hex like #FF0000 or #F00")
+    return '#' + s
+
+
+def main():
+    p = argparse.ArgumentParser(
+        prog="betterqr",
+        description="BetterQR — Beautiful, scannable QR codes. Zero external QR dependencies.",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+        epilog=__doc__,
+        add_help=True,
+    )
+
+    # ── Core ──────────────────────────────────────────────────────────
+    p.add_argument("data",   nargs="?", help="Data to encode (text, URL, etc.)")
+    p.add_argument("output", nargs="?", default="qr.png",
+                   help="Output file (.png .jpg .svg .gif) [default: qr.png]")
+
+    # ── QR settings ───────────────────────────────────────────────────
+    qr = p.add_argument_group("QR settings")
+    qr.add_argument("-e", "--ecc", default="M", choices=["L","M","Q","H"],
+                    metavar="L|M|Q|H",
+                    help="Error correction: L=7%% M=15%% Q=25%% H=30%% [default: M]. Use H with logos.")
+    qr.add_argument("-v", "--version", type=int, metavar="1-40",
+                    help="Force QR version 1-40 (auto-selected by default)")
+    qr.add_argument("--box-size", type=int, default=10, metavar="PX",
+                    help="Pixels per module [default: 10]")
+    qr.add_argument("--border", type=int, default=4, metavar="N",
+                    help="Quiet zone width in modules [default: 4]")
+
+    # ── Style ─────────────────────────────────────────────────────────
+    st = p.add_argument_group("Style")
+    st.add_argument("-s", "--shape", default="square",
+                    choices=["square","circle","rounded","diamond","star","gapped",
+                             "vertical_bar","horizontal_bar"],
+                    metavar="SHAPE",
+                    help="Module shape [default: square]\n"
+                         "  square | circle | rounded | diamond | star | gapped | vertical_bar | horizontal_bar")
+    st.add_argument("--fill", default="#000000", type=_color, metavar="COLOR",
+                    help="Dark module color [default: #000000]")
+    st.add_argument("--back", default="#FFFFFF", type=_color, metavar="COLOR",
+                    help="Background color [default: #FFFFFF] (use 'transparent' for PNG alpha)")
+    st.add_argument("--finder", type=_color, metavar="COLOR",
+                    help="Separate color for the 3 finder squares")
+
+    # ── Gradient ──────────────────────────────────────────────────────
+    gr = p.add_argument_group("Gradient")
+    gr.add_argument("--gradient", nargs=2, metavar=("START","END"),
+                    help="Two colors for a gradient fill. Example: --gradient '#FF6B6B' '#4ECDC4'")
+    gr.add_argument("--gradient-dir", default="diagonal",
+                    choices=["horizontal","vertical","diagonal","radial"],
+                    metavar="DIR",
+                    help="Gradient direction [default: diagonal]\n"
+                         "  horizontal | vertical | diagonal | radial")
+
+    # ── Logo ──────────────────────────────────────────────────────────
+    lo = p.add_argument_group("Logo / image")
+    lo.add_argument("--logo", metavar="PATH",
+                    help="Embed a logo/image in the center of the QR code (PNG/JPG)")
+    lo.add_argument("--logo-ratio", type=float, default=0.25, metavar="0.1-0.35",
+                    help="Logo size as fraction of QR total size [default: 0.25]")
+    lo.add_argument("--logo-shape", default="square",
+                    choices=["square","circle","rounded"],
+                    help="Logo background shape [default: square]")
+
+    # ── Frame / label ─────────────────────────────────────────────────
+    fr = p.add_argument_group("Frame & label")
+    fr.add_argument("--frame", metavar="STYLE",
+                    choices=["simple","rounded","double","shadow","fancy"],
+                    help="Add a decorative frame: simple | rounded | double | shadow | fancy")
+    fr.add_argument("--frame-color", type=_color, default="#000000", metavar="COLOR",
+                    help="Frame color [default: #000000]")
+    fr.add_argument("--label", metavar="TEXT",
+                    help="Text label to add below (or above) the QR code")
+    fr.add_argument("--label-above", action="store_true",
+                    help="Place label above the QR instead of below")
+    fr.add_argument("--label-color", type=_color, default="#000000", metavar="COLOR")
+    fr.add_argument("--label-size", type=int, default=14, metavar="PX")
+
+    # ── Animation ─────────────────────────────────────────────────────
+    an = p.add_argument_group("Animation (saves .gif)")
+    an.add_argument("--effect", metavar="EFFECT",
+                    choices=["shimmer","fade","scan","pulse","build","matrix",
+                             "wave","blink","typewriter","rotate"],
+                    help="Animation effect:\n"
+                         "  shimmer | fade | scan | pulse | build |\n"
+                         "  matrix  | wave | blink | typewriter | rotate")
+    an.add_argument("--frames", type=int, default=20, metavar="N",
+                    help="Number of animation frames [default: 20]")
+    an.add_argument("--fps", type=int, default=15, metavar="N",
+                    help="Animation playback speed [default: 15]")
+    an.add_argument("--accent", type=_color, metavar="COLOR",
+                    help="Accent color for some animation effects")
+
+    # ── Data type shortcuts ───────────────────────────────────────────
+    dt = p.add_argument_group("Data type shortcuts")
+    dt.add_argument("--wifi", nargs="+", metavar=("SSID", "PASS"),
+                    help="Wi-Fi QR: --wifi SSID [PASSWORD]")
+    dt.add_argument("--security", default="WPA", choices=["WPA","WEP","nopass"],
+                    help="Wi-Fi security type [default: WPA]")
+    dt.add_argument("--contact", metavar="NAME",
+                    help="vCard contact QR (use with --phone --email --org --url)")
+    dt.add_argument("--phone", metavar="NUMBER",
+                    help="Phone number (for --contact or standalone tel: QR)")
+    dt.add_argument("--email", nargs="+", metavar=("ADDRESS", "SUBJECT"),
+                    help="Email QR: --email ADDRESS [SUBJECT] [BODY]")
+    dt.add_argument("--org",  metavar="NAME", help="Organization (for --contact)")
+    dt.add_argument("--url",  metavar="URL",  help="URL (for --contact)")
+    dt.add_argument("--geo",  nargs=2, metavar=("LAT","LON"),
+                    help="Location QR: --geo 51.5074 -0.1278")
+    dt.add_argument("--sms",  nargs=2, metavar=("PHONE","MSG"),
+                    help="SMS QR: --sms PHONE 'Message body'")
+
+    # ── Output ────────────────────────────────────────────────────────
+    ou = p.add_argument_group("Output")
+    ou.add_argument("--print", action="store_true",
+                    help="Print QR to terminal (works alongside file output)")
+    ou.add_argument("--invert", action="store_true",
+                    help="Invert terminal colors (for dark-background terminals)")
+    ou.add_argument("--terminal-style", default="block",
+                    choices=["block","ascii","compact"],
+                    help="Terminal render style [default: block]")
+    ou.add_argument("--info", action="store_true",
+                    help="Print QR code metadata (version, size, mode, etc.)")
+
+    args = p.parse_args()
+
+    # ── Build data payload ────────────────────────────────────────────
+    from .core import QR, WiFi, VCard, GeoLocation, SMS, Email, Phone
+
+    data = None
+
+    if args.wifi:
+        ssid = args.wifi[0]
+        pw   = args.wifi[1] if len(args.wifi) > 1 else ""
+        data = WiFi(ssid, pw, args.security)
+
+    elif args.contact:
+        data = VCard(
+            name    = args.contact,
+            phone   = args.phone or "",
+            email   = args.email[0] if args.email else "",
+            org     = args.org   or "",
+            url     = args.url   or "",
+        )
+
+    elif args.geo:
+        data = GeoLocation(float(args.geo[0]), float(args.geo[1]))
+
+    elif args.sms:
+        data = SMS(args.sms[0], args.sms[1])
+
+    elif args.email and not args.contact:
+        addr    = args.email[0]
+        subject = args.email[1] if len(args.email) > 1 else ""
+        body    = args.email[2] if len(args.email) > 2 else ""
+        data = Email(addr, subject, body)
+
+    elif args.phone and not args.contact:
+        data = Phone(args.phone)
+
+    elif args.data:
+        data = args.data
+
+    else:
+        p.print_help()
+        sys.exit(1)
+
+    # ── Build QR ─────────────────────────────────────────────────────
+    try:
+        qr = QR(data, ecc=args.ecc, version=args.version)
+    except ValueError as e:
+        print(f"✗ Error: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    # ── Apply style ───────────────────────────────────────────────────
+    fill = args.fill
+    if args.gradient:
+        qr.gradient(args.gradient[0], args.gradient[1], args.gradient_dir)
+    else:
+        qr.style(fill=fill, back=args.back, shape=args.shape,
+                 finder=args.finder, box_size=args.box_size, border=args.border)
+
+    # Gradient + shape/back
+    if args.gradient:
+        qr._shape = args.shape
+        qr._back  = args.back
+        qr._box_size = args.box_size
+        qr._border   = args.border
+        if args.finder: qr._finder_color = args.finder
+
+    # Logo
+    if args.logo:
+        qr.logo(args.logo, ratio=args.logo_ratio, shape=args.logo_shape)
+
+    # Frame / label
+    if args.frame or args.label:
+        frame_style = args.frame or "simple"
+        qr.frame(
+            style          = frame_style,
+            color          = args.frame_color,
+            label          = args.label,
+            label_color    = args.label_color,
+            label_size     = args.label_size,
+            label_position = "top" if args.label_above else "bottom",
+        )
+
+    # Animation
+    if args.effect:
+        qr.animate(
+            effect = args.effect,
+            frames = args.frames,
+            fps    = args.fps,
+            accent = args.accent,
+        )
+        # Force .gif output if not already
+        if not args.output.lower().endswith(".gif"):
+            args.output = args.output.rsplit(".", 1)[0] + ".gif"
+
+    # ── Info ─────────────────────────────────────────────────────────
+    if args.info:
+        info = qr.info()
+        print("QR Code Info")
+        print("─" * 30)
+        for k, v in info.items():
+            print(f"  {k:<14} {v}")
+        print()
+
+    # ── Terminal print ────────────────────────────────────────────────
+    if getattr(args, 'print'):
+        print(qr.to_terminal(style=args.terminal_style, invert=args.invert))
+
+    # ── Save file ─────────────────────────────────────────────────────
+    if args.output:
+        try:
+            qr.save(args.output)
+            ext = args.output.rsplit('.',1)[-1].upper()
+            print(f"✓ Saved {args.output}  "
+                  f"[v{qr.version} ECC-{qr.ecc_level}  {qr.module_count}×{qr.module_count} modules]")
+        except Exception as e:
+            print(f"✗ Failed to save: {e}", file=sys.stderr)
+            sys.exit(1)
+
+
+if __name__ == "__main__":
+    main()