Skip to content

getgauge/html-report

Repository files navigation

html-report

Actions Status Contributor Covenant

Features

  • A comprehensive test results report template prepared in a html format providing the overall summary with drill down of the test cases executed and effort spent during the testing for each stage and feature.
  • It provides the details for the defects found during the run.
  • It indicates the tests by color code - failed(red), passed(green) and skipped(grey).
  • The failure can be analyzed with the stacktrace and screenshot(captures unless overwritten not to).
  • The skipped tests can be analyzed with the given reason.
  • Custom Messages allows users to add messages at runtime.

Sample HTML Report documemt

Create New Project preview

Installation

gauge install html-report
  • Installing specific version
gauge install html-report --version 4.3.1

Offline installation

gauge install html-report --file html-report-4.3.1-linux.x86_64.zip

Build from Source

Requirements
Compiling

Download dependencies

go get -t ./...

Compilation


go run build/make.go

For cross-platform compilation

go run build/make.go --all-platforms
Installing

After compilation

go run build/make.go --install

Installing to a CUSTOM_LOCATION

go run build/make.go --install --plugin-prefix CUSTOM_LOCATION

Creating distributable

Note: Run after compiling

go run build/make.go --distro

For distributable across platforms: Windows and Linux for both x86 and x86_64

go run build/make.go --distro --all-platforms

New distribution details need to be updated in the html-report-install.json file in the gauge plugin repository for a new version update.

Configuration

The HTML report plugin can be configured by the properties set in the env/default.properties file in the project.

The configurable properties are:

gauge_reports_dir

  • Specifies the path to the directory where the execution reports will be generated.

  • Should be either relative to the project directory or an absolute path. By default it is set to reports directory in the project

overwrite_reports

  • Set to true if the reports must be overwritten on each execution maintaining only the latest execution report.

  • If set to false then a new report will be generated on each execution in the reports directory in a nested time-stamped directory. By default it is set to true.

GAUGE_HTML_REPORT_THEME_PATH

  • Specifies the path to the custom theme directory.

  • Should be either relative to the project directory or an absolute path. By default, default theme shipped with gauge is used.

gauge_minify_reports

  • Set to true if the generated HTML files needs to be minified. This helps avoid creating huge reports if the project suite is huge.

Report re-generation

If report generation fails due to some reason, we don't have to re-run the tests again.

Gauge now generates a last_run_result file in the .gauge folder under the Project Root. There is also a symlink to the html-report executable available in <gauge_reports_dir>/html-report.

To regenerate the report

  • Navigate to the reports directory
  • move the html-report file to .gauge directory
  • Navigate to the .gauge directory
  • run ./html-report --input=last_run_result --output="/some/path"

Note: The output directory is created. Take care not to overwrite an existing directory. The html-report executable and last_run_result will be generated only if the property save_execution_result is set to true. While regenerating a report, the default theme is used. A custom can be used if --theme flag is specified with the path to the custom theme.

License

This program is licensed under:

Apache License, Version 2.0

Copyright

Copyright 2015 ThoughtWorks, Inc.