Struct Task 

pub struct Task {

    pub id: String,
    pub runtime: Option<String>,
    pub command: Vec<String>,
    pub shell: bool,
    pub env: BTreeMap<String, String>,
    pub secrets: BTreeMap<String, SecretConfig>,
    pub resources: Option<ResourceRequirements>,
    pub concurrency_group: Option<String>,
    pub inputs: Vec<String>,
    pub outputs: Vec<OutputDeclaration>,
    pub depends_on: Vec<String>,
    pub cache_policy: CachePolicy,
    pub deployment: bool,
    pub manual_approval: bool,
    pub matrix: Option<MatrixConfig>,
    pub artifact_downloads: Vec<ArtifactDownload>,
    pub params: BTreeMap<String, String>,
    pub phase: Option<BuildStage>,
    pub label: Option<String>,
    pub priority: Option<i32>,
    pub contributor: Option<String>,
    pub condition: Option<TaskCondition>,
    pub provider_hints: Option<Value>,
}

Task definition in the IR

Fields

id: String

Unique task identifier

runtime: Option<String>

Runtime environment ID

command: Vec<String>

Command to execute (array form for direct execve)

shell: bool

Shell execution mode (false = direct execve, true = wrap in /bin/sh -c)

env: BTreeMap<String, String>

Environment variables

secrets: BTreeMap<String, SecretConfig>

Secret configurations

resources: Option<ResourceRequirements>

Resource requirements (for scheduling)

concurrency_group: Option<String>

Concurrency group for serialized execution

inputs: Vec<String>

Input file globs (expanded at compile time)

outputs: Vec<OutputDeclaration>

Output declarations

depends_on: Vec<String>

Task dependencies (must complete before this task runs)

cache_policy: CachePolicy

Cache policy

deployment: bool

Deployment flag (if true, cache_policy is forced to disabled)

manual_approval: bool

Manual approval required before execution

matrix: Option<MatrixConfig>

Matrix configuration for parallel job expansion

artifact_downloads: Vec<ArtifactDownload>

Artifacts to download before running this task

params: BTreeMap<String, String>

Parameters to pass to the task command

phase: Option<BuildStage>

Phase this task belongs to (None = regular task, Some = phase task)

Phase tasks are contributed by CUE contributors and run at specific lifecycle points: bootstrap, setup, success, or failure.

label: Option<String>

Human-readable label for display (primarily for phase tasks)

priority: Option<i32>

Priority within phase (lower = earlier, default 10)

Only meaningful for phase tasks. Used for ordering when multiple contributors add tasks to the same phase.

contributor: Option<String>

Contributor that added this task (e.g., “nix”, “codecov”)

Set when this task was contributed by a CUE contributor.

condition: Option<TaskCondition>

Execution condition for phase tasks

Determines when the task runs relative to other task outcomes:

• OnSuccess: Run only if all prior tasks succeeded
• OnFailure: Run only if any prior task failed
• Always: Run regardless of prior task outcomes

provider_hints: Option<Value>

Provider-specific hints (e.g., GitHub Action specs)

Opaque JSON value that provider-specific emitters can interpret. For GitHub, may contain { "github_action": { "uses": "...", "with": {...} } }.

Implementations

impl Task

pub fn label(&self) -> String

Get the display label for this task, falling back to the ID.

Used by renderers when generating step names in CI workflows.

pub fn command_string(&self) -> String

Get the command as a single string (for shell execution).

Joins the command array with spaces.

pub fn synthetic_aggregation( id: impl Into<String>, artifact_downloads: Vec<ArtifactDownload>, params: BTreeMap<String, String>, ) -> Self

Create a synthetic task for artifact aggregation.

Used when converting MatrixTask (with artifacts/params but no matrix dimensions) into an IR Task for the emitter.

pub fn synthetic_matrix(id: impl Into<String>, matrix: MatrixConfig) -> Self

Create a synthetic task for matrix expansion.

Used when converting MatrixTask (with matrix dimensions) into an IR Task for the emitter.

Trait Implementations

impl Clone for Task

fn clone(&self) -> Task

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Task

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Task

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Task

fn eq(&self, other: &Task) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Task

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for Task

impl StructuralPartialEq for Task