qltool 0.2.4__tar.gz → 0.2.6__tar.gz

{qltool-0.2.4 → qltool-0.2.6}/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 0.2.4
+current_version = 0.2.6
 commit = True
 tag = True
 

qltool-0.2.6/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: qltool
+Version: 0.2.6
+Summary: PRINT simple labels on ql700
+Requires-Python: >=3.10
+Requires-Dist: click>=8.2.1
+Requires-Dist: console>=0.9911
+Requires-Dist: importlib-resources>=6.5.2
+Requires-Dist: opencv-python>=4.12.0.88
+Requires-Dist: paho-mqtt>=2.1.0
+Requires-Dist: pillow>=11.3.0
+Requires-Dist: qrcode>=8.2
+Description-Content-Type: text/markdown
+
+# qltool 0.2.4
+
+*Tool to print labels with Brother QL-700/QL-570 label printer*
+
+A wrapper around the excellent `ql570.c` by Asbjørn Sloth Tønnesen, Marc Juul and Luca Zimmermann.
+
+## Features
+
+- Print text labels (1-3 lines)
+- Print QR codes with text
+- Print banners (text along paper length)
+- Custom font sizes
+- MQTT client for remote printing
+- Preview before printing
+
+## Installation
+
+Using `uv` (recommended):
+
+```bash
+uv pip install -e .
+```
+
+Or with pip:
+
+```bash
+pip3 install qltool
+```
+
+## Usage
+
+### Standard Label Print
+
+Print 1-3 lines of text:
+
+```bash
+# Preview only
+uv run src/qltool/main.py "Line 1" "Line 2" "Line 3" --font-size 40
+
+# Print with specific font size
+uv run src/qltool/main.py "Hello World" "Second line" -p --font-size 55
+```
+
+### QR Code Labels
+
+```bash
+# Generate and print QR code with text
+uv run src/qltool/main.py "Item: 12345" "Location: Office" -q -p
+
+# Use existing QR image
+uv run src/qltool/main.py "Scan me" --qr /path/to/qrcode.png -p
+```
+
+### Banner Mode (Text along paper length)
+
+```bash
+# Preview banner
+uv run src/qltool/main.py "Long text banner" --banner --font-size 40
+
+# Print banner
+uv run src/qltool/main.py "STS Chvojkovice-Brod" --banner --font-size 40 -p
+```
+
+### Command Options
+
+- `-p, --print` - Send to printer (without this, shows preview)
+- `-q, --qr` - Generate QR code
+- `--qr PATH` - Use existing QR image
+- `--banner` - Create banner (text along paper length)
+- `--font-size N` - Set font size (default: 72)
+- `--width N` - Set image width in pixels (default: 714 for 62mm tape)
+- `--gray N` - Gray bias 0-100 (default: 50)
+- `-d, --device` - Specify printer device (default: auto-detect /dev/usb/lp*)
+
+## MQTT Client
+
+Run the MQTT client for remote printing:
+
+```bash
+qltool_client
+```
+
+Send print jobs via MQTT:
+
+```bash
+# Simple print
+mosquitto_pub -t qltool/print -m "Hello World -p"
+
+# With QR code
+mosquitto_pub -t qltool/print -m "Inventory Item -q -p"
+
+# Banner
+mosquitto_pub -t qltool/print -m "Long banner text --banner -p"
+```
+
+## Development
+
+Run directly from source:
+
+```bash
+# Preview
+uv run src/qltool/main.py "Test text" --font-size 40
+
+# Print
+uv run src/qltool/main.py "Test text" --font-size 40 -p
+```
+
+## Requirements
+
+- Brother QL-700 or QL-570 printer
+- User must be in `lp` group for printer access
+- Linux with USB lp device support (`/dev/usb/lp*`)
+
+## Org-mode Integration (Inventory)
+
+For Emacs org-mode table integration:
+
+```elisp
+;; Add to .emacs
+(defun print-inventory-item ()
+  "Print current org table row as label"
+  (interactive)
+  ;; Your implementation here
+  )
+```
+
+Example table format:
+
+| ID          | Name                        | Owner | Location |
+|-------------|-----------------------------|-------|----------|
+| D4-12345678 | Sample inventory item       | Pepa  | Home     |
+
+The tool can extract ID and name fields to generate QR-coded inventory labels.
+
+## Credits
+
+- `ql570.c` driver by Asbjørn Sloth Tønnesen, Marc Juul and Luca Zimmermann
+- Built with Python, Click, Pillow, and OpenCV

