k3s/vendor/github.com/urfave/cli/README.md

71 lines
1.9 KiB
Markdown
Raw Normal View History

2019-01-12 04:58:27 +00:00
cli
===
[![Build Status](https://travis-ci.org/urfave/cli.svg?branch=master)](https://travis-ci.org/urfave/cli)
[![Windows Build Status](https://ci.appveyor.com/api/projects/status/rtgk5xufi932pb2v?svg=true)](https://ci.appveyor.com/project/urfave/cli)
2019-12-12 01:27:03 +00:00
2019-01-12 04:58:27 +00:00
[![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)
2019-12-12 01:27:03 +00:00
[![codecov](https://codecov.io/gh/urfave/cli/branch/master/graph/badge.svg)](https://codecov.io/gh/urfave/cli)
2019-01-12 04:58:27 +00: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.
2019-12-12 01:27:03 +00:00
## Usage Documentation
2019-01-12 04:58:27 +00:00
2019-12-12 01:27:03 +00:00
Usage documentation exists for each major version
2019-01-12 04:58:27 +00:00
2019-12-12 01:27:03 +00:00
- `v1` - [./docs/v1/manual.md](./docs/v1/manual.md)
- `v2` - 🚧 documentation for `v2` is WIP 🚧
2019-01-12 04:58:27 +00:00
## Installation
2019-12-12 01:27:03 +00:00
Make sure you have a working Go environment. Go version 1.10+ is supported. [See
2019-01-12 04:58:27 +00:00
the install instructions for Go](http://golang.org/doc/install.html).
2019-12-12 01:27:03 +00:00
### GOPATH
2019-01-12 04:58:27 +00:00
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. For full details, see
[`./.travis.yml`](./.travis.yml) and [`./appveyor.yml`](./appveyor.yml).
2019-12-12 01:27:03 +00:00
### Using `v1` releases
2019-01-12 04:58:27 +00:00
```
2019-12-12 01:27:03 +00:00
$ go get github.com/urfave/cli
2019-01-12 04:58:27 +00:00
```
2019-12-12 01:27:03 +00:00
```go
2019-01-12 04:58:27 +00:00
...
import (
2019-12-12 01:27:03 +00:00
"github.com/urfave/cli"
2019-01-12 04:58:27 +00:00
)
...
```
2019-12-12 01:27:03 +00:00
### Using `v2` releases
2019-01-12 04:58:27 +00:00
2019-12-12 01:27:03 +00:00
**Warning**: `v2` is in a pre-release state.
2019-01-12 04:58:27 +00:00
```
2019-12-12 01:27:03 +00:00
$ go get github.com/urfave/cli.v2
2019-01-12 04:58:27 +00:00
```
2019-12-12 01:27:03 +00:00
```go
2019-01-12 04:58:27 +00:00
...
import (
2019-12-12 01:27:03 +00:00
"github.com/urfave/cli.v2" // imports as package "cli"
2019-01-12 04:58:27 +00:00
)
...
```