zpl-builder

A Rust library for building ZPL II label strings to send to Zebra thermal printers.

Overview

ZPL (Zebra Programming Language) is a label description language interpreted by Zebra printers. This library lets you build valid ZPL strings in Rust without constructing raw strings by hand.

All field values are validated against the ZPL II specification at construction time. An invalid value returns a ZplError rather than silently producing a malformed command string.

Installation

[dependencies]
zpl-builder = "0.1"

Quick start

use zpl_rs::{LabelBuilder, BarcodeType, Color, Orientation};

let zpl = LabelBuilder::new()
.set_home_position(10, 10).unwrap()
.add_text("Hello, printer!", 50, 50, 'A', 30, Orientation::Normal).unwrap()
.add_graphical_box(10, 10, 500, 300, 3, Color::Black, 0).unwrap()
.add_barcode(BarcodeType::Code128, "ABC-123", 50, 120, 2, 2.5, 80, Orientation::Normal).unwrap()
.build();

// Send `zpl` to your printer over TCP, USB, or serial.

Error handling

Every builder method returns Result<LabelBuilder, ZplError>, so you can chain with ?:

use zpl_rs::{LabelBuilder, Color, Orientation, ZplError};

fn build_label(tracking: &str) -> Result<String, ZplError> {
    Ok(LabelBuilder::new()
        .set_home_position(0, 0)?
        .add_text("SHIP TO:", 10, 10, 'B', 20, Orientation::Normal)?
        .add_graphical_box(5, 5, 400, 200, 2, Color::Black, 0)?
        .build())
}

Supported elements

Supported barcode types

Aztec, Code11, Interleaved, Code39, Code49, PlanetCode, Pdf417, EAN8, UpcE, Code93, CodaBlock, Code128, UPSMaxiCode, EAN13, MicroPDF417, Industrial, Standard, ANSICodeBar, LogMars, MSI, Plessey, QrCode, Rss, UpcEanExtension, Tlc39, UpcA, DataMatrix.

Validation ranges

License

MIT — see LICENSE.