Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/commander-cli/cmd
A simple package to execute shell commands on linux, windows and osx
https://github.com/commander-cli/cmd
cmd golang linux osx shell terminal unix windows
Last synced: about 2 months ago
JSON representation
A simple package to execute shell commands on linux, windows and osx
- Host: GitHub
- URL: https://github.com/commander-cli/cmd
- Owner: commander-cli
- License: mit
- Created: 2019-09-27T13:22:06.000Z (about 5 years ago)
- Default Branch: main
- Last Pushed: 2024-01-31T02:43:55.000Z (11 months ago)
- Last Synced: 2024-05-29T00:02:13.164Z (7 months ago)
- Topics: cmd, golang, linux, osx, shell, terminal, unix, windows
- Language: Go
- Homepage:
- Size: 249 KB
- Stars: 149
- Watchers: 7
- Forks: 20
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go-extra - cmd - 09-27T13:22:06Z|2022-07-04T16:19:25Z| (Utilities / Fail injection)
README
[](https://github.com/commander-cli/cmd/actions/workflows/ci.yml)
[](https://godoc.org/github.com/commander-cli/cmd)
[](https://codeclimate.com/github/commander-cli/cmd/test_coverage)
[](https://codeclimate.com/github/commander-cli/cmd/maintainability)
[](https://goreportcard.com/report/github.com/commander-cli/cmd)
# cmd package
A simple package to execute shell commands on linux, darwin and windows.
## Installation
Install the latest version with:
```bash
$ go get -u github.com/commander-cli/cmd
```
or an exact version:
```bash
$ go get -u github.com/commander-cli/[email protected]
```
## Usage
```go
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 an option function can be passed which receives the
command object as an argument passed by reference.
Default option functions:
```
cmd.WithCustomBaseCommand(*exec.Cmd)
cmd.WithStandardStreams
cmd.WithCustomStdout(...io.Writers)
cmd.WithCustomStderr(...io.Writers)
cmd.WithTimeout(time.Duration)
cmd.WithoutTimeout
cmd.WithWorkingDir(string)
cmd.WithEnvironmentVariables(cmd.EnvVars)
cmd.WithInheritedEnvironment(cmd.EnvVars)
```
See [godocs for details][].
#### Example
```go
c := cmd.NewCommand("echo hello", cmd.WithStandardStreams)
c.Execute()
```
#### Set custom options
```go
setWorkingDir := func (c *Command) {
c.WorkingDir = "/tmp/test"
}
c := cmd.NewCommand("pwd", setWorkingDir)
c.Execute()
```
## Contributing
If you would like to contribute please submit a pull request.
For bug fixes/minor changes a simple pull request will
suffice. If the change is large or you would like to have a feature
discussion before implementation feel free to open an issue.
If you have a feature request or bug report please open an issue.
### Development
Please fork the project and do your development there. Please use a
meaningful branch name as well as adhere to [commitlint rules][].
If you would like the precommit hooks run:
```
make init
```
To run the test suite:
```
make test
```
*Reminder:* The goal of this project is to ensure we abstract the OS specific
command execution as mush as possible. Ensure your change is compatible
with linux, windows and osx. If unable to test on every operating system
(help needed for windows (:) the CI will take care of that for you.
[commitlint rules]: https://www.conventionalcommits.org/en/v1.0.0/
[godocs for details]: https://godoc.org/github.com/commander-cli/cmd