3 examples by agordon · Pull Request #652 · python-escpos/python-escpos · GitHub

Description

Three usage examples with pictures of printed results - hopefully will help users get started quicker with python-escpos

Tested with

TM-P80 clone, called "MUNBYN 80mm USB Receipt Printer" , kernel device info:

usb 3-4.2: New USB device found, idVendor=04b8, idProduct=0e20, bcdDevice= 1.00
usb 3-4.2: New USB device strings: Mfr=1, Product=2, SerialNumber=3
usb 3-4.2: Product: TM-m30-ii
usb 3-4.2: Manufacturer: EPSON

Hi @agordon and welcome to python-escpos!!.

This examples are great, however I left some suggestions and fixes to the code.
I still have to take a second look to the receipt.py but please be patient as I could be a bit slow with the review process.
By the moment we can start discussing and checking this little changes.
Thanks in advance!

You could move this resource file to the graphics folder i.e examples/graphics/receipt/creature5.gif to keep the resource images into a separated folder as in other example files

Same as in my previous comment: Move the resource file into the graphics/receipt sub-folder

I really like this function.
I think we must add it to python-escpos as a private method so that other methods like block_text, software_columns and the like can make optional use of it.

What do you think @patkan @agordon ?

Sounds good, feel free to create a change request :-)

Second look.
I think I'm done.

We recently implemented the new software_columns method which simplifies formatting and printing lines of text as columns from a list of text items, so now users have an easy way to print something like "tables".
It would be great if this example file could include that functionality.

Not used.
Forgot to add the barcode to the receipt?
It would be great to see a barcode or a QR printed on the receipt to showcase the capabilities of python-escpos.

Suggested change

      
            txt = re.sub("  +", " ", txt)
          
            # textwrap.wrap() ensures words are not broken (unlike "escpos.block_text()").
          
            txt = textwrap.wrap(txt, width=disclaimer_width)
          
            # Justify each line
          
            txt = [justify(x, disclaimer_width) for x in txt]
          
            p.set_with_default(font="b")
          
            for l in txt:
          
                p.textln(l)
          
            p.software_columns(text_list=[txt], widths=disclaimer_width, align='justify')

Again, the software_columns method is your friend here.
This will print the text in disclaimer as a single column of left aligned text wrapped to fit within 64 characters max width per line.
The only lack would be the justification of the text that I would like to see be part of the python-escpos tools in the near future.
EDIT 2026: Justification is already a feature

Change import sorting Co-authored-by: Benito López <belono@users.noreply.github.com>

Co-authored-by: Benito López <belono@users.noreply.github.com>

Hi @agordon !!

Are you still interested in finishing this PR?
I'd like to see it merged.

If you are not, maybe we could merge it as is and make modifications after merge.

agordon added 3 commits August 5, 2024 02:02

Examples: add font-variations demo

f63b0a7

Examples: add block_text usage demo

f51af27

Examples: add fake receipt demo

5f91b48

agordon force-pushed the master branch from 0a15b47 to 5f91b48 Compare August 5, 2024 08:02

belono suggested changes Aug 6, 2024

View reviewed changes

belono suggested changes Aug 7, 2024

View reviewed changes

patkan and others added 5 commits August 24, 2024 23:25

Update examples/receipt.py

a831fd3

Change import sorting Co-authored-by: Benito López <belono@users.noreply.github.com>

Update examples/block_text.py

5894f0a

Co-authored-by: Benito López <belono@users.noreply.github.com>

Update examples/font_variations.py

e19483a

Co-authored-by: Benito López <belono@users.noreply.github.com>

Merge branch 'master' into master

6cd3574

Merge branch 'master' into master

06b4481

belono mentioned this pull request Aug 4, 2025

Add a justify method for text justification #689

Closed

+              # Justify-text on left AND right sides by padding spaces,
+              # code by: Georgina Skibinski https://stackoverflow.com/a/66087666
+              def justify(txt: str, width: int) -> str:
+                  prev_txt = txt
+                  while (l := width - len(txt)) > 0:
+                      txt = re.sub(r"(\s+)", r"\1 ", txt, count=l)
+                      if txt == prev_txt:
+                          break
+                  return txt.rjust(width)

+              ## Itemized list header (bold with underline)
+              p.set_with_default(bold=True, underline=True)
+              p.textln(header_format.format(**header))
+              ## Itemized List
+              p.set_with_default()
+              for idx, item in enumerate(items):
+                  txt = item_format.format(**item)
+                  if idx == len(items) - 1:
+                      # If this is the last item, add underline
+                      # to visually "close" the list.
+                      p.set_with_default(underline=True)
+                  p.textln(txt)

3 examples by agordon · Pull Request #652 · python-escpos/python-escpos · GitHub

Uh oh!

3 examples - #652

3 examples#652
agordon wants to merge 8 commits into
python-escpos:masterfrom
agordon:master

agordon commented Aug 5, 2024

Uh oh!

belono left a comment •
edited
Loading

Uh oh!

Uh oh!

Uh oh!

belono Aug 6, 2024

Uh oh!

belono Aug 6, 2024

Uh oh!

Uh oh!

Uh oh!

belono Aug 6, 2024 •
edited
Loading

Uh oh!

Uh oh!

patkan Aug 24, 2024

Uh oh!

belono left a comment

Uh oh!

belono Aug 7, 2024

Uh oh!

belono Aug 7, 2024

Uh oh!

belono Aug 7, 2024 •
edited
Loading

Uh oh!

Uh oh!

belono commented Aug 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

+              # Font "b" on my TM-P80-clone printer can squeeze 64 characters per line
+              disclaimer_width = 64
+              recipt_barcode = "1234567890"

3 examples by agordon · Pull Request #652 · python-escpos/python-escpos · GitHub

Uh oh!

3 examples - #652

3 examples#652agordon wants to merge 8 commits intopython-escpos:masterpython-escpos/python-escpos:masterfrom agordon:masteragordon/python-escpos:masterCopy head branch name to clipboard

Conversation

agordon commented Aug 5, 2024

Description

Tested with

Uh oh!

belono left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

belono Aug 6, 2024

Choose a reason for hiding this comment

Uh oh!

belono Aug 6, 2024

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

belono Aug 6, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

patkan Aug 24, 2024

Choose a reason for hiding this comment

Uh oh!

belono left a comment

Choose a reason for hiding this comment

Uh oh!

belono Aug 7, 2024

Choose a reason for hiding this comment

Uh oh!

belono Aug 7, 2024

Choose a reason for hiding this comment

Uh oh!

belono Aug 7, 2024 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

belono commented Aug 20, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

3 examples#652
agordon wants to merge 8 commits into
python-escpos:masterfrom
agordon:master

belono left a comment •
edited
Loading

belono Aug 6, 2024 •
edited
Loading

belono Aug 7, 2024 •
edited
Loading