Lua API Workers

Lua API — Workers (ctx:spawn, ctx:wait)

Run shell commands in the background inside a Lua step callback.

Only available in step({ run = function(ctx) ... end }).

ctx:spawn(options)

Field	Required	Type
cmd	yes	string or { string, ... }
inputs	no	glob list for cache inputs
outputs	no	glob list for cache outputs
name	no	override auto name {step}-{n}

Returns: worker handle (number).

ctx:wait(handle [, options])

Wait for one worker. Pass an options table to select return fields:

Option	Return field
exitCode	result.exitCode
output	result.output (captured stdout/stderr)
duration	result.duration
cached	result.cached
name	result.name
id	result.id
dryRun	result.dryRun

ctx:wait_all(handles [, options])

Same options for every handle. Returns 1-based array of result tables in handle order.

Example

step({
name="compile",
phase="build",
scope="cpp",
run=function(ctx)
localjobs= {}
for_, srcinipairs(beez.fs.glob("src/**/*.cpp")) dojobs[#jobs+1] =ctx:spawn({ cmd="g++ -c " ..src })
endfor_, resultinipairs(ctx:wait_all(jobs, { exitCode=true })) doifresult.exitCode~=0thenerror("compile failed") endendreturn0end,
})

Full reference: docs/worker-api.md

---

← Lua API Overview