Contents
execute
Execute reactive resolution
Resolve one or more output resource specifications through the reactive execution engine.
Return the current status of an asynchronous execution started through
workspace$.internal$resolver$resolve.async().
Return a compact execution summary for an asynchronous run.
Return the tracked execution dependency graph and node states.
Return the most recently started execution-engine run tracked by workspace.
Usage
execute(
outputs,
.execute = TRUE,
.transform = NULL,
.action = NULL,
.status = NULL
)
execute.status(execution)
execute.summary(execution)
execute.graph(execution)
execute.last()Arguments
| Argument | Description |
|---|---|
outputs | Output specification(s): single ResourceSpec, list/vector of ResourceSpec, or ResourceSpecSet. |
.execute | Logical; when TRUE run execution-engine resolution, otherwise return requested specs without scheduling. |
.transform | Optional function applied to the loaded output value list before returning (only when .execute = TRUE). |
.action | Optional execution-engine action label used in live execution status. |
.status | Optional execution-status mode override ("auto", "yes", "no"). Defaults to options("PolyGenius.execution.status"). |
execution | Execution object returned by workspace$.internal$resolver$resolve.async(). |
Value
When .execute = TRUE, resolved output resource value(s) loaded from
cache (single value for one output, list for multiple outputs). When
.execute = FALSE, a ResourceSpecSet containing .arg outputs.
A single status string ("pending", "running",
"completed", or "failed").
A named list with execution-engine progress fields such as status, queued/running counts, and failure details.
A named list with:
nodes: node table withid,type,label,status, andreason.edges: dependency edges (from->towithinputname).blocked.by: subset of edges explaining blocked nodes via failed/blocked upstream nodes.
Execution object or NULL when no execution has run yet.
Details
The output specs are the contract for the dependency graph. Rules declare and bind upstream dependencies from those specs, so callers provide requested outputs only.
When .execute = FALSE, this helper does not schedule work and returns a
ResourceSpecSet containing requested outputs.
See Also
Other engine-core:
ExecutionEngine,
ExecutionScheduler,
ResourceResolver(),
ResourceSpec,
ResourceSpecSet(),
Rule,
RuleRegistry,
TaskExecutor(),
resources.factory,
resources.type