Struct Compilation 

pub struct Compilation<'cfg> {

    pub tests: Vec<(Package, Target, PathBuf)>,
    pub binaries: Vec<PathBuf>,
    pub native_dirs: BTreeSet<PathBuf>,
    pub root_output: PathBuf,
    pub deps_output: PathBuf,
    pub host_deps_output: PathBuf,
    pub host_dylib_path: PathBuf,
    pub target_dylib_path: PathBuf,
    pub extra_env: HashMap<PackageId, Vec<(String, String)>>,
    pub to_doc_test: Vec<Doctest>,
    pub cfgs: HashMap<PackageId, HashSet<String>>,
    pub rustdocflags: HashMap<PackageId, Vec<String>>,
    pub host: String,
    pub target: String,
    /* private fields */
}

A structure returning the result of a compilation.

Fields

tests: Vec<(Package, Target, PathBuf)>

An array of all tests created during this compilation. (package, target, path_to_test_exe)

binaries: Vec<PathBuf>

An array of all binaries created.

native_dirs: BTreeSet<PathBuf>

All directories for the output of native build commands.

This is currently used to drive some entries which are added to the LD_LIBRARY_PATH as appropriate.

The order should be deterministic.

root_output: PathBuf

Root output directory (for the local package’s artifacts)

deps_output: PathBuf

Output directory for rust dependencies. May be for the host or for a specific target.

host_deps_output: PathBuf

Output directory for the rust host dependencies.

host_dylib_path: PathBuf

The path to rustc’s own libstd

target_dylib_path: PathBuf

The path to libstd for the target

extra_env: HashMap<PackageId, Vec<(String, String)>>

Extra environment variables that were passed to compilations and should be passed to future invocations of programs.

to_doc_test: Vec<Doctest>

Libraries to test with rustdoc.

cfgs: HashMap<PackageId, HashSet<String>>

Features per package enabled during this compilation.

rustdocflags: HashMap<PackageId, Vec<String>>

Flags to pass to rustdoc when invoked from cargo test, per package.

host: String

target: String

Implementations

impl<'cfg> Compilation<'cfg>

pub fn new<'a>( bcx: &BuildContext<'a, 'cfg>, default_kind: CompileKind, ) -> CargoResult<Compilation<'cfg>>

pub fn rustc_process( &self, pkg: &Package, is_primary: bool, is_workspace: bool, ) -> CargoResult<ProcessBuilder>

See process.

pub fn rustdoc_process( &self, pkg: &Package, target: &Target, ) -> CargoResult<ProcessBuilder>

See process.

pub fn host_process<T: AsRef<OsStr>>( &self, cmd: T, pkg: &Package, ) -> CargoResult<ProcessBuilder>

See process.

pub fn target_runner(&self) -> &Option<(PathBuf, Vec<String>)>

pub fn target_process<T: AsRef<OsStr>>( &self, cmd: T, pkg: &Package, ) -> CargoResult<ProcessBuilder>

See process.