printers

Crates.ioprinters
lib.rsprinters
version2.1.0
sourcesrc
created_at2022-08-23 01:57:50.847828
updated_at2024-11-26 00:39:32.319626
descriptionA lib to get printers and print files on unix and windows
homepagehttps://crates.io/crates/printers
repositoryhttps://github.com/talesluna/rust-printers
max_upload_size
id650680
size79,452
Tales Luna (talesluna)

documentation

README

Printers: A printing APIs implementation for unix (cups) and windows (winspool).

Provides all system printers, create and get print jobs.

Crates.io Version Crates.io License docs.rs Crates.io Downloads (recent)

Documentation

See the references in docs.rs.

Features

Target API List printers List jobs Print bytes and text files Print PDF,images, etc...
Unix cups
Windows winspool 🤔**

** On Windows this lib use RAW datatype to process printing. Expected output depends of printer firmware.

Examples

Get all available printers

let printers = get_printers();
// Vec<Printer>

Create print job of an byte array

printer.print("42".as_bytes());
// Result<(), &'static str>

Create print job of an file

printer.print_file("my_file/example/path.txt");
// Result<(), &'static str>

Get a printer by name

let my_printer = get_printer_by_name("my_printer");
// Option<Printer>

Get the default printer

let printer = get_default_printer();
// Option<Printer>

Simple compilation

use printers::{get_printer_by_name, get_default_printer, get_printers};

fn main() {

    // Iterate all available printers
    for printer in get_printers() {
        println!("{:?}", printer);
    }

    // Get a printer by the name
    let my_printer = get_printer_by_name("my_printer");
    if my_printer.is_some() {
        my_printer.unwrap().print_file("notes.txt", None);
        // Err("") or Ok(())
    }

    // Use the default printer
    let default_printer = get_default_printer();
    if default_printer.is_some() {
        default_printer.unwrap().print("dlrow olleh".as_bytes(), Some("My Job"));
        // Ok(())
    }

}

Commit count: 53

cargo fmt