Struct Generator 

pub struct Generator<'a> { /* private fields */ }

Generates the publish tree for one or more Projects into a shared output root, atomically. Construct with Generator::new (single) or Generator::for_projects (a workspace’s bins) and configure with the chained setters.

Implementations

impl<'a> Generator<'a>

pub fn new(project: &'a Project) -> Self

Start a generation for a single project.

pub fn for_projects(projects: &'a [Project]) -> Self

Start a generation for several projects (e.g. one per workspace bin) sharing one output root; they are assembled and swapped together.

pub fn build_driver(self, driver: &'a dyn BuildDriver) -> Self

Inject a build driver, overriding the default cargo command. Lets a library consumer or test supply a custom BuildDriver.

pub fn out(self, out: impl Into<PathBuf>) -> Self

Output root for the generated tree.

pub fn tag(self, tag: impl Into<String>) -> Self

Require the resolved version to equal v<tag>.

pub fn no_build(self, no_build: bool) -> Self

Skip the build phase and assemble from existing binaries.

pub fn driver(self, driver: impl Into<String>) -> Self

Build driver invoked per target (e.g. cargo, cross, cargo-zigbuild).

pub fn targets( self, targets: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Restrict generation to these target keys; empty means all resolved.

pub fn run(&self) -> Result<()>

Build (unless skipped) and assemble every project, then atomically swap the whole tree onto out. Either all projects land or none do.

Trait Implementations

impl<'a> Debug for Generator<'a>

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

Formats the value using the given formatter.