qrcode-pretty 1.0.3__py3-none-any.whl

qrcode_pretty/__init__.py

@@ -0,0 +1,13 @@
+"""Pretty QR Code - Generate beautiful, customizable QR codes."""
+
+__version__ = "1.0.0"
+
+from .qr_code_generator import make_qrcode, make_qrcode_svg
+from .const import DRAWER_CLASSES, ERROR_CORRECTION_LEVELS
+
+__all__ = [
+    "make_qrcode",
+    "make_qrcode_svg",
+    "DRAWER_CLASSES",
+    "ERROR_CORRECTION_LEVELS",
+]

qrcode_pretty/const.py

@@ -0,0 +1,42 @@
+#!/usr/bin/env python
+
+from qrcode.image.styles.moduledrawers.pil import (
+    SquareModuleDrawer,
+    GappedSquareModuleDrawer,
+    CircleModuleDrawer,
+    RoundedModuleDrawer,
+    VerticalBarsDrawer,
+    HorizontalBarsDrawer
+)
+
+from qrcode.constants import (
+    ERROR_CORRECT_L,
+    ERROR_CORRECT_M,
+    ERROR_CORRECT_Q,
+    ERROR_CORRECT_H
+)
+
+ALLOWED_STYLES = {
+    "square",
+    "gapped-square",
+    "circle",
+    "round",
+    "vertical-bars",
+    "horizontal-bars"
+}
+
+DRAWER_CLASSES = {
+    "square": SquareModuleDrawer,
+    "gapped-square": GappedSquareModuleDrawer,
+    "circle": CircleModuleDrawer,
+    "round": RoundedModuleDrawer,
+    "vertical-bars": VerticalBarsDrawer,
+    "horizontal-bars": HorizontalBarsDrawer,
+}
+
+ERROR_CORRECTION_LEVELS = {
+    "L": ERROR_CORRECT_L,
+    "M": ERROR_CORRECT_M,
+    "Q": ERROR_CORRECT_Q,
+    "H": ERROR_CORRECT_H
+}

qrcode_pretty/entrypoint.py

