2019-04-25 13:06:53 -04:00
cli
===
[![GoDoc ](https://godoc.org/github.com/urfave/cli?status.svg )](https://godoc.org/github.com/urfave/cli)
[![codebeat ](https://codebeat.co/badges/0a8f30aa-f975-404b-b878-5fab3ae1cc5f )](https://codebeat.co/projects/github-com-urfave-cli)
[![Go Report Card ](https://goreportcard.com/badge/urfave/cli )](https://goreportcard.com/report/urfave/cli)
2020-01-03 23:45:36 -05:00
[![codecov ](https://codecov.io/gh/urfave/cli/branch/master/graph/badge.svg )](https://codecov.io/gh/urfave/cli)
2019-04-25 13:06:53 -04:00
cli is a simple, fast, and fun package for building command line apps in Go. The
goal is to enable developers to write fast and distributable command line
applications in an expressive way.
2020-01-03 23:45:36 -05:00
## Usage Documentation
2019-04-25 13:06:53 -04:00
2020-01-04 12:44:25 -05:00
Usage documentation exists for each major version. Don't know what version you're on? You're probably using the version from the `master` branch, which is currently `v2` .
2019-04-25 13:06:53 -04:00
2020-01-04 12:44:25 -05:00
- `v2` - [./docs/v2/manual.md ](./docs/v2/manual.md )
2020-01-03 23:45:36 -05:00
- `v1` - [./docs/v1/manual.md ](./docs/v1/manual.md )
2019-04-25 13:06:53 -04:00
2020-11-09 10:25:54 -05:00
Guides for migrating to newer versions:
- `v1-to-v2` - [./docs/migrate-v1-to-v2.md ](./docs/migrate-v1-to-v2.md )
2019-04-25 13:06:53 -04:00
## Installation
2020-11-09 10:25:54 -05:00
Using this package requires a working Go environment. [See the install instructions for Go ](http://golang.org/doc/install.html ).
2019-04-25 13:06:53 -04:00
2020-11-09 10:25:54 -05:00
Go Modules are required when using this package. [See the go blog guide on using Go Modules ](https://blog.golang.org/using-go-modules ).
2019-04-25 13:06:53 -04:00
2020-01-04 12:44:25 -05:00
### Using `v2` releases
2019-04-25 13:06:53 -04:00
```
2020-01-04 12:44:25 -05:00
$ GO111MODULE=on go get github.com/urfave/cli/v2
2019-04-25 13:06:53 -04:00
```
2020-01-03 23:45:36 -05:00
```go
2019-04-25 13:06:53 -04:00
...
import (
2020-01-04 12:44:25 -05:00
"github.com/urfave/cli/v2" // imports as package "cli"
2019-04-25 13:06:53 -04:00
)
...
```
2020-01-04 12:44:25 -05:00
### Using `v1` releases
2019-04-25 13:06:53 -04:00
```
2020-01-04 12:44:25 -05:00
$ GO111MODULE=on go get github.com/urfave/cli
2019-04-25 13:06:53 -04:00
```
2020-01-03 23:45:36 -05:00
```go
2019-04-25 13:06:53 -04:00
...
import (
2020-01-04 12:44:25 -05:00
"github.com/urfave/cli"
2019-04-25 13:06:53 -04:00
)
...
```
2020-01-04 12:44:25 -05:00
### GOPATH
Make sure your `PATH` includes the `$GOPATH/bin` directory so your commands can
be easily used:
```
export PATH=$PATH:$GOPATH/bin
```
### Supported platforms
cli is tested against multiple versions of Go on Linux, and against the latest
released version of Go on OS X and Windows. This project uses Github Actions for
2020-11-09 10:25:54 -05:00
builds. To see our currently supported go versions and platforms, look at the [./.github/workflows/cli.yml ](https://github.com/urfave/cli/blob/master/.github/workflows/cli.yml ).