Update README.md with documentation about the -d/--digits option

to allow configuring the number of digits in the ASN string. This
argument is optional and defaults to 7 to keep backwards compatibility.

README.md

@@ -1,7 +1,7 @@
 # paperless-asn-qr-codes
 
 `paperless-asn-qr-codes` is a command line utility for generating ASN labels
-for paperless with both a human readable representation, as well as a QR code
+for paperless with both a human-readable representation, as well as a QR code
 for machine consumption. The labels are Avery 4731 labels.
 
 ## Installation
@@ -10,10 +10,44 @@ for machine consumption. The labels are Avery 4731 labels.
 pip install paperless-asn-qr-codes
 ```
 
-## Supported Sheets
-Some different sheet types are supported with the `--format` argument, however, not all are tested.
+## Usage
 
-Default is Avery L4731.
+```
+usage: paperless-asn-qr-codes [-h] [--format {averyL4731,avery5160,avery5161,avery5163,avery5167,avery5371}] [--border] start_asn output_file
+
+CLI Tool for generating paperless ASN labels with QR codes
+
+positional arguments:
+  start_asn             The value of the first ASN
+  output_file           The output file to write to (default: labels.pdf)
+
+options:
+  -h, --help            show this help message and exit
+  --format {averyL4731,avery5160,avery5161,avery5163,avery5167,avery5371}, -f {averyL4731,avery5160,avery5161,avery5163,avery5167,avery5371}
+  --digits DIGITS, -d DIGITS
+                        Number of digits in the ASN (default: 7, produces 'ASN0000001')
+  --border, -b          Display borders around labels, useful for debugging the printer alignment
+```
+
+### Mandatory arguments
+
+- `<start_asn>`: The value of the first ASN to generate
+
+### Optional arguments
+
+- `<output_file>`: The name of the output file to write to (default: labels.pdf)
+
+---
+
+- `-h`, `--help`: Shows the help message
+- `-f`, `--format`: Selects the format of the output sheet (see [Supported Sheets](#supported-sheets))
+- `-d`, `--digits`: Specifies the number of digits in the ASN (e.g. for the default number 7, the ASN will look like 'ASN0000001')
+- `-b`, `--border`: Generates the borders around the labels to help debug alignment issues (see [Tips & Tricks](#tips--tricks))
+
+## Supported Sheets
+Some different sheet types are supported with the `-f`/`--format` argument, however, not all are tested.
+
+The default is Avery L4731.
 
 Currently tested and known working are:
 - Avery L4731 (DIN A4 Labels)
@@ -21,7 +55,7 @@ Currently tested and known working are:
 ## Tips & Tricks
 
 In case your printer has alignment issues, you can generate a PDF with borders around the labels by using the
-`--border` option.
+`-b`/`--border` option.
 
 ## License
 

paperless_asn_qr_codes/avery_labels.py

@@ -2,7 +2,8 @@ from dataclasses import dataclass, KW_ONLY
 from collections.abc import Iterator
 from reportlab.pdfgen import canvas
 from reportlab.lib.pagesizes import LETTER, A4
-from reportlab.lib.units import mm
+from reportlab.lib.units import mm, inch
+
 
 # Usage:
 #   label = AveryLabels.AveryLabel(5160)
@@ -67,9 +68,9 @@ labelInfo: dict[str, LabelInfo] = {
     "avery5167": LabelInfo(
         labels_horizontal=4,
         labels_vertical=20,
-        label_size=(126, 36),
-        gutter_size=(0, 0),
-        margin=(54, 36),
+        label_size=(1.75 * inch, 0.5 * inch),
+        gutter_size=(0.3 * inch, 0),
+        margin=(0.3 * inch, 0.5 * inch),
         pagesize=LETTER,
     ),
     # 3.5 x 2 business cards

paperless_asn_qr_codes/main.py

@@ -2,12 +2,14 @@ import argparse
 
 from reportlab.lib.units import mm
 from reportlab_qrcode import QRCodeImage
+
 from paperless_asn_qr_codes import avery_labels
 
 
 def render(c, x, y):
     global startASN
-    barcode_value = f"ASN{startASN:07d}"
+    global digits
+    barcode_value = f"ASN{startASN:0{digits}d}"
     startASN = startASN + 1
 
     qr = QRCodeImage(barcode_value, size=y * 0.9)
@@ -21,19 +23,25 @@ def main():
         prog="paperless-asn-qr-codes",
         description="CLI Tool for generating paperless ASN labels with QR codes",
     )
-    parser.add_argument("start_asn")
-    parser.add_argument("output_file")
+    parser.add_argument("start_asn", type=int, help="The value of the first ASN")
+    parser.add_argument("output_file", type=str, default="labels.pdf", help="The output file to write to (default: labels.pdf)")
     parser.add_argument(
-        "--format", choices=avery_labels.labelInfo.keys(), default="averyL4731"
+        "--format", "-f", choices=avery_labels.labelInfo.keys(), default="averyL4731"
+    )
+    parser.add_argument(
+        "--digits", "-d", default=7, help="Number of digits in the ASN (default: 7, produces 'ASN0000001')", type=int
     )
     parser.add_argument(
         "--border",
+        "-b",
         action="store_true",
         help="Display borders around labels, useful for debugging the printer alignment",
     )
     args = parser.parse_args()
     global startASN
+    global digits
     startASN = int(args.start_asn)
+    digits = int(args.digits)
     label = avery_labels.AveryLabel(args.format, args.border)
     label.open(args.output_file)
     # by default, we render all labels possible on a single sheet