Help us shape the future of Go! Take the 2026 Go Developer Survey

Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

runner

package

Go to main page

Versions in this module

v0

v0.4.5

Oct 16, 2026

Changes in this version

+ const FixedPATH

+ var ErrPipelineUnsupported = errors.New("runner: pipeline execution unsupported")

+ func FixedEnvironment(home, cwd, tmpDir, lookupPath string, assignments []string) ([]string, error)

+ func ResolveOnPath(name, lookupPath string) (string, error)

+ type BoundedExecRunner interface

+ ExecBounded func(ctx context.Context, spec RunSpec, maxCapture int) (RunResult, error)

+ type DirectExecRunner struct

+ func (DirectExecRunner) Exec(ctx context.Context, spec RunSpec) (RunResult, error)

+ func (DirectExecRunner) ExecBounded(ctx context.Context, spec RunSpec, maxCapture int) (RunResult, error)

+ func (DirectExecRunner) NewInvocationID() string

+ func (DirectExecRunner) Pipeline(ctx context.Context, specs []RunSpec, maxCapture int) ([]PipelineResult, error)

+ func (DirectExecRunner) PreflightPipeline(_ context.Context, specs []RunSpec) error

+ type EnvAssignmentError struct

+ Name string

+ func (e *EnvAssignmentError) Error() string

+ type ExecutableNotFoundError struct

+ Name string

+ func (e *ExecutableNotFoundError) Error() string

+ type PipelineResult struct

+ Duration time.Duration

+ ExitCode int

+ InvocationID string

+ LaunchErrCategory fserrors.Category

+ PipelineErrCategory PipelineStageFailure

+ Stderr []byte

+ StderrTotal int64

+ Stdout []byte

+ StdoutTotal int64

+ type PipelineRunner interface

+ Pipeline func(ctx context.Context, specs []RunSpec, maxCapture int) ([]PipelineResult, error)

+ PreflightPipeline func(ctx context.Context, specs []RunSpec) error

+ type PipelineStageFailure string

+ const PipelineFailureCanceled

+ const PipelineFailureCopy

+ const PipelineFailureInternal

+ type RunResult struct

+ Duration time.Duration

+ ExitCode int

+ InvocationID string

+ LaunchErrCategory fserrors.Category

+ Stderr []byte

+ StderrTotal int64

+ Stdout []byte

+ StdoutTotal int64

+ type RunSpec struct

+ Argv []string

+ Assignments []string

+ Cwd string

+ Env []string

+ ExceptionalAuthority string

+ InvocationID string

+ Stdin []byte

+ type Runner interface

+ Exec func(ctx context.Context, spec RunSpec) (RunResult, error)

+ NewInvocationID func() string