### Install pyxmlescpos Python Library

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Installs the pyxmlescpos library using pip. This is a prerequisite for using the library's functionalities.

```bash
sudo pip install pyxmlescpos
```

--------------------------------

### Basic XML Receipt Structure Example

Source: https://github.com/fvdsn/py-xml-escpos/blob/master/README.md

Demonstrates the fundamental structure of an XML document used for generating receipts with the XML-ESC/POS library. It includes common elements like headers, lines, and special tags for barcodes and cash drawers.

```xml
<receipt>
    <h1>Receipt!</h1>
    <h2>div,span,p,ul,ol are also supported</h2>:w
    <line>
        <left>Product</left>
        <right>0.15€</right>
    </line>
    <hr />
    <line size='double-height'>
        <left>TOTAL</left>
        <right>0.15€</right>
    </line>
    <barcode encoding='ean13'>
        5449000000996
    </barcode>
    <cashdraw /> 
    <cut />
</receipt>
```

--------------------------------

### Generate a Complete Receipt with Various Elements

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

This snippet demonstrates the creation of a comprehensive receipt using XML. It includes headers, styled text lines for items and totals, a footer message, a barcode, cash drawer control, and a paper cut command. The USB connection is used for this example.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

receipt_xml = """
<receipt>
    <h1>Store Name</h1>
    <h2>Receipt #12345</h2>
    <p align='center'>123 Main Street, City, State</p>
    <hr />

    <line>
        <left>Product A</left>
        <right>$9.99</right>
    </line>
    <line>
        <left>Product B</left>
        <right>$14.50</right>
    </line>
    <line>
        <left>Product C (x2)</left>
        <right>$5.00</right>
    </line>

    <hr />

    <line size='double-height' bold='on'>
        <left>TOTAL</left>
        <right>$29.49</right>
    </line>

    <p align='center'>Thank you for your purchase!</p>

    <barcode encoding='ean13'>
        5449000000996
    </barcode>

    <cashdraw />
    <cut />
</receipt>
"""

printer.receipt(receipt_xml)
```

--------------------------------

### Connect and Print via Network Printer

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Illustrates connecting to an ESC/POS printer over a network using TCP/IP. The example specifies the printer's host IP address and port, and prints a receipt containing network-specific information.

```python
from xmlescpos.printer import Network

# Connect to network printer (default port 9100)
printer = Network(host="192.168.1.100", port=9100)

# Print receipt
printer.receipt("""
    <receipt>
        <h1>Network Receipt</h1>
        <p>Printed over TCP/IP</p>
        <cut />
    </receipt>
""")
```

--------------------------------

### Send Raw ESC/POS Commands Directly

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Allows sending low-level ESC/POS commands directly to the printer using the `_raw()` method. This is useful for commands not exposed through higher-level XML tags or text methods. It includes examples for printer initialization, alignment, and cutting.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

# Send raw ESC/POS commands
printer._raw('\x1b\x40')  # Initialize printer
printer._raw('\x1b\x61\x01')  # Center alignment
printer.text("Raw Command Text")
printer._raw('\x0a')  # Line feed
printer._raw('\x1d\x56\x00')  # Full cut

# Use text() method for proper UTF-8 encoding
printer.text("Hello in UTF-8: Héllo, Мир, 日本語")
printer.cut()
```

--------------------------------

### XML Value Tag for Formatted Numerical Output

Source: https://github.com/fvdsn/py-xml-escpos/blob/master/README.md

Demonstrates the `value` tag for formatting numerical data in receipts. This example shows setting a currency symbol and its position using `value-symbol` and `value-symbol-position` attributes.

```xml
<value value-symbol='€' value-symbol-position='after'>
    3.1415
</value>
```

--------------------------------

### Create Lists with Bullets and Numbering

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

This example shows how to generate unordered lists with custom bullet characters and ordered lists with automatic numbering using the XML-ESC/POS library. It also demonstrates setting tab widths for better alignment within lists. The code uses a USB printer connection.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

list_receipt = """
<receipt>
    <h2>Shopping List</h2>

    <ul bullet='*' tabwidth='3'>
        <li>Apples</li>
        <li>Bananas</li>
        <li>Oranges</li>
    </ul>

    <h2>Instructions</h2>

    <ol tabwidth='4'>
        <li>Connect the printer</li>
        <li>Load the receipt paper</li>
        <li>Send print command</li>
        <li>Tear off the receipt</li>
    </ol>

    <cut />
</receipt>
"""

printer.receipt(list_receipt)
```

--------------------------------

### XML Barcode Tag with EAN13 Encoding

Source: https://github.com/fvdsn/py-xml-escpos/blob/master/README.md

Shows how to include a barcode in the receipt using the `barcode` tag. The `encoding` attribute is mandatory, and this example specifies 'EAN13' for the barcode type.

```xml
<barcode encoding="EAN13">
    5400113509509
</barcode>
```

--------------------------------

### XML Structure for ESC/POS Receipts

Source: https://github.com/fvdsn/py-xml-escpos/blob/master/DESCRIPTION.rst

This example demonstrates the XML format used by the XML-ESC/POS library to construct receipt content. It showcases elements for text formatting, product lines, totals, barcodes, and printer commands like cash drawer and cutting. This XML is parsed and converted into ESC/POS commands by the library.

```xml
<receipt>
    <h1>Receipt!</h1>
    <h2>div,span,p,ul,ol are also supported</h2>
    <line>
        <left>Product</left>
        <right>0.15€</right>
    </line>
    <hr />
    <line size='double-height'>
        <left>TOTAL</left>
        <right>0.15€</right>
    </line>
    <barcode encoding='ean13'>
        5449000000996
    </barcode>
    <cashdraw /> 
    <cut />
</receipt>
```

--------------------------------

### Connect and Print via USB Printer

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Demonstrates connecting to an ESC/POS printer over USB using vendor and product IDs and printing a simple 'Hello World' receipt. The connection is explicitly closed after printing.

```python
from xmlescpos.printer import Usb

# Connect to Epson TM-T20 printer (vendor: 0x04b8, product: 0x0e03)
printer = Usb(0x04b8, 0x0e03)

# Print simple text
printer.receipt("<div>Hello World!</div>")

# Close connection
printer.close()
```

--------------------------------

### Print a Receipt using XML-ESC/POS in Python

Source: https://github.com/fvdsn/py-xml-escpos/blob/master/DESCRIPTION.rst

This Python code snippet illustrates how to use the XML-ESC/POS library to send a simple receipt to a USB-connected ESC/POS printer. It requires the `xmlescpos` library and specifies the USB vendor and product IDs for the printer. The `receipt` method takes an XML string as input.

```python
from xmlescpos.printer import Usb
printer = Usb(0x04b8,0x0e03)
printer.receipt("<div>Hello World!</div>")
```

--------------------------------

### List and Connect to Supported ESC/POS Devices

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Provides a method to access a predefined list of common ESC/POS printer vendor and product IDs. This list can be used to dynamically identify and connect to printers by their known identifiers.

```python
from xmlescpos.printer import Usb
from xmlescpos.supported_devices import device_list

# Display supported devices
for device in device_list:
    print(f"{device['name']}: Vendor={hex(device['vendor'])}, Product={hex(device['product'])}")

# Output:
# Epson TM-T20: Vendor=0x4b8, Product=0xe03
# Epson TM-T70: Vendor=0x4b8, Product=0x202
# Epson TM-T20II: Vendor=0x4b8, Product=0xe15

