Struct Artifact 

pub struct Artifact<T> { /* private fields */ }

Owned artifact bytes with an optional destination suggestion and report.

Returned from a handler as Output::Artifact. See the module docs for the destination policy and report channel.

Bytes are owned: streaming is deliberately not part of this contract.

Implementations

impl<T> Artifact<T>

pub fn new(bytes: impl Into<Vec<u8>>) -> Self

Creates an artifact from owned bytes, with no destination suggestion, no stdout fallback, and no report.

Such an artifact is only writable under an explicit output-file override; without one the run fails rather than guessing a destination.

pub fn suggest_destination(self, destination: impl Into<PathBuf>) -> Self

Suggests where the bytes should land, and authorizes the framework to write there when no explicit override is given.

This opt-in is what separates an artifact from Output::Binary: a filename on binary output is a hint to the caller, never a license to touch the filesystem.

pub fn allow_stdout(self) -> Self

Authorizes stdout as the last-resort destination.

Without this, an artifact with no override and no suggestion is a typed failure. With it, the report is routed to stderr so it can never contaminate the bytes.

pub fn with_report(self, report: T) -> Self

Attaches the application-owned semantic report rendered after the write.

The report is the application’s own type: counts, warnings, partial success — whatever taxonomy it owns. Standout only transports it.

pub fn bytes(&self) -> &[u8]

Returns the artifact bytes.

pub fn suggested_destination(&self) -> Option<&Path>

Returns the suggested destination, if the application opted in.

pub fn stdout_allowed(&self) -> bool

Returns true if the application authorized the stdout fallback.

pub fn report(&self) -> Option<&T>

Returns the semantic report, if any.

pub fn into_parts(self) -> (Vec<u8>, Option<PathBuf>, bool, Option<T>)

Splits the artifact into its bytes, suggestion, stdout opt-in, and report.

Trait Implementations

impl<T: Clone> Clone for Artifact<T>

fn clone(&self) -> Artifact<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for Artifact<T>

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

Formats the value using the given formatter.

impl<T: Eq> Eq for Artifact<T>

impl<T: PartialEq> PartialEq for Artifact<T>

fn eq(&self, other: &Artifact<T>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<T: PartialEq> StructuralPartialEq for Artifact<T>