cliverage/README.md

# cliverage

```yaml
go_package: git.xdrm.io/go/cliverage
author: xdrm-brackets
```

Command-line tool to highlight code coverage in the terminal.

### Requirements

You need a recent system with golang installed.
> It has not been tested under go 1.12.4

### Installation

You need to fetch and install the package with :
```bash
go get git.xdrm.io/go/cliverage
```

It should create the executable `cliverage` into the folder `$GOPATH/bin` (or `$GOBIN` if set).

### Usage

In order for the `cliverage` tool to run successfully, you need :
- a path to your code's repository
- the coverage file path (_see this [documentation](https://godoc.org/golang.org/x/tools/cover)_)


Command usage :
```bash
cliverage -d <code-path> -c <cover-file> [-f <file-path>]
```

Arguments :
- `<code-path>` - path to where your code lives
- `cover-file` - path to the coverage file
- `-f <file-path>` - path to a single file. You can use go package wildcards : `./...` prints every file, `./a/b/...` prints every file located into `./a/b`.