internal

type CommandObserver ¶ added in v2.15.0

type CommandObserver interface {
	CommandStarted(redactedArgs string, startTime time.Time)
	CommandCompleted(redactedArgs string, elapsed time.Duration, exitCode int)
}

CommandObserver receives a redacted joined-args identity, never raw args.

func RegisteredObserver() CommandObserver

type CompletionReporter ¶ added in v2.15.0

type CompletionReporter interface {
	ReportCompletion(cmd *exec.Cmd, elapsed time.Duration, exitCode int)
}

type ObservingReporter ¶ added in v2.15.0

type ObservingReporter struct {
	// contains filtered or unexported fields
}

ObservingReporter is the only type that touches the observer; it redacts the args before forwarding, keeping redaction inside the reporter.

func NewObservingReporter(observer CommandObserver, redactor Redactor) *ObservingReporter

func (r *ObservingReporter) Report(startTime time.Time, cmd *exec.Cmd)

func (r *ObservingReporter) ReportCompletion(cmd *exec.Cmd, elapsed time.Duration, exitCode int)

type RedactingReporter ¶

type RedactingReporter struct {
	// contains filtered or unexported fields
}

func NewRedactingReporter(writer io.Writer, redactor Redactor) *RedactingReporter

func (r *RedactingReporter) Redactor() Redactor

func (r *RedactingReporter) Report(startTime time.Time, cmd *exec.Cmd)

type Redactor ¶

type Redactor interface {
	Redact(toRedact string) string
}

func NewRedactor(redactees ...string) Redactor

type Reporter ¶

type Reporter interface {
	Report(time.Time, *exec.Cmd)
}

func ObservedReporter(base Reporter) Reporter

type Starter ¶

type Starter interface {
	Start(Reporter, string, ...string) (*gexec.Session, error)
}

type TeeReporter ¶ added in v2.15.0

type TeeReporter struct {
	// contains filtered or unexported fields
}

TeeReporter fans Report to every reporter; ReportCompletion reaches only those that also implement CompletionReporter.

func NewTeeReporter(reporters ...Reporter) *TeeReporter

func (t *TeeReporter) Report(startTime time.Time, cmd *exec.Cmd)

func (t *TeeReporter) ReportCompletion(cmd *exec.Cmd, elapsed time.Duration, exitCode int)