themes

Documentation

Index

• Constants
• func HTMLReportCoverage(r io.Reader, opts ReportOptions) error
• func Use(name string) error
• type Beautifier
  • func Current() Beautifier
  • func Get(name string) Beautifier
  • func List() []Beautifier
• type ReportOptions
• type StaticAssets

Constants

const ProjectURL = "https://github.com/matm/gocov-html"

ProjectURL is the project's site on GitHub.

Functions

func HTMLReportCoverage

func HTMLReportCoverage(r io.Reader, opts ReportOptions) error

HTMLReportCoverage outputs an HTML report on stdout by parsing JSON data generated by axw/gocov. The css parameter is an absolute path to a custom stylesheet. Use an empty string to use the default stylesheet available.

func Use

func Use(name string) error

Use takes the name of the theme that will be used for rendering. Returns an error for an unknown theme.

Types

type Beautifier

type Beautifier interface {
	// Name is the name of the theme.
	Name() string
	// Description is a single line comment about the theme.
	Description() string
	Assets() StaticAssets
	// Template is the structure of the page that will be rendered.
	// This code is generated by pkg/theme/generator.go.
	Template() *template.Template
	// Data is the content used by the template.
	// This code is generated by pkg/theme/generator.go.
	Data() *templateData
}

Beautifier defines a theme used for rendering the HTML coverage stats.

func Current

func Current() Beautifier

Current returns the theme to use for rendering HTML.

func Get

func Get(name string) Beautifier

Get a theme by name. Returns nil if none found.

func List

func List() []Beautifier

List returns all available themes.

type ReportOptions

type ReportOptions struct {
	// LowCoverageOnTop puts low coverage functions first.
	LowCoverageOnTop bool
	// Stylesheet is the path to a custom CSS file.
	Stylesheet string
	// CoverageMin filters out all functions whose code coverage is smaller than it is.
	CoverageMin uint8
	// CoverageMax filters out all functions whose code coverage is greater than it is.
	CoverageMax uint8
}

ReportOptions holds various options used when generating the final HTML report.

type StaticAssets

type StaticAssets struct {
	Stylesheets []string
	Scripts     []string
	Index       string
}

StaticAssets sets all assets required for a theme.