Enum Artifact 

pub enum Artifact {
    Nothing,
    Text(String),
    Object {
        bytes: Vec<u8>,
        defines: Vec<String>,
    },
}

What a compilation produced, which is text for most of the kinds and bytes for one of them.

Two variants rather than a string, because an object file is not text and a Vec<u8> holding UTF-8 for six kinds and a file format for the seventh would leave every reader guessing which it had. Artifact::Nothing is what a compilation that stopped early gives back, and it is not the same as an empty file: nothing is written for it at all.

Variants

Nothing

The compilation stopped before it produced anything, or the kind asked for produces nothing yet.

Text(String)

Text, which is every kind up to and including assembly.

Object

An object file, which is -c, and the names a linker can find in it.

The names travel with the bytes rather than beside them because what wants them is the archive step, and an index entry that does not match the member is worse than no archive: the linker searches the index, pulls the member out, and still reports the name undefined. One value holding both is one value the two cannot disagree in.

Fields

bytes: Vec<u8>

The file.

defines: Vec<String>

Every name another object can reach, as the object writer wrote them. Empty is a real answer: a translation unit of nothing but static functions is a member an archive carries and nothing ever pulls out.

Implementations

impl Artifact

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

The bytes to write, which is nothing at all for Artifact::Nothing.

Trait Implementations

impl Clone for Artifact

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Artifact

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

Formats the value using the given formatter.

impl Default for Artifact

fn default() -> Self

Returns the “default value” for a type.

impl Eq for Artifact

impl PartialEq for Artifact

fn eq(&self, other: &Self) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Artifact