Struct GitHubActionsEmitter 

pub struct GitHubActionsEmitter {
    pub runner: String,
    pub use_nix: bool,
    pub use_cachix: bool,
    pub cachix_name: Option<String>,
    pub cachix_auth_token_secret: String,
    pub default_paths_ignore: Vec<String>,
    pub build_cuenv: bool,
    pub approval_environment: String,
}

GitHub Actions workflow emitter

Transforms cuenv IR into GitHub Actions workflow YAML that can be committed to .github/workflows/.

IR to GitHub Actions Mapping

IR Field	GitHub Actions
pipeline.name	Workflow name:
pipeline.trigger.branch	on.push.branches / on.pull_request.branches
task.id	Job key
task.command	Step with run: cuenv task {task.id}
task.depends_on	Job needs:
task.manual_approval	Job with environment:
task.concurrency_group	Job-level concurrency:
task.resources.tags	runs-on:
task.outputs (orchestrator)	actions/upload-artifact step

Fields

runner: String

Default runner for jobs

use_nix: bool

Include Nix installation steps

use_cachix: bool

Include Cachix caching steps

cachix_name: Option<String>

Cachix cache name

cachix_auth_token_secret: String

Cachix auth token secret name

default_paths_ignore: Vec<String>

Default paths to ignore in triggers

build_cuenv: bool

Include cuenv build step (via nix build)

approval_environment: String

Environment name for manual approval tasks

Implementations

impl GitHubActionsEmitter

pub fn new() -> Self

Create a new GitHub Actions emitter with default settings

pub fn from_config(config: &GitHubConfig) -> Self

Create an emitter from a GitHubConfig manifest configuration.

This applies all configuration from the CUE manifest to the emitter.

pub fn runner_as_runs_on(&self) -> RunsOn

Get the configured runner as a RunsOn value

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

Set the default runner for jobs

pub fn with_nix(self) -> Self

Enable Nix installation steps

pub fn without_nix(self) -> Self

Disable Nix installation steps

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

Enable Cachix caching with the given cache name

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

Set the Cachix auth token secret name

pub fn with_paths_ignore(self, paths: Vec<String>) -> Self

Set default paths to ignore in triggers

pub fn without_cuenv_build(self) -> Self

Disable automatic cuenv build step

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

Set the environment name for manual approval tasks

pub fn emit_workflows( &self, ir: &IntermediateRepresentation, ) -> EmitterResult<HashMap<String, String>>

Emit multiple workflow files for projects with multiple pipelines.

Returns a map of filename to YAML content. Each pipeline in the IR generates a separate workflow file.

Errors

Returns EmitterError::Serialization if YAML serialization fails.

Trait Implementations

impl Clone for GitHubActionsEmitter

fn clone(&self) -> GitHubActionsEmitter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for GitHubActionsEmitter

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

Formats the value using the given formatter.

impl Default for GitHubActionsEmitter

fn default() -> Self

Returns the “default value” for a type.

impl Emitter for GitHubActionsEmitter

fn emit(&self, ir: &IntermediateRepresentation) -> EmitterResult<String>

Emit a CI configuration from the intermediate representation

fn format_name(&self) -> &'static str

Get the format identifier for this emitter

fn file_extension(&self) -> &'static str

Get the file extension for output files

fn description(&self) -> &'static str

Get a human-readable description of this emitter

fn validate(&self, ir: &IntermediateRepresentation) -> EmitterResult<()>

Validate the IR before emission