README
¶
cmd package
A simple package to execute shell commands on linux, darwin and windows.
Installation
$ go get -u github.com/SimonBaeumer/cmd@v1.0.0
Usage
c := cmd.NewCommand("echo hello")
err := c.Execute()
if err != nil {
panic(err.Error())
}
fmt.Println(c.Stdout())
fmt.Println(c.Stderr())
Configure the command
To configure the command a option function will be passed which receives the command object as an argument passed by reference.
Default option functions:
cmd.WithStandardStreamscmd.WithCustomStdout(...io.Writers)cmd.WithCustomStderr(...io.Writers)cmd.WithTimeout(time.Duration)cmd.WithoutTimeoutcmd.WithWorkingDir(string)cmd.WithEnvironmentVariables(cmd.EnvVars)cmd.WithInheritedEnvironment(cmd.EnvVars)
Example
c := cmd.NewCommand("echo hello", cmd.WithStandardStreams)
c.Execute()
Set custom options
setWorkingDir := func (c *Command) {
c.WorkingDir = "/tmp/test"
}
c := cmd.NewCommand("pwd", setWorkingDir)
c.Execute()
Testing
You can catch output streams to stdout and stderr with cmd.CaptureStandardOut.
// caputred is the captured output from all executed source code
// fnResult contains the result of the executed function
captured, fnResult := cmd.CaptureStandardOut(func() interface{} {
c := NewCommand("echo hello", cmd.WithStandardStream)
err := c.Execute()
return err
})
// prints "hello"
fmt.Println(captured)
Development
Running tests
make test
ToDo
- os.Stdout and os.Stderr output access after execution via
c.Stdout()andc.Stderr()
Documentation
¶
Index ¶
- func CaptureStandardOutput(f func() interface{}) (string, interface{})
- func WithCustomStderr(writers ...io.Writer) func(c *Command)
- func WithCustomStdout(writers ...io.Writer) func(c *Command)
- func WithEnvironmentVariables(env EnvVars) func(c *Command)
- func WithInheritedEnvironment(env EnvVars) func(c *Command)
- func WithStandardStreams(c *Command)
- func WithTimeout(t time.Duration) func(c *Command)
- func WithWorkingDir(dir string) func(c *Command)
- func WithoutTimeout(c *Command)
- type Command
- type EnvVars
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CaptureStandardOutput ¶ added in v1.2.0
func CaptureStandardOutput(f func() interface{}) (string, interface{})
CaptureStandardOutput allows to capture the output which will be written to os.Stdout and os.Stderr. It returns the captured output and the return value of the called function
func WithCustomStderr ¶ added in v1.2.0
WithCustomStderr allows to add custom writers to stderr
func WithCustomStdout ¶ added in v1.2.0
WithCustomStdout allows to add custom writers to stdout
func WithEnvironmentVariables ¶ added in v1.2.0
WithEnvironmentVariables sets environment variables for the executed command
func WithInheritedEnvironment ¶ added in v1.2.0
WithInheritedEnvironment uses the env from the current process and allow to add more variables.
func WithStandardStreams ¶
func WithStandardStreams(c *Command)
WithStandardStreams is used as an option by the NewCommand constructor function and writes the output streams to stderr and stdout of the operating system
Example:
c := cmd.NewCommand("echo hello", cmd.WithStandardStreams)
c.Execute()
func WithTimeout ¶ added in v1.1.0
WithTimeout sets the timeout of the command
Example:
cmd.NewCommand("sleep 10;", cmd.WithTimeout(500))
func WithWorkingDir ¶ added in v1.1.0
WithWorkingDir sets the current working directory
func WithoutTimeout ¶ added in v1.1.0
func WithoutTimeout(c *Command)
WithoutTimeout disables the timeout for the command
Types ¶
type Command ¶
type Command struct {
Command string
Env []string
Dir string
Timeout time.Duration
StderrWriter io.Writer
StdoutWriter io.Writer
WorkingDir string
// contains filtered or unexported fields
}
Command represents a single command which can be executed
func NewCommand ¶
NewCommand creates a new command You can add option with variadic option argument Default timeout is set to 30 minutes
Example:
c := cmd.NewCommand("echo hello", function (c *Command) {
c.WorkingDir = "/tmp"
})
c.Execute()
or you can use existing options functions
c := cmd.NewCommand("echo hello", cmd.WithStandardStreams)
c.Execute()
func (*Command) AddEnv ¶
AddEnv adds an environment variable to the command If a variable gets passed like ${VAR_NAME} the env variable will be read out by the current shell
func (*Command) Combined ¶ added in v1.2.0
Combined returns the combined output of stderr and stdout according to their timeline
func (*Command) Execute ¶
Execute executes the command and writes the results into it's own instance The results can be received with the Stdout(), Stderr() and ExitCode() methods
Source Files
Directories