Gocov HTML export

This is a simple helper tool for generating HTML output from axw/gocov

Here is a screenshot:

Installation

Binaries for most amd64 systems are built for every release. Please just grab a binary version of the latest release.

However you can build it from source. Please note that building from source requires Go 1.11+.

Just type the following to install the program and its dependencies:

$ go install github.com/axw/gocov/gocov@latest
$ go install github.com/matm/gocov-html/cmd/gocov-html@latest

Features Matrix

Feature	CLI Flag	Version
Use custom CSS file	`-s <filename>`	`1.0.0`
Show program version	`-v`	`1.1.1`
Write CSS of default theme to stdout	`-d`	`1.2.0`
Embbed custom CSS into final HTML document	-	`1.2.0`
List available themes	`-lt`	`1.2.0`
Render with a specific theme	`-t <theme>`	`1.2.0`

Usage

$ gocov-html -h
Usage of ./gocov-html:
  -d    output CSS of default theme
  -lt
        list available themes
  -s string
        path to custom CSS file
  -t string
        theme to use for rendering (default "golang")
  -v    show program version

gocov-html can read a JSON file or read from standard input:

$ gocov test strings | gocov-html > strings.html
ok      strings 0.700s  coverage: 98.1% of statements

Several packages can be tested at once and added to a single report. Let's test the fmt, math and io packages:

$ gocov test fmt math io | gocov-html > report.html
ok      fmt     0.045s  coverage: 95.2% of statements
ok      math    0.006s  coverage: 83.6% of statements
ok      io      0.024s  coverage: 88.2% of statements

In this case, the generated report will have an overview section with stats per package along with the global coverage percentage. This section may be rendered depending on the theme used. The golang (default) theme displays it.

The generated HTML content comes along with a default embedded CSS. However a custom stylesheet can be used with the -s flag:

$ gocov test net/http | gocov-html -s mystyle.css > http.html

As of version 1.2,

A -d flag is available to write the defaut stylesheet to the standard output. This is provided for convenience and easy editing:
```
$ gocov-html -d > newstyle.css
... edit newstyle.css ...
$ gocov test strings | gocov-html -s newstyle.css > http.html
```
The content of the stylesheet given to -s is embedded into the final HTML document
Theming capabilities are available (to go further than just using a CSS file) through the use of Go templates.
- Use the -lt flag to list available themes:
```
$ gocov-html -lt
golang     -- original golang theme (default)
```
- Generate a report using a specific theme with -t:
```
$ gocov test io | gocov-html -t golang > io.html
```

MdSahilGrab/gocov-html

Gocov HTML export

Installation

Features Matrix

Usage