Skip to content

Convert junit.xml into gorgeous HTML reports

License

Notifications You must be signed in to change notification settings

kitproj/junit2html

Repository files navigation

junit2html

Convert Junit XML reports (junit.xml) into HTML reports using a single standalone binary.

  • Standalone binary.
  • Failed tests are top, that's what's important.
  • No JavaScript.
  • Look gorgeous.

Screenshot

screenshot

Install

Like jq, junit2html is a tiny (8Mb) standalone binary. You can download it from the releases page.

If you're on MacOS, you can use brew:

brew tap kitproj/junit2html --custom-remote https://github.com/kitproj/junit2html
brew install junit2html

Otherwise, you can use curl:

curl -q https://raw.githubusercontent.com/kitproj/junit2html/main/install.sh | sh

Usage

Here is an example that uses trap to always created the test report:

go install github.com/alexec/junit2html@latest

trap 'go-junit-report < test.out > junit.xml && junit2html < junit.xml > test-report.html' EXIT

go test -v -cover ./... 2>&1 > test.out

💡 Don't use pipes (i.e. |) in shell, pipes swallow exit codes. Use < and > which is POSIX compliant.

Test

How to test this locally:

go test -v -cover ./... 2>&1 > test.out
go-junit-report < test.out > junit.xml 
go run . < junit.xml > test-report.html