Enum JobOutcome 

pub enum JobOutcome {
    Completed,
    DeviceUnavailable {
        reasons: PrinterReason,
    },
    Failed(JobFailure),
}

What a print-job callback reports back to the framework. The framework is the spooler: it decides what happens to the job based on this value, so an implementor only has to classify the result of one attempt — never write its own retry/queue logic.

This is what makes a printer application behave like a printer: a device that isn’t ready (powered off, busy, paper being reloaded) must not drop the job — it returns JobOutcome::DeviceUnavailable and the framework holds the job (job-state = processing-stopped) and retries it until the device is back, the same way a real printer holds a job through a paper jam.

Variants

Completed

The document was printed. The job completes.

DeviceUnavailable

The device can’t print right now but is expected to recover. The framework keeps the job and re-invokes the callback (with backoff) until it prints or the client cancels it, surfacing reasons on the printer (printer-state-reasons) meanwhile. Return this for transient device conditions — unreachable hardware, busy link, media being reloaded.

Fields

reasons: PrinterReason

Reasons to surface while held, e.g. crate::flags::PrinterReason::OFFLINE.

Failed(JobFailure)

Permanent failure for this document (corrupt/unsupported data, a size the device can’t handle, …). The job aborts; retrying wouldn’t help.

Trait Implementations

impl Clone for JobOutcome

fn clone(&self) -> JobOutcome

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for JobOutcome

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.