# Connect using device from list
epson_tm_t20 = device_list[0]
printer = Usb(epson_tm_t20['vendor'], epson_tm_t20['product'])
```

--------------------------------

### Apply Text Styling and Formatting in Receipts

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

This Python code demonstrates various text styling options available in XML-ESC/POS, including alignment (left, center, right), font styles (bold, underline, font B), size variations (double, double-width, double-height), and color. It uses a USB printer connection.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

styled_receipt = """
<receipt>
    <h1 align='center'>Heading 1 - Bold Double Size</h1>
    <h2 align='center'>Heading 2 - Double Size</h2>
    <h3>Heading 3 - Bold Double Height</h3>
    <h5>Heading 5 - Bold Normal</h5>

    <p align='left'>Left aligned text</p>
    <p align='center'>Center aligned text</p>
    <p align='right'>Right aligned text</p>

    <p bold='on'>Bold text</p>
    <p underline='on'>Underlined text</p>
    <p underline='double'>Double underlined text</p>
    <p font='b'>Font B (smaller)</p>

    <p size='double'>Double size</p>
    <p size='double-width'>Double width only</p>
    <p size='double-height'>Double height only</p>

    <p color='red'>Red text (if supported)</p>

    <cut />
</receipt>
"""

printer.receipt(styled_receipt)
```

--------------------------------

### Control Cash Drawer Operation (Python)

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Triggers the cash drawer to open after a receipt is printed using either the `<cashdraw />` tag within the XML, a direct `printer.cashdraw()` function call with a pin number, or by setting the `open-cashdrawer='true'` attribute on the `<receipt>` tag.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

# Method 1: Using XML tag
receipt_with_drawer = """
<receipt>
    <h2>Sale Complete</h2>
    <p>Cash: $20.00</p>
    <p>Change: $5.00</p>

    <cashdraw />
    <cut />
</receipt>
"""

printer.receipt(receipt_with_drawer)

# Method 2: Direct function call
printer.cashdraw(2)  # Send pulse to pin 2
printer.cashdraw(5)  # Send pulse to pin 5

# Method 3: Receipt attribute
auto_drawer_receipt = """
<receipt open-cashdrawer='true'>
    <h2>Payment Received</h2>
    <cut />
</receipt>
"""

printer.receipt(auto_drawer_receipt)
```

--------------------------------

### XML Line Tag with Left and Right Alignment

Source: https://github.com/fvdsn/py-xml-escpos/blob/master/README.md

Illustrates the `line` tag for creating lines with content aligned to the left and right. The `line-ratio` attribute controls the width distribution between the left and right parts.

```xml
<line line-ratio='0.6'>
    <left>Product Name</left>
    <right>$0.15</right>
</line>
```

--------------------------------

### Handle Common ESC/POS Printer Errors

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Demonstrates how to catch and handle various exceptions that can occur during ESC/POS printer operations, such as device connection issues, printing failures, and invalid data formats. It provides specific error messages for common problems.

```python
from xmlescpos.printer import Usb
from xmlescpos.exceptions import (
    NoDeviceError,
    HandleDeviceError,
    TicketNotPrinted,
    BarcodeTypeError,
    ImageSizeError
)

try:
    printer = Usb(0x04b8, 0x0e03)

    receipt = """
    <receipt>
        <h1>Test Receipt</h1>
        <barcode encoding='ean13'>5449000000996</barcode>
        <cut />
    </receipt>
    """

    printer.receipt(receipt)
    printer.close()

except NoDeviceError:
    print("ERROR: Printer not found. Check USB connection and IDs.")

except HandleDeviceError as e:
    print(f"ERROR: Cannot handle device: {e}")

except TicketNotPrinted:
    print("ERROR: Receipt was not fully printed")

except BarcodeTypeError:
    print("ERROR: Invalid barcode encoding specified")

except ImageSizeError:
    print("ERROR: Image dimensions exceed printer limits")

except Exception as e:
    print(f"Unexpected error: {e}")
```

--------------------------------

### Connect and Print via Serial Printer

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Shows how to connect to an ESC/POS printer via a serial port (RS-232) with custom baud rate and other serial communication settings. The receipt includes basic XML formatting, and the connection is managed automatically.

```python
from xmlescpos.printer import Serial

# Connect to serial printer
printer = Serial(
    devfile="/dev/ttyS0",
    baudrate=9600,
    bytesize=8,
    timeout=1
)

# Print receipt
printer.receipt("<receipt><h1>Serial Receipt</h1><p>Printed via RS-232</p><cut /></receipt>")