qltool-0.2.6/README.md

@@ -0,0 +1,138 @@
+# qltool 0.2.4
+
+*Tool to print labels with Brother QL-700/QL-570 label printer*
+
+A wrapper around the excellent `ql570.c` by Asbjørn Sloth Tønnesen, Marc Juul and Luca Zimmermann.
+
+## Features
+
+- Print text labels (1-3 lines)
+- Print QR codes with text
+- Print banners (text along paper length)
+- Custom font sizes
+- MQTT client for remote printing
+- Preview before printing
+
+## Installation
+
+Using `uv` (recommended):
+
+```bash
+uv pip install -e .
+```
+
+Or with pip:
+
+```bash
+pip3 install qltool
+```
+
+## Usage
+
+### Standard Label Print
+
+Print 1-3 lines of text:
+
+```bash
+# Preview only
+uv run src/qltool/main.py "Line 1" "Line 2" "Line 3" --font-size 40
+
+# Print with specific font size
+uv run src/qltool/main.py "Hello World" "Second line" -p --font-size 55
+```
+
+### QR Code Labels
+
+```bash
+# Generate and print QR code with text
+uv run src/qltool/main.py "Item: 12345" "Location: Office" -q -p
+
+# Use existing QR image
+uv run src/qltool/main.py "Scan me" --qr /path/to/qrcode.png -p
+```
+
+### Banner Mode (Text along paper length)
+
+```bash
+# Preview banner
+uv run src/qltool/main.py "Long text banner" --banner --font-size 40
+
+# Print banner
+uv run src/qltool/main.py "STS Chvojkovice-Brod" --banner --font-size 40 -p
+```
+
+### Command Options
+
+- `-p, --print` - Send to printer (without this, shows preview)
+- `-q, --qr` - Generate QR code
+- `--qr PATH` - Use existing QR image
+- `--banner` - Create banner (text along paper length)
+- `--font-size N` - Set font size (default: 72)
+- `--width N` - Set image width in pixels (default: 714 for 62mm tape)
+- `--gray N` - Gray bias 0-100 (default: 50)
+- `-d, --device` - Specify printer device (default: auto-detect /dev/usb/lp*)
+
+## MQTT Client
+
+Run the MQTT client for remote printing:
+
+```bash
+qltool_client
+```
+
+Send print jobs via MQTT:
+
+```bash
+# Simple print
+mosquitto_pub -t qltool/print -m "Hello World -p"
+
+# With QR code
+mosquitto_pub -t qltool/print -m "Inventory Item -q -p"
+
+# Banner
+mosquitto_pub -t qltool/print -m "Long banner text --banner -p"
+```
+
+## Development
+
+Run directly from source:
+
+```bash
+# Preview
+uv run src/qltool/main.py "Test text" --font-size 40
+
+# Print
+uv run src/qltool/main.py "Test text" --font-size 40 -p
+```
+
+## Requirements
+
+- Brother QL-700 or QL-570 printer
+- User must be in `lp` group for printer access
+- Linux with USB lp device support (`/dev/usb/lp*`)
+
+## Org-mode Integration (Inventory)
+
+For Emacs org-mode table integration:
+
+```elisp
+;; Add to .emacs
+(defun print-inventory-item ()
+  "Print current org table row as label"
+  (interactive)
+  ;; Your implementation here
+  )
+```
+
+Example table format:
+
+| ID          | Name                        | Owner | Location |
+|-------------|-----------------------------|-------|----------|
+| D4-12345678 | Sample inventory item       | Pepa  | Home     |
+
+The tool can extract ID and name fields to generate QR-coded inventory labels.
+
+## Credits
+
+- `ql570.c` driver by Asbjørn Sloth Tønnesen, Marc Juul and Luca Zimmermann
+- Built with Python, Click, Pillow, and OpenCV

