Enum BuildInput 

pub enum BuildInput {
    AddInMemoryFile {
        dst_path: Utf8PathBuf,
        contents: String,
    },
    AddDirectory(TargetDirectory),
    AddFile {
        mapped_path: MappedPath,
        len: u64,
    },
    AddBlob {
        path: MappedPath,
        blob: Source,
    },
    AddPackage(TargetPackage),
}

All possible inputs which are used to construct Omicron packages

Variants

AddInMemoryFile

Adds a single file, which is stored in-memory.

This is mostly used as a way to cache metadata.

Fields

dst_path: Utf8PathBuf

contents: String

AddDirectory(TargetDirectory)

Add a single directory to the target archive.

This directory doesn’t need to exist on the build host.

AddFile

Add a file directly from source to target.

Fields

mapped_path: MappedPath

Describes the files being added.

len: u64

The length of the file.

Q: Is this necessary? Aren’t we already storing the file itself, making this field redundant?

A: We use it to help caching, on the “known cache miss” case. In most circumstances where a file has been edited, the length changes too. Comparing u64s is significantly faster than hashing, in this situation.

AddBlob

Add a dowloaded file from source to target.

This is similar to “AddFile”, though it may require downloading an input first.

Fields

path: MappedPath

blob: Source

AddPackage(TargetPackage)

Add a package from source to target.

This is similar to “AddFile”, though it requires unpacking the package and re-packaging it into the target.

Implementations

impl BuildInput

pub fn input_path(&self) -> Option<&Utf8Path>

If the input has a path on the host machine, return it.

pub fn add_file(mapped_path: MappedPath) -> Result<Self>

Trait Implementations

impl Clone for BuildInput

fn clone(&self) -> BuildInput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuildInput

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BuildInput

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for BuildInput

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for BuildInput

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for BuildInput

impl StructuralPartialEq for BuildInput