Struct BuilderEntry 

pub struct BuilderEntry {
    pub builder: AnyBuilder,
    pub id: Option<String>,
    pub depends_on: Vec<String>,
    pub category: Option<String>,
    pub name: Option<String>,
    pub comment: Option<String>,
}

A single [[builders]] entry: the builder itself plus optional dependency metadata.

Dependency ordering

By default every builder runs concurrently with all others. When a builder must only start after another one has finished successfully, give the prerequisite an id and list that id in the dependent’s depends_on:

[[builders]]
type = "cargo"
id   = "compile"               # ← give this builder a name

[[builders]]
type   = "script"
script = ["strip target/release/my_bin"]
outputs = ["target/release/my_bin"]
depends_on = ["compile"]       # ← wait for the builder above

Circular dependencies are detected before any builder starts and reported as an error.

Fields

builder: AnyBuilder

The builder’s type-specific configuration (type tag + all builder fields), serialised flat into the same TOML table.

id: Option<String>

Optional identifier for this builder. Other builders reference this string in their depends_on list.

depends_on: Vec<String>

IDs of builders that must complete successfully before this one starts.

category: Option<String>

Optional category for grouping artifacts on the release page. Artifacts produced by builders with the same category are listed together under a shared heading.

name: Option<String>

Optional display name for the artifacts this builder produces. When set, it is shown as a heading on the release page, grouping all outputs from this builder entry together.

comment: Option<String>

Optional comment or description shown alongside the artifacts on the release page. Useful for adding build architecture notes or usage instructions.

Implementations

impl BuilderEntry

pub fn label(&self) -> &'static str

Short human-readable label forwarded from the inner builder.

pub async fn build( &self, version: &str, log: LogSender, ) -> Result<Vec<ArtifactPath>>

Run the inner builder, forwarding the version string and log sender. Each returned ArtifactPath inherits this entry’s category, name, and comment.

Trait Implementations

impl Clone for BuilderEntry

fn clone(&self) -> BuilderEntry

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for BuilderEntry

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for BuilderEntry

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for BuilderEntry

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for BuilderEntry

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.