@@ -0,0 +1,139 @@
+#!/usr/bin/env python
+
+import sys
+import getopt
+from .qr_code_generator import make_qrcode, make_qrcode_svg
+from .const import DRAWER_CLASSES, ERROR_CORRECTION_LEVELS
+
+def print_usage():
+    print("""Usage: qrcode-pretty [options]
+
+Options:
+  -h, --help                  Show this help message and exit
+  -d, --data <data>           Data to encode in QR code (required)
+  -i, --image <image>         Input image file name (optional)
+  -s, --style <style>         Style for the QR code modules (optional)
+      --style-inner <style>   Style for the inner eyes (optional)
+      --style-outer <style>   Style for the outer eyes (optional)
+  -b, --base <hex>            Base color hex code (e.g. #000000)
+  -n, --color-inner <hex>     Inner eye color hex code
+  -r, --color-outer <hex>     Outer eye color hex code
+  -o, --output <dir>          Output directory path (default: ~/Pictures/qrcode-pretty/)
+      --svg                   Also generate SVG output (optional flag)
+      --version <int>         QR version (default: 5)
+      --box-size <int>        Box size in pixels (default: 10)
+      --border <int>          Border size in boxes (default: 4)
+      --error-correction <L|M|Q|H>  Error correction level (default: H)
+
+Available styles: square, gapped-square, circle, round, vertical-bars, horizontal-bars
+
+Example:
+  entrypoint.py -d "https://example.com" -i logo.png -b #000000 -n #000fff -r #fff000 -o ./output --style circle --style-inner square --style-outer circle --svg
+""")
+
+def main(argv=None):
+    if argv is None:
+        argv = sys.argv[1:]
+
+    kwargs = {}
+    include_svg = False
+
+    try:
+        opts, args = getopt.getopt(
+            argv,
+            "hi:o:d:b:n:r:s:",
+            [
+                "image=",
+                "output=",
+                "data=",
+                "base=",
+                "color-inner=",
+                "color-outer=",
+                "svg",
+                "style=",
+                "style-inner=",
+                "style-outer=",
+                "version=",
+                "box-size=",
+                "border=",
+                "error-correction="
+            ]
+        )
+    except getopt.GetoptError:
+        print_usage()
+        sys.exit(2)
+
+    for opt, arg in opts:
+        if opt == '-h':
+            print_usage()
+            sys.exit()
+
+        elif opt in ("-d", "--data"):
+            kwargs["input_data"] = arg
+
+        elif opt in ("-i", "--image"):
+            kwargs["input_image"] = arg
+
+        elif opt in ("-s", "--style"):
+            if arg not in DRAWER_CLASSES:
+                print(f"Error: style '{arg}' not recognized. Choose one of: {', '.join(DRAWER_CLASSES.keys())}")
+                sys.exit(1)
+            kwargs["drawer_instance"] = DRAWER_CLASSES[arg]()
+
+        elif opt == "--style-inner":
+            if arg not in DRAWER_CLASSES:
+                print(f"Error: style-inner '{arg}' not recognized. Choose one of: {', '.join(DRAWER_CLASSES.keys())}")
+                sys.exit(1)
+            kwargs["drawer_instance_inner"] = DRAWER_CLASSES[arg]()
+
+        elif opt == "--style-outer":
+            if arg not in DRAWER_CLASSES:
+                print(f"Error: style-outer '{arg}' not recognized. Choose one of: {', '.join(DRAWER_CLASSES.keys())}")
+                sys.exit(1)
+            kwargs["drawer_instance_outer"] = DRAWER_CLASSES[arg]()
+
+        elif opt in ("-b", "--base"):
+            kwargs["base_color"] = arg
+
+        elif opt in ("-n", "--color-inner"):
+            kwargs["inner_eye_color"] = arg
+
+        elif opt in ("-r", "--color-outer"):
+            kwargs["outer_eye_color"] = arg
+
+        elif opt == "--version":
+            kwargs["version"] = int(arg)
+
+        elif opt == "--box-size":
+            kwargs["box_size"] = int(arg)
+
+        elif opt == "--border":
+            kwargs["border"] = int(arg)
+
+        elif opt == "--error-correction":
+            ec_levels = ERROR_CORRECTION_LEVELS
+            arg_upper = arg.upper()
+            if arg_upper in ec_levels:
+                kwargs["error_correction"] = ec_levels[arg_upper]
+            else:
+                print("Invalid error correction level. Choose from: L, M, Q, H.")
+                sys.exit(1)
+
+        elif opt in ("-o", "--output"):
+            kwargs["output_dir"] = arg
+
+        elif opt == "--svg":
+            include_svg = True
+
+    if "input_data" not in kwargs:
+        print("Error: Missing required option --data/-d")
+        print_usage()
+        sys.exit(1)
+
+    make_qrcode(**kwargs)
+
+    if include_svg:
+        make_qrcode_svg(kwargs["input_data"], kwargs.get("output_dir", "~/Pictures/qrcode-pretty/"))
+
+if __name__ == "__main__":
+    main(sys.argv[1:])

qrcode_pretty/qr_code_generator.py