# Connection closes automatically on object deletion
```

--------------------------------

### Format Numerical Values with Decimals and Symbols (Python)

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Formats numerical values within a receipt, allowing customization of decimal places, thousands separators, and currency symbols. The `<value>` tag with attributes like `value-decimals`, `value-symbol`, and `value-thousands-separator` enables flexible financial display.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

value_receipt = """
<receipt
    value-decimals='2'
    value-symbol='$'
    value-symbol-position='before'
    value-thousands-separator=','
    value-decimals-separator='.'>

    <h2>Price List</h2>

    <line>
        <left>Item A</left>
        <right><value>1234.56</value></right>
    </line>

    <line>
        <left>Item B (Euro)</left>
        <right><value value-symbol='€' value-symbol-position='after'>999.99</value></right>
    </line>

    <line>
        <left>Item C (Auto-int)</left>
        <right><value value-autoint='on'>100.00</value></right>
    </line>

    <line>
        <left>Item D (3 decimals)</left>
        <right><value value-decimals='3'>3.14159</value></right>
    </line>

    <cut />
</receipt>
"""

printer.receipt(value_receipt)
```

--------------------------------

### Format Receipt Lines with Left-Right Alignment (Python)

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Formats receipt lines with left-aligned and right-aligned content on a single line using the `<line>` tag with specified ratios. This is useful for aligning item names with their prices or quantities.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

line_receipt = """
<receipt width='48'>
    <h2>Invoice</h2>

    <line line-ratio='0.6'>
        <left>Item Description</left>
        <right>Price</right>
    </line>

    <hr />

    <line line-ratio='0.7'>
        <left>Coffee - Large</left>
        <right>$3.50</right>
    </line>

    <line line-ratio='0.7'>
        <left>Sandwich</left>
        <right>$6.99</right>
    </line>

    <line line-ratio='0.7'>
        <left>Tax (8%)</left>
        <right>$0.84</right>
    </line>

    <hr />

    <line size='double-height' line-ratio='0.5'>
        <left><b>TOTAL</b></left>
        <right><b>$11.33</b></right>
    </line>

    <cut />
</receipt>
"""

printer.receipt(line_receipt)
```

--------------------------------

### Perform Partial Paper Cut on Receipts

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Demonstrates how to execute a partial paper cut, leaving a small perforation for easier manual tearing. This can be achieved using the `<partialcut />` XML tag or the `printer.cut(mode='part')` function call.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

# Method 1: XML tag
partial_cut_receipt = """
<receipt>
    <h2>Receipt with Partial Cut</h2>
    <p>Easy to tear manually</p>
    <partialcut />
</receipt>
"""

printer.receipt(partial_cut_receipt)

# Method 2: Direct function call
printer.text("Another receipt\n")
printer.cut(mode='part')
```

--------------------------------

### XML List Tag with Tab Width and Bullet Customization

Source: https://github.com/fvdsn/py-xml-escpos/blob/master/README.md

Illustrates how to use the `ul` tag for creating lists in XML receipts. It shows the customization of `tabwidth` for indentation and `bullet` for the list marker character.

```xml
<ul tabwidth='3' bullet='-'>
    <li>foo</li>
    <li>bar</li>
</ul>
```

--------------------------------

### Print Images from Base64 Data URLs (Python)

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Prints images embedded as base64-encoded data URLs within receipt XML. Requires the image to be read, encoded, and then embedded using the `<img>` tag. Supported formats are PNG, JPEG, and GIF, with constraints on image dimensions.

```python
from xmlescpos.printer import Usb
import base64

printer = Usb(0x04b8, 0x0e03)

# Read image and convert to base64
with open('logo.png', 'rb') as img_file:
    img_data = base64.b64encode(img_file.read()).decode('utf-8')

image_receipt = f"""
<receipt>
    <p align='center'>Company Logo:</p>

    <img src="data:image/png;base64,{img_data}" />

    <h2 align='center'>Store Receipt</h2>
    <p align='center'>Thank you for shopping with us!</p>

    <cut />
</receipt>
"""

printer.receipt(image_receipt)

# Supported formats: PNG, JPEG, GIF
# Image width should be <= 512 pixels
# Image height must be <= 255 pixels
```

