zexec

Documentation

Overview

Package zexec runs external commands.

Index

• func Readlines(cmd *exec.Cmd) (<-chan Output, error)
• type Output
  • func (o Output) String() string

Functions

func Readlines

func Readlines(cmd *exec.Cmd) (<-chan Output, error)

Readlines calls cmd.Start sends every line of output on the returned channel.

Example usage:

cmd := exec.Command("long-running-process")
ch, err := zexec.Readlines(cmd)

for {
	line, ok := <-ch
	if !ok {
		break
	}
	if line.Error != nil {
		fmt.Fprintln(os.Stderr, "error reading:", line.Error)
		break
	}

	fmt.Println(line)
}

Types

type Output

type Output struct {
	Text   string // Read text, excluding the end delimiter.
	Stderr bool   // Text was sent on stderr.

	// Errors reading the process stdout/stderr; sent only once, and will stop
	// reading after an error.
	Error error
}

func (Output) String

func (o Output) String() string