commander

Sep 13, 2025

Changes in this version

type Process

+ PID func() int

Sep 7, 2025

Changes in this version

+ var ErrCommandFailed = errors.New("command failed")

+ var ErrExpectedCommandNotCalled = errors.New("expected command not called")

+ var ErrPipeCreationFailed = errors.New("pipe creation failed")

+ var ErrProcessStartFailed = errors.New("process start failed")

+ var ErrProcessWaitFailed = errors.New("process wait failed")

+ var ErrUnexpectedCommand = errors.New("unexpected command")

+ type AnyMatcher struct

+ func (m *AnyMatcher) Matches(_ string) bool

+ func (m *AnyMatcher) String() string

+ type ArgumentMatcher interface

+ Matches func(arg string) bool

+ String func() string

+ func Any() ArgumentMatcher

+ func Exact(s string) ArgumentMatcher

+ func Regex(pattern string) ArgumentMatcher

+ type Commander interface

+ CombinedOutput func(ctx context.Context, name string, args []string, opts ...Option) (output []byte, err error)

+ Output func(ctx context.Context, name string, args []string, opts ...Option) (stdout []byte, stderr []byte, err error)

+ Run func(ctx context.Context, name string, args []string, opts ...Option) error

+ Start func(ctx context.Context, name string, args []string, opts ...Option) (Process, error)

+ func New() Commander

+ type ExactMatcher struct

+ func (m *ExactMatcher) Matches(arg string) bool

+ func (m *ExactMatcher) String() string

+ type Expectation struct

+ Args []string

+ Called bool

+ Error error

+ Matchers []ArgumentMatcher

+ Name string

+ Output []byte

+ func (e *Expectation) ReturnError(err error) *Expectation

+ func (e *Expectation) ReturnOutput(output []byte) *Expectation

+ type MockCommander struct

+ func NewMock() *MockCommander

+ func (m *MockCommander) CallOrder() []string

+ func (m *MockCommander) CombinedOutput(_ context.Context, name string, args []string, _ ...Option) ([]byte, error)

+ func (m *MockCommander) Expect(name string, args ...string) *Expectation

+ func (m *MockCommander) ExpectWithMatchers(name string, matchers ...ArgumentMatcher) *Expectation

+ func (m *MockCommander) Output(_ context.Context, name string, args []string, _ ...Option) ([]byte, []byte, error)

+ func (m *MockCommander) Reset()

+ func (m *MockCommander) Run(_ context.Context, name string, args []string, _ ...Option) error

+ func (m *MockCommander) Start(_ context.Context, name string, args []string, _ ...Option) (Process, error)

+ func (m *MockCommander) VerifyExpectations() error

+ type Option func(*Options)

+ func WithDir(dir string) Option

+ func WithEnv(env []string) Option

+ func WithStdin(stdin io.Reader) Option

+ func WithTimeout(timeout time.Duration) Option

+ type Options struct

+ Dir string

+ Env []string

+ Stdin io.Reader

+ Timeout *time.Duration

+ type Process interface

+ Kill func(ctx context.Context) error

+ Start func() error

+ StdinPipe func() (io.WriteCloser, error)

+ Stop func(ctx context.Context, timeout time.Duration) error

+ Stream func(stdout, stderr chan<- string)

+ Wait func() error

+ type RegexMatcher struct

+ func (m *RegexMatcher) Matches(arg string) bool

+ func (m *RegexMatcher) String() string