Struct BuildRunner

pub struct BuildRunner<'a, 'gctx> {

    pub bcx: &'a BuildContext<'a, 'gctx>,
    pub compilation: Compilation<'gctx>,
    pub build_script_outputs: Arc<Mutex<BuildScriptOutputs>>,
    pub build_explicit_deps: HashMap<Unit, BuildDeps>,
    pub fingerprints: HashMap<Unit, Arc<Fingerprint>>,
    pub mtime_cache: HashMap<PathBuf, FileTime>,
    pub checksum_cache: HashMap<PathBuf, Checksum>,
    pub compiled: HashSet<Unit>,
    pub build_scripts: HashMap<Unit, Arc<BuildScripts>>,
    pub jobserver: Client,
    primary_packages: HashSet<PackageId>,
    files: Option<CompilationFiles<'a, 'gctx>>,
    rmeta_required: HashSet<Unit>,
    pub lto: HashMap<Unit, Lto>,
    pub metadata_for_doc_units: HashMap<Unit, Metadata>,
    pub failed_scrape_units: Arc<Mutex<HashSet<Metadata>>>,
}

Collection of all the stuff that is needed to perform a build.

Different from the BuildContext, Context is a mutable state used throughout the entire build process. Everything is coordinated through this.

Fields

bcx: &'a BuildContext<'a, 'gctx>

Mostly static information about the build task.

compilation: Compilation<'gctx>

A large collection of information about the result of the entire compilation.

build_script_outputs: Arc<Mutex<BuildScriptOutputs>>

Output from build scripts, updated after each build script runs.

build_explicit_deps: HashMap<Unit, BuildDeps>

Dependencies (like rerun-if-changed) declared by a build script. This is only populated from the output from previous runs. If the build script hasn’t ever been run, then it must be run.

fingerprints: HashMap<Unit, Arc<Fingerprint>>

Fingerprints used to detect if a unit is out-of-date.

mtime_cache: HashMap<PathBuf, FileTime>

Cache of file mtimes to reduce filesystem hits.

checksum_cache: HashMap<PathBuf, Checksum>

Cache of file checksums to reduce filesystem reads.

compiled: HashSet<Unit>

A set used to track which units have been compiled. A unit may appear in the job graph multiple times as a dependency of multiple packages, but it only needs to run once.

build_scripts: HashMap<Unit, Arc<BuildScripts>>

Linking information for each Unit. See build_map for details.

jobserver: Client

Job server client to manage concurrency with other processes.

primary_packages: HashSet<PackageId>

“Primary” packages are the ones the user selected on the command-line with -p flags. If no flags are specified, then it is the defaults based on the current directory and the default workspace members.

files: Option<CompilationFiles<'a, 'gctx>>

An abstraction of the files and directories that will be generated by the compilation. This is None until after unit_dependencies has been computed.

rmeta_required: HashSet<Unit>

A set of units which are compiling rlibs and are expected to produce metadata files in addition to the rlib itself.

lto: HashMap<Unit, Lto>

Map of the LTO-status of each unit. This indicates what sort of compilation is happening (only object, only bitcode, both, etc), and is precalculated early on.

metadata_for_doc_units: HashMap<Unit, Metadata>

Map of Doc/Docscrape units to metadata for their -Cmetadata flag. See Context::find_metadata_units for more details.

failed_scrape_units: Arc<Mutex<HashSet<Metadata>>>

Set of metadata of Docscrape units that fail before completion, e.g. because the target has a type error. This is in an Arc<Mutex<..>> because it is continuously updated as the job progresses.

Implementations

impl<'a, 'gctx> BuildRunner<'a, 'gctx>

pub fn new(bcx: &'a BuildContext<'a, 'gctx>) -> CargoResult<Self>

pub fn dry_run(self) -> CargoResult<Compilation<'gctx>>

Dry-run the compilation without actually running it.

This is expected to collect information like the location of output artifacts. Please keep in sync with non-compilation part in BuildRunner::compile.

pub fn compile( self, exec: &Arc<dyn Executor>, ) -> CargoResult<Compilation<'gctx>>

Starts compilation, waits for it to finish, and returns information about the result of compilation.

See ops::cargo_compile for a higher-level view of the compile process.

fn collect_tests_and_executables(&mut self, unit: &Unit) -> CargoResult<()>

pub fn get_executable(&mut self, unit: &Unit) -> CargoResult<Option<PathBuf>>

Returns the executable for the specified unit (if any).

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

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

Prepare this context, ensuring that all filesystem directories are in place.

pub fn files(&self) -> &CompilationFiles<'a, 'gctx>

pub fn outputs(&self, unit: &Unit) -> CargoResult<Arc<Vec<OutputFile>>>

Returns the filenames that the given unit will generate.

pub fn unit_deps(&self, unit: &Unit) -> &[UnitDep]

Direct dependencies for the given unit.

pub fn find_build_script_unit(&self, unit: &Unit) -> Option<Unit>

Returns the RunCustomBuild Unit associated with the given Unit.

If the package does not have a build script, this returns None.

pub fn find_build_script_metadata(&self, unit: &Unit) -> Option<Metadata>

Returns the metadata hash for the RunCustomBuild Unit associated with the given unit.

If the package does not have a build script, this returns None.

pub fn get_run_build_script_metadata(&self, unit: &Unit) -> Metadata

Returns the metadata hash for a RunCustomBuild unit.

pub fn is_primary_package(&self, unit: &Unit) -> bool

pub fn build_plan_inputs(&self) -> CargoResult<Vec<PathBuf>>

Returns the list of filenames read by cargo to generate the BuildContext (all Cargo.toml, etc.).

pub fn unit_output(&self, unit: &Unit, path: &Path) -> UnitOutput

Returns a UnitOutput which represents some information about the output of a unit.

fn check_collisions(&self) -> CargoResult<()>

Check if any output file name collision happens. See https://github.com/rust-lang/cargo/issues/6313 for more.

fn record_units_requiring_metadata(&mut self)

Records the list of units which are required to emit metadata.

Units which depend only on the metadata of others requires the others to actually produce metadata, so we’ll record that here.

pub fn only_requires_rmeta(&self, parent: &Unit, dep: &Unit) -> bool

Returns whether when parent depends on dep if it only requires the metadata file from dep.

pub fn rmeta_required(&self, unit: &Unit) -> bool

Returns whether when unit is built whether it should emit metadata as well because some compilations rely on that.

pub fn compute_metadata_for_doc_units(&mut self)

Finds metadata for Doc/Docscrape units.

rustdoc needs a -Cmetadata flag in order to recognize StableCrateIds that refer to items in the crate being documented. The -Cmetadata flag used by reverse-dependencies will be the metadata of the Cargo unit that generated the current library’s rmeta file, which should be a Check unit.

If the current crate has reverse-dependencies, such a Check unit should exist, and so we use that crate’s metadata. If not, we use the crate’s Doc unit so at least examples scraped from the current crate can be used when documenting the current crate.

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: 1928 bytes