--------------------------------

### XML Image Tag with Base64 Encoded Data

Source: https://github.com/fvdsn/py-xml-escpos/blob/master/README.md

Demonstrates the usage of the `img` tag to embed images directly within the XML receipt. The `src` attribute must contain the image data (PNG, GIF, or JPEG) encoded in Base64.

```xml
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQAQMAA..." />
```

--------------------------------

### Add Horizontal Rules and Line Breaks in Receipts

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Shows how to use XML tags `<hr />` for horizontal separators and `<br />` for line breaks within receipt templates. This enhances the visual structure and readability of printed receipts.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

separator_receipt = """
<receipt width='48'>
    <h2 align='center'>Invoice</h2>

    <hr />

    <p>Item 1: $10.00</p>
    <p>Item 2: $15.00</p>

    <hr />

    <p bold='on'>Total: $25.00</p>

    <br />
    <br />

    <p align='center'>Thank you!</p>

    <cut />
</receipt>
"""

printer.receipt(separator_receipt)
```

--------------------------------

### Print Barcodes on Receipts (Python)

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Generates and prints various standard barcode formats directly onto receipts using the `<barcode>` tag with the `encoding` attribute. Supported formats include EAN-13, EAN-8, CODE39, and UPC-A.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

barcode_receipt = """
<receipt>
    <h2 align='center'>Barcode Examples</h2>

    <p align='center'>EAN-13 Barcode:</p>
    <barcode encoding='ean13'>
        5449000000996
    </barcode>

    <p align='center'>EAN-8 Barcode:</p>
    <barcode encoding='ean8'>
        12345670
    </barcode>

    <p align='center'>CODE39 Barcode:</p>
    <barcode encoding='code39'>
        ABC123
    </barcode>

    <p align='center'>UPC-A Barcode:</p>
    <barcode encoding='upc-a'>
        012345678905
    </barcode>

    <cut />
</receipt>
"""

printer.receipt(barcode_receipt)

# Supported encodings: UPC-A, UPC-E, EAN13, EAN8, CODE39, ITF, NW7
```

--------------------------------

### Monitor Printer Status (Python)

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Checks the current status of the printer, including paper level, online status, cover state, and errors. The `printer.get_printer_status()` method returns a dictionary with detailed status information, which can be used for error handling and alerts.

```python
from xmlescpos.printer import Usb
from xmlescpos.exceptions import NoStatusError
import pprint

printer = Usb(0x04b8, 0x0e03)

try:
    status = printer.get_printer_status()
    pprint.pprint(status)

    # Check specific conditions
    if not status['printer']['online']:
        print("ERROR: Printer is offline")

    if not status['offline']['paper']:
        print("WARNING: Out of paper")

    if status['paper']['near_end']:
        print("WARNING: Paper near end")

    if status['offline']['cover_open']:
        print("ERROR: Printer cover is open")

    if status['error']['unrecoverable']:
        print("ERROR: Unrecoverable printer error")

except NoStatusError as e:
    print(f"Cannot retrieve printer status: {e}")
```

--------------------------------

### Disable Auto-Cut Feature for Receipts

Source: https://context7.com/fvdsn/py-xml-escpos/llms.txt

Explains how to prevent the printer from automatically cutting the paper after a receipt is printed using the `cut='false'` attribute in the `<receipt>` tag. This is useful for scenarios requiring continuous printing or manual cutting.

```python
from xmlescpos.printer import Usb

printer = Usb(0x04b8, 0x0e03)

no_cut_receipt = """
<receipt cut='false'>
    <h2>Receipt 1</h2>
    <p>This receipt won't auto-cut</p>
    <hr />
</receipt>
"""

printer.receipt(no_cut_receipt)

# Print another receipt immediately
another_receipt = """
<receipt>
    <h2>Receipt 2</h2>
    <p>This will cut after printing</p>
    <cut />
</receipt>
"""

printer.receipt(another_receipt)
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.