Retracted: v0.1.0 published no binaries: its release run failed on macOS and Windows, and the publish job was correctly gated behind that failure. The tag is installable, but the release/release-decision.md inside it describes those two platforms as gated-but-not-yet-observed when the run that observed them had already failed. Retracted so a false platform claim is not selectable. The code itself is sound on linux/amd64. Use v0.1.1.

exec

package

v0.1.0 Latest Latest Go to latest Published: Aug 1, 2026 License: MIT Imports: 7 Imported by: 0

Details

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

Repository

github.com/0xkhdr/specd-cli

Links

Open Source Insights

Documentation ¶

Overview ¶

Package exec is the one place a harness operation turns argv into a process. It never interprets a shell: every element of Argv reaches the child as one literal argument, so a metacharacter is data and can start no sibling command.

Index ¶

Constants
func Command(ctx context.Context, request Request) (*osexec.Cmd, error)
type Request
type Result
- func Run(ctx context.Context, request Request) (Result, error)

Constants ¶

View Source

const (
	DefaultTimeout     = 2 * time.Minute
	MaximumTimeout     = 10 * time.Minute
	DefaultOutputLimit = 32 * 1024
	MaximumOutputLimit = 1024 * 1024

	TimeoutExitCode = 124
)

Variables ¶

This section is empty.

Functions ¶

func Command ¶

func Command(ctx context.Context, request Request) (*osexec.Cmd, error)

Command builds the child process without a shell. It fails closed on empty argv, an embedded NUL, or a non-absolute working directory.

Types ¶

type Request ¶

type Request struct {
	// Dir is the absolute working directory the process runs in.
	Dir string
	// Argv is the executable and its literal arguments. No element is parsed.
	Argv []string
	// Timeout bounds wall-clock time; OutputLimit bounds captured bytes.
	Timeout     time.Duration
	OutputLimit int
}

Request is one bounded direct execution.

type Result ¶

type Result struct {
	ExitCode        int
	TimedOut        bool
	Stdout, Stderr  string
	StdoutTruncated bool
	StderrTruncated bool
}

func Run ¶

func Run(ctx context.Context, request Request) (Result, error)

Run executes bounded argv and returns bounded output. Output past the limit is dropped rather than buffered, so a chatty process cannot exhaust memory.

Source Files ¶

View all Source files

argv.go

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