# photocraft-ipp

A small IPP (Internet Printing Protocol, RFC 8010/8011) client for the local CUPS server, in pure
Rust with no dependencies. It does in-process what `lp` does from the command line, so PhotoCraft
can print where there is no `lp` binary (a Flatpak sandbox with `--socket=cups`, a minimal
container) and can read the printer list and the default printer first instead of handing
CUPS's errors to the user.

```rust
let ep = photocraft_ipp::Endpoint::detect().ok_or("no CUPS server")?;   // socket, then localhost:631
let printers = photocraft_ipp::printers(&ep)?;                            // name, info, state, default
let id = photocraft_ipp::print_job(&ep, &photocraft_ipp::Job { printer: "Office", title: "photo", user: "me", copies: 2, document: &pdf, format: "application/pdf" })?;
```

Three operations: `CUPS-Get-Printers`, `CUPS-Get-Default`, `Print-Job`. HTTP/1.1 over the CUPS
domain socket (`/run/cups/cups.sock`, or `CUPS_SERVER` as a path) or TCP (`localhost:631`, or
`CUPS_SERVER` as `host[:port]`), chunked replies included. Replies are capped at 16 MiB and
parsed with bounds checks; an IPP error status becomes `Error::Status` with the server's own
message. Tests run against an in-process fake server over TCP and a Unix socket.

Standalone: it depends on no other PhotoCraft crate. Used by `photocraft-engine`'s print
commands on Unix; Windows printing lives in `photocraft-winprint`.