{qltool-0.2.4 → qltool-0.2.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qltool"
-version = "0.2.4"
+version = "0.2.6"
 description = "PRINT simple labels on ql700"
 readme = "README.md"
 requires-python = ">=3.10"

{qltool-0.2.4 → qltool-0.2.6}/src/qltool/main.py

@@ -63,10 +63,19 @@ def is_user_in_lp_group():
 #
 # ----------------------------------------------------------------------
 def get_data_path():
-    #src = files("data").joinpath("ql570")
-    src = files("qltool").joinpath("data", "ql570")
-    with as_file(src) as p:
-        return str(p)
+    """Get path to ql570 binary, works both when installed and run directly."""
+    try:
+        # Try installed package first
+        src = files("qltool").joinpath("data", "ql570")
+        with as_file(src) as p:
+            return str(p)
+    except Exception:
+        # Fall back to relative path when running directly
+        # __file__ is src/qltool/main.py, data is in src/qltool/data/
+        fallback = os.path.join(os.path.dirname(__file__), "data", "ql570")
+        if os.path.exists(fallback):
+            return fallback
+        raise
 
 # =====================================================================
 #
@@ -205,6 +214,57 @@ def rotate_mono_90(img, clockwise=True):
     return img.transpose(Image.ROTATE_270 if clockwise else Image.ROTATE_90)
 
 
+# =====================================================================
+#
+# ----------------------------------------------------------------------
+def make_banner_image(text, paper_width=714, font_size=None, pad=13):
+    """
+    Create a banner image with text running along the paper length.
+    
+    Creates a horizontal text image with dimensions (text_length x 714).
+    This is NOT rotated - sent to printer as-is so text prints along paper length.
+    
+    - text: single string (arbitrary length)
+    - paper_width: width of the paper (714px for 62mm) - used as height here
+    - font_size: font size (uses CLI font_size or default)
+    - pad: padding around text
+    
+    Returns a PIL.Image in RGB mode with dimensions (text_length x 714).
+    """
+    FSIZ = font_size or 36
+    try:
+        font = ImageFont.truetype(FONT_PATH, FSIZ) if FONT_PATH else ImageFont.load_default()
+    except Exception:
+        font = ImageFont.load_default()
+    
+    PAD = int((FSIZ / 36) * pad)
+    
+    # Measure the text
+    tmp = Image.new("L", (10000, 1000), 255)
+    draw_tmp = ImageDraw.Draw(tmp)
+    bbox = draw_tmp.textbbox((0, 0), text, font=font)
+    text_width = bbox[2] - bbox[0]
+    text_height = bbox[3] - bbox[1]
+    print(f"D... Banner text measurements: text_width={text_width}, text_height={text_height}, PAD={PAD}")
+    
+    # Create horizontal text image: width = text length + padding, height = paper width
+    # Banners are NOT rotated - they are sent to printer as-is with height=714
+    img_width = int(text_width + PAD * 2)
+    img_height = int(paper_width)
+    print(f"D... Banner image dimensions: {img_width}x{img_height} (NOT rotated, height stays 714)")
+    
+    im = Image.new("RGB", (img_width, img_height), "white")
+    draw = ImageDraw.Draw(im)
+    
+    # Center the text vertically
+    x = PAD
+    y = (img_height - text_height) // 2
+    
+    draw.text((x, y), text, font=font, fill=0)
+    
+    return im
+
+
 
 
 # =====================================================================
@@ -355,17 +415,19 @@ def make_bw_text_with_qr(lines,
 @click.option("--qr", "qr_path", default=None, show_default=True, help="QR image path.")
 @click.option("-q", "qr_create", is_flag=True, default=False, show_default=True, help="do QR")
 @click.option("--address", "address", default=None, show_default=True, help="Address/URL to encode in QR code.")
-def cli(lines, do_print, device, fmt, width, gray, font_size, qr_path, qr_create, address):
+@click.option("--banner", "banner", is_flag=True, default=False, show_default=True, help="Create a banner with text along the paper length.")
+def cli(lines, do_print, device, fmt, width, gray, font_size, qr_path, qr_create, address, banner):
     """
     Create a black-on-white PNG from 1-3 lines of text.
     By default displays the image with OpenCV. Use -p to print via ql570.
+    Use --banner to create a long text banner along the paper length.
     """
     #print(lines, type(lines), len(lines))
     if type(lines)is not tuple:
         print("X... the text should be python-tuple for some reason....")
         sys.exit(1)
 
-    if len(lines) > 3: #   "A" "B" "C"
+    if not banner and len(lines) > 3: #   "A" "B" "C"
         print("Error: max 3 lines allowed.", file=sys.stderr)
         sys.exit(2)
 
@@ -377,7 +439,7 @@ def cli(lines, do_print, device, fmt, width, gray, font_size, qr_path, qr_create
         else:
             print("Q... lines ...I do not understand")
 
-    if len(lines) > 3: #   "A" "B" "C"
+    if not banner and len(lines) > 3: #   "A" "B" "C"
         print("Error: max 3 lines allowed.", file=sys.stderr)
         sys.exit(2)
 
@@ -400,13 +462,26 @@ def cli(lines, do_print, device, fmt, width, gray, font_size, qr_path, qr_create
     lines = ["\n".join(lines) ] # BACK TO NICE \n
 
     im = None
-    if use_qr_version:
+    if banner:
+        # Banner mode: single line of text along paper length
+        banner_text = lines[0].replace("\n", " ")  # Flatten any newlines
+        im = make_banner_image(banner_text, paper_width=714, font_size=font_size)
+        print(f"D... Banner image size: {im.size}")
+    elif use_qr_version:
         im = make_bw_text_with_qr(list(lines), my_qr_path, width=714, font_size=font_size)
     else:
         im = make_bw_text_image(list(lines), width=714, font_size=font_size)
 
     mono = convert_to_mono_floyd(im, gray_percent=int(gray))
-    mono = rotate_mono_90(mono, clockwise=True)
+    print(f"D... After convert_to_mono_floyd: {mono.size}")
+    # Rotate only normal labels, NOT banners
+    # Banners are already created with correct orientation: width=variable, height=714
+    if not banner:
+        mono = rotate_mono_90(mono, clockwise=True)
+        print(f"D... After rotation for normal label: {mono.size}")
+    else:
+        print(f"D... Banner - keeping original orientation")
+    print(f"D... Final mono image size: {mono.size}, mode: {mono.mode}")
 
     out = get_tmp_fname()
     print(f"D.... {out}")
@@ -428,6 +503,8 @@ def cli(lines, do_print, device, fmt, width, gray, font_size, qr_path, qr_create
     exe = get_data_path()
     dev = device if device else check_lpx()
     CMD = f"{exe} {dev} {fmt} {out}"
+    print(f"D... Printer command: {CMD}")
+    print(f"D... Image file: {out}, size: {mono.size}")
 
     if not  is_user_in_lp_group():
         print("X... ", fg.red, "you are not in lp group", fg.default)

qltool-0.2.4/PKG-INFO

@@ -1,79 +0,0 @@
-Metadata-Version: 2.4
-Name: qltool
-Version: 0.2.4
-Summary: PRINT simple labels on ql700
-Requires-Python: >=3.10
-Requires-Dist: click>=8.2.1
-Requires-Dist: console>=0.9911
-Requires-Dist: importlib-resources>=6.5.2
-Requires-Dist: opencv-python>=4.12.0.88
-Requires-Dist: paho-mqtt>=2.1.0
-Requires-Dist: pillow>=11.3.0
-Requires-Dist: qrcode>=8.2
-Description-Content-Type: text/markdown
-
-# qltool 0.1.14
-
-*tool to print some useful stuff with ql700 brother printer*
-
--   It is just a wrapper around the great `ql570.c` of Asbjørn Sloth
-    Tønnesen, Marc Juul and Luca Zimmermann
-
-## Installation
-
-``` {.bash org-language="sh"}
-pip3 install qltool
-```
-
-## Usage - standard print
-
-``` {.bash org-language="sh"}
-#---------text
- rm /tmp/tmp_qrcode.png ; uv run src/qltool/main.py "Ahoj
-aaa
-456 8jgqy 789 456 456 " --font-size 55 --font-size 45
-
-# ---- create QR
-
-uv run src/qltool/main.py "ahoj
-momo
-123 456 789 jjj" -p -q
-
-# -------- use any image/qrcode
-uv run src/qltool/main.py "Užaj jetů" --qr /tmp/baba.png
-
-uv run src/qltool/main.py "Už je tuná" --qr /tmp/baba.png -p
-```
-
-## Using mqtt client
-
-`qltool_client`
-
-``` {.bash org-language="sh"}
-# DO
-qltool_client # somewhere...
-### examples:
-export D=`date +"%H:%M:%S"`; mosquitto_pub -t qltool/print -m "hoho $D -q -p"
-
-# blocking...
-mosquitto_pub -t qltool/print -m "hoho secondline thirdline  -q "
-
-#  NEVER USE THIS:
-watch -n 10 'export D=`date +"%H:%M:%S"`; mosquitto_pub -t qltool/print -m "\"hoho asdas\" \"jeli $D\"  -q "'
-```
-
-## Org-mode inventory - broken now
-
-If this function is somewhere in the `.emacs` configfiles ...
-
-It selects two fields fromthe TABLE and puts -q option.
-
-You point to a line of a table and `c-c q`{.verbatim} or
-`c-c w`{.verbatim} will view/print the code for inventory.
-
-  whatever   id            name                        owner   location
-  ---------- ------------- --------------------------- ------- ----------
-  123        D4-12345678   najaka blbost z inventury   Pepa    Home
-
-and this is run
-`./bin_qltool.py "id: D4-12345678; name: najaka blbost z inventury  owner:Pepa " -q`

qltool-0.2.4/README.md

@@ -1,65 +0,0 @@
-# qltool 0.1.14
-
-*tool to print some useful stuff with ql700 brother printer*
-
--   It is just a wrapper around the great `ql570.c` of Asbjørn Sloth
-    Tønnesen, Marc Juul and Luca Zimmermann
-
-## Installation
-
-``` {.bash org-language="sh"}
-pip3 install qltool
-```
-
-## Usage - standard print
-
-``` {.bash org-language="sh"}
-#---------text
- rm /tmp/tmp_qrcode.png ; uv run src/qltool/main.py "Ahoj
-aaa
-456 8jgqy 789 456 456 " --font-size 55 --font-size 45
-
-# ---- create QR
-
-uv run src/qltool/main.py "ahoj
-momo
-123 456 789 jjj" -p -q
-
-# -------- use any image/qrcode
-uv run src/qltool/main.py "Užaj jetů" --qr /tmp/baba.png
-
-uv run src/qltool/main.py "Už je tuná" --qr /tmp/baba.png -p
-```
-
-## Using mqtt client
-
-`qltool_client`
-
-``` {.bash org-language="sh"}
-# DO
-qltool_client # somewhere...
-### examples:
-export D=`date +"%H:%M:%S"`; mosquitto_pub -t qltool/print -m "hoho $D -q -p"
-
-# blocking...
-mosquitto_pub -t qltool/print -m "hoho secondline thirdline  -q "
-
-#  NEVER USE THIS:
-watch -n 10 'export D=`date +"%H:%M:%S"`; mosquitto_pub -t qltool/print -m "\"hoho asdas\" \"jeli $D\"  -q "'
-```
-
-## Org-mode inventory - broken now
-
-If this function is somewhere in the `.emacs` configfiles ...
-
-It selects two fields fromthe TABLE and puts -q option.
-
-You point to a line of a table and `c-c q`{.verbatim} or
-`c-c w`{.verbatim} will view/print the code for inventory.
-
-  whatever   id            name                        owner   location
-  ---------- ------------- --------------------------- ------- ----------
-  123        D4-12345678   najaka blbost z inventury   Pepa    Home
-
-and this is run
-`./bin_qltool.py "id: D4-12345678; name: najaka blbost z inventury  owner:Pepa " -q`