Struct Build 

pub struct Build {
    pub rule: RefCounted<String>,
    pub outputs: AddOnlyVec<String>,
    pub implicit_outputs: AddOnlyVec<String>,
    pub dependencies: AddOnlyVec<String>,
    pub implicit_dependencies: AddOnlyVec<String>,
    pub order_only_dependencies: AddOnlyVec<String>,
    pub validations: AddOnlyVec<String>,
    pub variables: AddOnlyVec<Variable>,
}

A build edge, as defined by the build keyword

See https://ninja-build.org/manual.html#_build_statements

Example

Since build edges are tied to rules, use RuleRef::build to create them.

use ninja_writer::*;

let ninja = Ninja::new();
let cc = ninja.rule("cc", "gcc $cflags -c $in -o $out");
cc.build(["foo.o"]).with(["foo.c"]);

assert_eq!(ninja.to_string(), r###"
rule cc
  command = gcc $cflags -c $in -o $out

build foo.o: cc foo.c
"###);

Fields

rule: RefCounted<String>

The rule name

outputs: AddOnlyVec<String>

The list of outputs, as defined by build <outputs>:

implicit_outputs: AddOnlyVec<String>

The list of implicit outputs.

See https://ninja-build.org/manual.html#ref_outputs

dependencies: AddOnlyVec<String>

The list of dependencies (inputs).

See https://ninja-build.org/manual.html#ref_dependencies

implicit_dependencies: AddOnlyVec<String>

The list of implicit dependencies (inputs).

See https://ninja-build.org/manual.html#ref_dependencies

order_only_dependencies: AddOnlyVec<String>

The list of order-only dependencies (inputs).

See https://ninja-build.org/manual.html#ref_dependencies

validations: AddOnlyVec<String>

The list of validations.

See https://ninja-build.org/manual.html#validations

variables: AddOnlyVec<Variable>

The list of variables, as an indented block

Implementations

impl Build

pub fn new(rule: &Rule, outputs: impl IntoIterator<Item = impl ToArg>) -> Self

Create a new build with the given explicit outputs and rule

Trait Implementations

impl AsRef<Build> for BuildRef

fn as_ref(&self) -> &Build

Converts this type into a shared reference of the (usually inferred) input type.

impl BuildVariables for Build

fn as_build(&self) -> &Build

Internal function for implementing variables for build

fn dyndep(self, dyndep: impl ToArg) -> Self

Specify dynamic dependency file

fn with(self, inputs: impl IntoIterator<Item = impl ToArg>) -> Self

Add explicit dependencies (inputs)

fn with_implicit(self, inputs: impl IntoIterator<Item = impl ToArg>) -> Self

Add implicit dependencies

fn with_order_only(self, inputs: impl IntoIterator<Item = impl ToArg>) -> Self

Add order-only dependencies

fn validations(self, validations: impl IntoIterator<Item = impl ToArg>) -> Self

Add validations

fn output_implicit(self, outputs: impl IntoIterator<Item = impl ToArg>) -> Self

Add validations

impl Debug for Build

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

Formats the value using the given formatter.

impl Display for Build

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

Formats the value using the given formatter.

impl RuleVariables for Build

fn depfile(self, depfile: impl ToArg) -> Self

Set the depfile for this rule or build to explicitly support C/C++ header dependencies

fn deps_gcc(self) -> Self

Set deps = gcc for this rule or build

fn deps_msvc_prefix(self, msvc_deps_prefix: impl ToArg) -> Self

Set deps = msvc for this rule (or build) and the msvc_deps_prefix variable

fn deps_msvc(self) -> Self

Set deps = msvc for this rule or build without msvc_deps_prefix

fn description(self, desc: impl ToArg) -> Self

Set the description of the rule to be printed during the build

fn generator(self) -> Self

Indicate the rule is used to re-invoke the generator

fn restat(self) -> Self

Specify restat = 1 for the rule or build

fn rspfile(self, rspfile: impl ToArg, rspfile_content: impl ToArg) -> Self

Specify rspfile and rspfile_content variables for this rule or build

fn pool_console(self) -> Self

Set pool = console for this rule or build

fn pool(self, pool: impl AsRef<Pool>) -> Self

Set the pool for this rule or build

impl Variables for Build

fn add_variable_internal(&self, v: Variable)

Add a variable

fn variable(self, name: impl ToArg, value: impl ToArg) -> Self

Add a variable to the current scope