@@ -0,0 +1,309 @@
+#!/usr/bin/env python
+
+import qrcode
+from qrcode.constants import ERROR_CORRECT_H
+import qrcode.image.svg
+from qrcode.image.styles.moduledrawers.svg import SvgSquareDrawer
+from qrcode.image.styledpil import StyledPilImage
+from qrcode.image.styles.moduledrawers.pil import RoundedModuleDrawer
+from qrcode.image.styles.colormasks import RadialGradiantColorMask, SolidFillColorMask
+from PIL import Image, ImageDraw
+import os
+import sys
+
+
+# Custom function for eye styling. These create the eye masks
+class Qr_image_parts:
+    def __init__(
+        self,
+        embeded_image_name,
+        inner_eyes_image,
+        inner_eye_mask,
+        outer_eyes_image,
+        outer_eye_mask,
+        qr_image,
+        qr_image_simple,
+    ) -> None:
+        self.embeded_image_name = embeded_image_name
+        self.inner_eyes_image = inner_eyes_image
+        self.inner_eye_mask = inner_eye_mask
+        self.outer_eyes_image = outer_eyes_image
+        self.outer_eye_mask = outer_eye_mask
+        self.qr_image = qr_image
+        self.qr_image_simple = qr_image_simple
+
+
+def find_default_image():
+    """Find the default image in standard locations.
+    
+    Searches for the default image in the following order:
+    1. Environment variable DEFAULT_IMAGE (highest priority)
+    2. System-wide install: /usr/share/qrcode-pretty/assets/default.png
+    3. Python prefix install: {sys.prefix}/share/qrcode-pretty/assets/default.png
+    4. Local development: ./assets/default.png
+    5. Package relative: ../../assets/default.png (from module directory)
+    
+    Returns:
+        str: Path to the default image, or fallback to ./assets/default.png
+    """
+    search_paths = [
+        os.environ.get("DEFAULT_IMAGE"),
+        "/usr/share/qrcode-pretty/assets/default.png",
+        os.path.join(sys.prefix, "share/qrcode-pretty/assets/default.png"),
+        "./assets/default.png",
+        os.path.join(os.path.dirname(__file__), "..", "..", "assets", "default.png"),
+    ]
+    
+    for path in search_paths:
+        if path and os.path.isfile(path):
+            return path
+    
+    return "./assets/default.png"
+
+
+def hex_to_rgb(hex):
+    hex = hex.lstrip("#")
+    return (
+        int(hex[0:2], 16),
+        int(hex[2:4], 16),
+        int(hex[4:6], 16),
+    )
+
+
+def style_inner_eyes(image, box_size=10, border=4, modules_count=37):
+    mask = Image.new("L", image.size, 0)
+    draw = ImageDraw.Draw(mask)
+
+    def draw_eye(x_mod, y_mod):
+        # Offset by 2 modules to land in center of 7x7 eye
+        x = (border + x_mod + 2) * box_size
+        y = (border + y_mod + 2) * box_size
+        draw.rectangle((x, y, x + 3 * box_size, y + 3 * box_size), fill=255)
+
+    draw_eye(0, 0)  # top-left
+    draw_eye(modules_count - 7, 0)  # top-right
+    draw_eye(0, modules_count - 7)  # bottom-left
+
+    return mask
+
+
+def style_outer_eyes(image, box_size=10, border=4, modules_count=37):
+    img_size = image.size[0]
+    mask = Image.new("L", image.size, 0)
+    draw = ImageDraw.Draw(mask)
+
+    def draw_eye(x_mod, y_mod):
+        x = border * box_size + x_mod * box_size
+        y = border * box_size + y_mod * box_size
+        draw.rectangle((x, y, x + 7 * box_size, y + 7 * box_size), fill=255)
+        draw.rectangle(
+            (x + 2 * box_size, y + 2 * box_size, x + 5 * box_size, y + 5 * box_size),
+            fill=0,
+        )
+
+    draw_eye(0, 0)  # top-left
+    draw_eye(modules_count - 7, 0)  # top-right
+    draw_eye(0, modules_count - 7)  # bottom-left
+
+    return mask
+
+
+# Create a QR code instance
+def create_qrcode_instance(
+    version=5, error_correction=ERROR_CORRECT_H, box_size=10, border=4
+):
+    return qrcode.QRCode(
+        version=version,
+        error_correction=error_correction,
+        box_size=box_size,
+        border=border,
+    )
+
+
+# Add data to the QR code
+def add_data(qr, input_data):
+    qr.add_data(input_data)
+    qr.make(fit=True)
+
+
+# Create an image from the QR code instance
+def create_image(
+    qr,
+    input_image,
+    drawer_instance,
+    drawer_instance_inner,
+    drawer_instance_outer,
+    base_color,
+    inner_eye_color,
+    outer_eye_color,
+    version,
+    error_correction,
+    box_size,
+    border,
+):
+    inner_eyes_image = qr.make_image(
+        image_factory=StyledPilImage,
+        eye_drawer=drawer_instance_inner,
+        color_mask=SolidFillColorMask(front_color=hex_to_rgb(inner_eye_color)),
+    )
+
+    outer_eyes_image = qr.make_image(
+        image_factory=StyledPilImage,
+        eye_drawer=drawer_instance_outer,
+        color_mask=SolidFillColorMask(front_color=hex_to_rgb(outer_eye_color)),
+    )
+
+    embeded_image_name = input_image
+
+    if embeded_image_name == "default":
+        embeded_image_path = find_default_image()
+    elif embeded_image_name:
+        path_expanded = os.path.expanduser(embeded_image_name)
+        if os.path.isfile(path_expanded):
+            embeded_image_path = path_expanded
+        else:
+            embeded_image_path = None
+    else:
+        embeded_image_path = None
+
+    kwargs = {
+        "image_factory": StyledPilImage,
+        "module_drawer": drawer_instance,
+        "color_mask": SolidFillColorMask(front_color=hex_to_rgb(base_color)),
+    }
+    if embeded_image_path:
+        kwargs["embeded_image_path"] = embeded_image_path
+
+    qr_image = qr.make_image(**kwargs)
+
+    qr_image_simple = qr.make_image(
+        image_factory=StyledPilImage,
+        module_drawer=drawer_instance,
+        color_mask=SolidFillColorMask(front_color=hex_to_rgb(base_color)),
+    )
+
+    inner_eye_mask = style_inner_eyes(qr_image, box_size, border, qr.modules_count)
+    outer_eye_mask = style_outer_eyes(qr_image, box_size, border, qr.modules_count)
+    return Qr_image_parts(
+        embeded_image_name,
+        inner_eyes_image,
+        inner_eye_mask,
+        outer_eyes_image,
+        outer_eye_mask,
+        qr_image,
+        qr_image_simple,
+    )
+
+
+# Generate qr code based on image input
+def generate_qr_code(qr, qr_image_parts, drawer_instance):
+    qr_image_parts.inner_eyes_image = qr_image_parts.inner_eyes_image.convert("RGBA")
+    qr_image_parts.outer_eyes_image = qr_image_parts.outer_eyes_image.convert("RGBA")
+    qr_image_parts.qr_image = qr_image_parts.qr_image.convert("RGBA")
+    qr_image_parts.inner_eye_mask = qr_image_parts.inner_eye_mask.convert("L")
+    qr_image_parts.outer_eye_mask = qr_image_parts.outer_eye_mask.convert("L")
+
+    if (
+        not qr_image_parts.embeded_image_name
+        or qr_image_parts.embeded_image_name == "blank"
+    ):
+        intermediate_image = Image.composite(
+            qr_image_parts.inner_eyes_image,
+            qr_image_parts.qr_image_simple,
+            qr_image_parts.inner_eye_mask,
+        )
+    elif qr_image_parts.embeded_image_name == "default":
+        intermediate_image = Image.composite(
+            qr_image_parts.inner_eyes_image,
+            qr_image_parts.qr_image,
+            qr_image_parts.inner_eye_mask,
+        )
+    else:
+        embeded_image_path = os.path.expanduser(qr_image_parts.embeded_image_name)
+        if not os.path.isabs(embeded_image_path) and not os.path.isfile(
+            embeded_image_path
+        ):
+            embeded_image_path = os.path.join("./assets/", embeded_image_path)
+
+        qr_image = qr.make_image(
+            image_factory=StyledPilImage,
+            module_drawer=drawer_instance,
+            embeded_image_path=embeded_image_path,
+        )
+        intermediate_image = Image.composite(
+            qr_image_parts.inner_eyes_image, qr_image, qr_image_parts.inner_eye_mask
+        )
+
+    return Image.composite(
+        qr_image_parts.outer_eyes_image,
+        intermediate_image,
+        qr_image_parts.outer_eye_mask,
+    )
+
+
+# Save the image to a file
+def save_image(final_image, output_dir):
+    output_dir = os.path.expanduser(output_dir)  # Expand tilde
+    if not os.path.exists(output_dir):
+        print(f"Output directory '{output_dir}' does not exist. Creating it.")
+        os.makedirs(output_dir)
+    result_path = os.path.join(output_dir, "qrcode.png")
+    print("Saving qr-code (png) to: ", result_path)
+    final_image.save(result_path)
+
+
+# main function that calls all steps needed to make a qrcode
+def make_qrcode(
+    input_data,
+    input_image=None,
+    drawer_instance=RoundedModuleDrawer(),
+    drawer_instance_inner=RoundedModuleDrawer(),
+    drawer_instance_outer=RoundedModuleDrawer(),
+    base_color="#000000",
+    inner_eye_color="#000000",
+    outer_eye_color="#000000",
+    version=5,
+    error_correction=ERROR_CORRECT_H,
+    box_size=10,
+    border=4,
+    output_dir="~/Pictures/qrcode-pretty/",
+):
+    qr = create_qrcode_instance(
+        version=version,
+        error_correction=error_correction,
+        box_size=box_size,
+        border=border,
+    )
+    add_data(qr, input_data)
+    qr_image_parts = create_image(
+        qr,
+        input_image,
+        drawer_instance,
+        drawer_instance_inner,
+        drawer_instance_outer,
+        base_color,
+        inner_eye_color,
+        outer_eye_color,
+        version,
+        error_correction,
+        box_size,
+        border,
+    )
+    final_image = generate_qr_code(qr, qr_image_parts, drawer_instance)
+    save_image(final_image, output_dir)
+
+
+# Additionaly to the png qrcode an svg is created as well
+def make_qrcode_svg(input_data, output_dir="~/Pictures/qrcode-pretty/"):
+    output_dir = os.path.expanduser(output_dir)  # Expand tilde
+    qr = create_qrcode_instance()
+    add_data(qr, input_data)
+    qr_svg = qr.make_image(
+        image_factory=qrcode.image.svg.SvgImage,
+        module_drawer=SvgSquareDrawer(),
+    )
+    if not os.path.exists(output_dir):
+        os.makedirs(output_dir)
+    result_path = os.path.join(output_dir, "qrcode.svg")
+    print("Saving qr-code (svg) to: ", result_path)
+    qr_svg.save(result_path)

