runtime

package

v0.6.0 Latest Latest Go to latest Published: Aug 26, 2026 License: MIT Imports: 3 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/rune-task-runner/rune

Links

Open Source Insights

Documentation ¶

Overview ¶

Package runtime selects and drives the executor for a task body: the default pure-Go shell (internal/runtime/shell), a temp-file interpreter for python/node/custom or a `set shell` override (internal/runtime/interp), or the AI-agent driver (internal/runtime/agent).

Index ¶

type Kind
type Selection
- func Select(task *ast.Task, settings config.Settings) Selection

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

This section is empty.

Types ¶

type Kind ¶

type Kind int

Kind identifies which executor runs a task body.

const (
	KindShell  Kind = iota // mvdan/sh (default, never the system shell)
	KindInterp             // temp-file + exec a real interpreter
	KindAgent              // drive an installed agent CLI (US4)
)

type Selection ¶

type Selection struct {
	Kind    Kind
	Command []string // interpreter command (KindInterp): e.g. ["python3"]
	Display string   // human-facing name for diagnostics
}

Selection is the resolved executor for a task.

func Select ¶

func Select(task *ast.Task, settings config.Settings) Selection

Select resolves a task's executor from its declared executor, any [script("...")] attribute, and the module settings. A `set shell := [...]` override switches even default bodies to temp-file exec of the named shell.

Source Files ¶

View all Source files

executor.go

Directories ¶

Path	Synopsis
agent Package agent runs (agent) task bodies by driving an installed agent CLI (claude/codex/copilot/…) behind a vendor-neutral Provider interface (Principle VII / FR-030).	Package agent runs (agent) task bodies by driving an installed agent CLI (claude/codex/copilot/…) behind a vendor-neutral Provider interface (Principle VII / FR-030).
interp Package interp runs python/node/custom (and `set shell`-override) task bodies by writing the interpolated body to a temp file and exec-ing the configured interpreter against it (the just shebang/[script] model).	Package interp runs python/node/custom (and `set shell`-override) task bodies by writing the interpolated body to a temp file and exec-ing the configured interpreter against it (the just shebang/[script] model).
scheduler Package scheduler builds and runs the task dependency DAG.	Package scheduler builds and runs the task dependency DAG.
shell Package shell runs (sh) task bodies through the pure-Go mvdan/sh interpreter.	Package shell runs (sh) task bodies through the pure-Go mvdan/sh interpreter.

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL