Go Package

external

External process runner — exec.Command wrapper with timeout, output capture, error handling

Go Ready SI

Command Execution with Timeout go

result, err := external.Run(ctx, external.Command{
    Name: "go",
    Args: []string{"build", "-o", "bin/sbx", "./cmd/sbx"},
    Dir:  "/workspace/shredbx/projects/sbx/packages/core/go",
},
    external.WithTimeout(60*time.Second),
    external.WithEnv(map[string]string{"CGO_ENABLED": "0"}),
)

if err != nil {
    // Typed error classification
    var exitErr *external.ExitError
    if errors.As(err, &exitErr) {
        log.Printf("exit %d: %s", exitErr.Code, result.Stderr)
    }
    return err
}
log.Printf("built in %s", result.Duration)

About

Provides a structured wrapper around os/exec for running external processes. Captures stdout/stderr separately, enforces timeouts, injects environment variables, and classifies exit codes into typed errors.

Public API

Name	Kind	Signature
Run	func	func Run(ctx context.Context, cmd Command) (*Result, error)
Command	type	type Command struct
Result	type	type Result struct
WithTimeout	func	func WithTimeout(d time.Duration) Option
WithEnv	func	func WithEnv(env map[string]string) Option