qrcode_pretty-1.0.3.dist-info/METADATA

@@ -0,0 +1,330 @@
+Metadata-Version: 2.4
+Name: qrcode-pretty
+Version: 1.0.3
+Summary: A tool which generates pretty QR codes
+Project-URL: Homepage, https://www.afkdev8.com/
+Project-URL: Repository, https://github.com/mrinfinidy/qrcode-pretty
+Project-URL: Issues, https://github.com/mrinfinidy/qrcode-pretty/issues
+Author-email: afkdev8 <mail@afkdev8.com>
+License: MIT
+License-File: LICENSE
+Keywords: customizable,generator,pretty,qr,qrcode
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Multimedia :: Graphics
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: pillow>=9.0
+Requires-Dist: qrcode[pil]>=7.0
+Description-Content-Type: text/markdown
+
+# Pretty QR Code
+
+![Banner](./samples/banner.png)
+
+## Overview
+
+Generate pretty QR codes.
+
+Pretty QR Code uses the [python-qrcode](https://github.com/lincolnloop/python-qrcode) library to generate qr codes
+and provides various options to customize the qrcode.
+You can adjust style, color and add an image in the middle.
+Check out the usage for all available options.
+
+## Installation
+
+### NixOS
+
+This tool is packaged as a NixOS package. You can install it using the following flake input:
+
+```nix
+qrcode-pretty = {
+  url = "github:mrinfinidy/qrcode-pretty";
+  inputs.nixpkgs.follows = "nixpkgs";
+};
+```
+
+Add the flake input to the outputs:
+
+```nix
+outputs = {
+  # your other outputs
+  qrcode-pretty,
+  ...
+}@inputs:
+```
+
+Then add to your home-manager config:
+
+```nix
+home-manager.users.<your-user> = {
+    home.packages = [
+        (inputs.qrcode-pretty.packages.${pkgs.system}.default)
+    ];
+};
+```
+
+Or build and run directly:
+
+```bash
+# Build with Nix
+nix build github:mrinfinidy/qrcode-pretty#qrcode-pretty
+
+# Run from local checkout
+nix run .#qrcode-pretty -- -d "your data here"
+```
+
+### Debian/Ubuntu
+
+Download and install the `.deb` package from the [releases page](https://github.com/mrinfinidy/qrcode-pretty/releases):
+
+```bash
+# Download the latest .deb package
+wget https://github.com/mrinfinidy/qrcode-pretty/releases/download/<version>/qrcode-pretty_<version>-1_all.deb
+
+# Install the package
+sudo dpkg -i qrcode-pretty_<version>-1_all.deb
+
+# Install dependencies if needed
+sudo apt-get install -f
+```
+
+Or build from source (see [PACKAGING.md](PACKAGING.md) for details):
+
+```bash
+dpkg-buildpackage -us -uc -b
+sudo dpkg -i ../qrcode-pretty_<version>-1_all.deb
+```
+
+### Arch Linux (AUR)
+
+Install from the AUR using your preferred AUR helper:
+
+```bash
+# Using yay
+yay -S qrcode-pretty
+
+# Using paru
+paru -S qrcode-pretty
+
+# Or manually with makepkg
+git clone https://aur.archlinux.org/qrcode-pretty.git
+cd qrcode-pretty
+makepkg -si
+```
+
+### Using uv
+
+[uv](https://github.com/astral-sh/uv) is a fast Python package installer and resolver, which I prefer over pip/pipx:
+
+```bash
+uv tool install qrcode-pretty
+```
+
+### Using pipx
+
+For installing as a standalone command-line tool:
+
+```bash
+pipx install qrcode-pretty
+```
+
+## Development
+
+### Requirements
+
+- Python 3.8 or higher
+- Dependencies (automatically installed):
+  - qrcode[pil] >= 7.0
+  - pillow >= 9.0
+
+### Setting Up Development Environment
+
+#### Using NixOS
+
+```bash
+# Clone the repository
+git clone https://github.com/mrinfinidy/qrcode-pretty.git
+cd qrcode-pretty
+
+# Enter development shell
+nix-shell
+
+# Or use the flake development shell
+nix develop
+```
+
+#### Using uv
+
+```bash
+# Clone the repository
+git clone https://github.com/mrinfinidy/qrcode-pretty.git
+cd qrcode-pretty
+
+# Create virtual environment and install in editable mode
+uv venv
+source .venv/bin/activate  # On Linux/Mac
+# or: .venv\Scripts\activate  # On Windows
+
+uv pip install -e .
+
+# Run the tool
+qrcode-pretty -d "test"
+```
+
+#### Using pip/venv
+
+```bash
+# Clone the repository
+git clone https://github.com/mrinfinidy/qrcode-pretty.git
+cd qrcode-pretty
+
+# Create and activate virtual environment
+python -m venv .venv
+source .venv/bin/activate  # On Linux/Mac
+# or: .venv\Scripts\activate  # On Windows
+
+# Install in editable mode
+pip install -e .
+
+# Run the tool
+qrcode-pretty -d "test"
+```
+
+### Building the Package
+
+#### With Nix
+
+```bash
+# Build with Nix
+nix build .#qrcode-pretty
+
+# Result will be in ./result/
+./result/bin/qrcode-pretty --help
+```
+
+#### With uv
+
+```bash
+# Build wheel and source distribution
+uv build
+
+# Output will be in dist/ e.g.:
+# - dist/qrcode_pretty-1.0.0-py3-none-any.whl
+# - dist/qrcode_pretty-1.0.0.tar.gz
+```
+
+## Usage
+
+Pretty QR Code provides the `qrcode-pretty` command-line tool.
+
+### Basic Usage
+
+Generate a QR code with minimal options:
+
+```bash
+qrcode-pretty -d "https://github.com/mrinfinidy/qrcode-pretty"
+```
+
+### Command-Line Options
+
+Use `qrcode-pretty -h` to print all available options:
+
+```
+Options:
+  -h, --help                  Show this help message and exit
+  -d, --data <data>           Data to encode in QR code (required)
+  -i, --image <image>         Input image file name (optional)
+  -s, --style <style>         Style for the QR code modules (optional)
+      --style-inner <style>   Style for the inner eyes (optional)
+      --style-outer <style>   Style for the outer eyes (optional)
+  -b, --base <hex>            Base color hex code (e.g. #000000)
+  -n, --color-inner <hex>     Inner eye color hex code
+  -r, --color-outer <hex>     Outer eye color hex code
+  -o, --output <dir>          Output directory path (default: ~/Pictures/qrcode-pretty/)
+      --svg                   Also generate SVG output (optional flag)
+      --version <int>         QR version (default: 5)
+      --box-size <int>        Box size in pixels (default: 10)
+      --border <int>          Border size in boxes (default: 4)
+      --error-correction <L|M|Q|H>  Error correction level (default: H)
+
+Available styles: square, gapped-square, circle, round, vertical-bars, horizontal-bars
+```
+
+**Note:** When embedding a center image (logo), it is recommended to use a high error correction level (default: H).
+
+**About the `--image` option:**
+
+- Use `--image /path/to/your/logo.png` to embed your own image in the QR code center
+- Use `--image default` to use the bundled demonstration image (included with all installation methods)
+- Omit `--image` to generate a QR code without a center image
+
+### Sample Gallery
+
+#### QR Code Github
+
+![qrcode github cat](./samples/qrcode-cat.png)
+
+`qrcode-pretty --data "https://github.com/mrinfinidy/qrcode-pretty" --image default --style circle --style-inner round --style-outer round --base "#000000" --color-inner "#ff7373" --color-outer "#000000" --output "~/Pictures/"`
+
+![qrcode github cat 2](./samples/qrcode-cat-2.png)
+
+`qrcode-pretty --data "https://github.com/mrinfinidy/qrcode-pretty" --image default --style round --style-inner round --style-outer round --base "#1d2021" --color-inner "#d3869b" --color-outer "#458588" --output "~/Pictures/"`
+
+![qrcode github](./samples/qrcode-purple.png)
+
+`qrcode-pretty --data "https://github.com/mrinfinidy/qrcode-pretty" --style round --style-inner round --style-outer round --base "#8e8ece" --color-inner "#6cf2e5" --color-outer "#40E0D0" --output "~/Pictures/"`
+
+#### QR Code afkdev8 (my homepage)
+
+![qrcode afkdev8 vertical-bars](./samples/qrcode-afkdev8-vertical.png)
+
+`qrcode-pretty --data "https://www.afkdev8.com/" --image "~/Pictures/afkdev8-logo.png" --style vertical-bars --style-inner round --style-outer round --base "#000000" --color-inner "#000000" --color-outer "#000000" --output "~/Pictures/"`
+
+![qrcode afkdev8 horizontal-bars](./samples/qrcode-afkdev-horizontal.png)
+
+`qrcode-pretty --data "https://www.afkdev8.com/" --image "~/Pictures/afkdev8-logo-dark.png" --style horizontal-bars --style-inner round --style-outer round --base "#000000" --color-inner "#000000" --color-outer "#000000" --output "~/Pictures/"`
+
+#### QR Code lemons
+
+![qrcode lemons](./samples/qrcode-lemons.png)
+
+`qrcode-pretty --data "lemons" --image "~/Pictures/lemons.png" --style square --style-inner circle --style-outer gapped-square --base "#000000" --color-inner "#000000" --color-outer "#000000" --output "~/Pictures/"`
+
+## Package Information
+
+This package follows modern Python packaging standards:
+
+- **Package Name**: `qrcode-pretty`
+- **Module Name**: `qrcode_pretty`
+- **Build System**: [Hatchling](https://hatch.pypa.io/)
+- **Configuration**: `pyproject.toml` (PEP 621 compliant)
+- **Minimum Python**: 3.8+
+
+### Project Structure
+
+```
+qrcode-pretty/
+├── src/
+│   └── qrcode_pretty/
+│       ├── __init__.py
+│       ├── entrypoint.py
+│       ├── qr_code_generator.py
+│       └── const.py
+├── pyproject.toml
+├── README.md
+└── LICENSE
+```
+
+## Author
+
+afkdev8 `<mail@afkdev8.com>`

qrcode_pretty-1.0.3.dist-info/RECORD

@@ -0,0 +1,9 @@
+qrcode_pretty/__init__.py,sha256=a0RS5WI9lpnyvidWQ6R909Oh838Xh65NYsCQbrQKp3k,319
+qrcode_pretty/const.py,sha256=ANaVKVKpBnDurwT7soNVuBv_A-0LlFs7wKvSM4Zeops,864
+qrcode_pretty/entrypoint.py,sha256=a5_wOgQibn747XSXkuz5HSmahzKxSs3FIfNKpWga8Yw,4659
+qrcode_pretty/qr_code_generator.py,sha256=bWh2l8f4M_c72zhE_5NM5mmfy-QWQ6bXpr8Wc01bh7M,9735
+qrcode_pretty-1.0.3.dist-info/METADATA,sha256=jZWrqpjs3mX7uwoRJoGHLSFMtFkql3vU_j2rnDLXRRk,9105
+qrcode_pretty-1.0.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+qrcode_pretty-1.0.3.dist-info/entry_points.txt,sha256=H-vyuHOFhAZ9rxl1sH5uAtrTxP14grG8aDHmxVt3Ifc,64
+qrcode_pretty-1.0.3.dist-info/licenses/LICENSE,sha256=ScPJeyY_mS7hVKFT8hPad2QVMSsj1_5BScGXidtDZgE,4697
+qrcode_pretty-1.0.3.dist-info/RECORD,,

qrcode_pretty-1.0.3.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

qrcode_pretty-1.0.3.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+qrcode-pretty = qrcode_pretty.entrypoint:main

qrcode_pretty-1.0.3.dist-info/licenses/LICENSE

@@ -0,0 +1,103 @@
+MIT License
+
+Copyright (c) 2025 afkdev8
+
+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 ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES 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.
+
+--- BEGIN DEPENDENCY LICENSES ---
+
+Copyright (c) 2011, Lincoln Loop
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+    * Redistributions of source code must retain the above copyright notice,
+      this list of conditions and the following disclaimer.
+    * Redistributions in binary form must reproduce the above copyright notice,
+      this list of conditions and the following disclaimer in the documentation
+      and/or other materials provided with the distribution.
+    * Neither the package name nor the names of its contributors may be
+      used to endorse or promote products derived from this software without
+      specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+
+-------------------------------------------------------------------------------
+
+
+Original text and license from the pyqrnative package where this was forked
+from (http://code.google.com/p/pyqrnative):
+
+#Ported from the Javascript library by Sam Curren
+#
+#QRCode for Javascript
+#http://d-project.googlecode.com/svn/trunk/misc/qrcode/js/qrcode.js
+#
+#Copyright (c) 2009 Kazuhiko Arase
+#
+#URL: http://www.d-project.com/
+#
+#Licensed under the MIT license:
+#   http://www.opensource.org/licenses/mit-license.php
+#
+# The word "QR Code" is registered trademark of
+# DENSO WAVE INCORPORATED
+#   http://www.denso-wave.com/qrcode/faqpatent-e.html
+
+The Python Imaging Library (PIL) is
+
+    Copyright © 1997-2011 by Secret Labs AB
+    Copyright © 1995-2011 by Fredrik Lundh and contributors
+
+Pillow is the friendly PIL fork. It is
+
+    Copyright © 2010 by Jeffrey A. Clark and contributors
+
+Like PIL, Pillow is licensed under the open source MIT-CMU License:
+
+By obtaining, using, and/or copying this software and/or its associated
+documentation, you agree that you have read, understood, and will comply
+with the following terms and conditions:
+
+Permission to use, copy, modify and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appears in all copies, and that
+both that copyright notice and this permission notice appear in supporting
+documentation, and that the name of Secret Labs AB or the author not be
+used in advertising or publicity pertaining to distribution of the software
+without specific, written prior permission.
+
+SECRET LABS AB AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS
+SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS.
+IN NO EVENT SHALL SECRET LABS AB OR THE AUTHOR BE LIABLE FOR ANY SPECIAL,
+INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE
+OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.