Struct BuildDirLayout 

pub struct BuildDirLayout {
    root: PathBuf,
    deps: PathBuf,
    build: PathBuf,
    artifact: PathBuf,
    incremental: PathBuf,
    fingerprint: PathBuf,
    examples: PathBuf,
    tmp: PathBuf,
    _lock: Option<FileLock>,
    is_new_layout: bool,
}

Fields

root: PathBuf

The root directory: /path/to/build-dir. If cross compiling: /path/to/build-dir/$TRIPLE.

deps: PathBuf

The directory with rustc artifacts

build: PathBuf

The primary directory for build files

artifact: PathBuf

The directory for artifacts, i.e. binaries, cdylibs, staticlibs

incremental: PathBuf

The directory for incremental files

fingerprint: PathBuf

The directory for fingerprints

examples: PathBuf

The directory for pre-uplifted examples: build-dir/debug/examples

tmp: PathBuf

The directory for temporary data of integration tests and benches

_lock: Option<FileLock>

The lockfile for a build (.cargo-lock). Will be unlocked when this struct is dropped.

Will be None when the build-dir and target-dir are the same path as we cannot lock the same path twice.

is_new_layout: bool

Implementations

impl BuildDirLayout

pub fn prepare(&mut self) -> CargoResult<()>

Makes sure all directories stored in the Layout exist on the filesystem.

pub fn deps(&self, pkg_dir: &str) -> PathBuf

Fetch the deps path.

pub fn legacy_deps(&self) -> &Path

Fetch the deps path. (old layout)

pub fn root(&self) -> &Path

pub fn examples(&self) -> &Path

Fetch the build examples path.

pub fn incremental(&self) -> &Path

Fetch the incremental path.

pub fn fingerprint(&self, pkg_dir: &str) -> PathBuf

Fetch the fingerprint path.

pub fn legacy_fingerprint(&self) -> &Path

Fetch the fingerprint path. (old layout)

pub fn build(&self) -> &Path

Fetch the build path.

pub fn build_script(&self, pkg_dir: &str) -> PathBuf

Fetch the build script path.

pub fn build_script_execution(&self, pkg_dir: &str) -> PathBuf

Fetch the build script execution path.

pub fn artifact(&self) -> &Path

Fetch the artifact path.

pub fn build_unit(&self, pkg_dir: &str) -> PathBuf

Fetch the build unit path

pub fn prepare_tmp(&self) -> CargoResult<&Path>

Create and return the tmp path.

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 232 bytes