# [Printers](https://crates.io/crates/printers): A printing APIs implementation for unix *(cups)* and windows *(winspool)*.
Provides all system printers, create and manage print jobs.
## Documentation
See the references in [docs.rs](https://docs.rs/printers).
## 🛠️ Features
| Unix | cups | ✅ | ✅ | ✅ | ✅ |
| Windows | winspool | ✅ | ✅ | ✅ | 🤔** |
> ** On Windows this lib use RAW datatype to process printing by default. Expected output depends of printer firmware.
## 👇 Examples
**Get all available printers**
```rust
let printers = get_printers();
// Vec<Printer>
```
**Create print job of an byte array**
```rust
let job_id = printer.print("42".as_bytes(), PrinterJobOptions::none());
// Result<u64, &'static str>
```
**Create print job of an file**
```rust
let job_id = printer.print_file("my_file/example/path.txt", PrinterJobOptions {
name: Some("My print job"),
raw_properties: &[
("copies", "2"),
("document-format", "XPS"),
],
});
// Result<u64, &'static str>
```
**Get a printer by name**
```rust
let my_printer = get_printer_by_name("my_printer");
// Option<Printer>
```
**Get the default printer**
```rust
let printer = get_default_printer();
// Option<Printer>
```
**Manage state of printer job**
```rust
// Pause
printer.pause_job(123);
// Resume
printer.resume_job(123);
// Restart
printer.restart_job(123);
// Cancel
printer.cancel_job(123)
```
## ⏳ Future
- GhostScript option conversion support