Skip to content

trep — Test Report Generator

Go Report Card Go Reference License: MIT CI

trep converts test result files and coverage data into self-contained, searchable HTML reports — no external runtime dependencies. Drop it into any CI pipeline and get a filterable, portable view of your test run in a single file.

Features

  • Self-contained HTML — one .html file, no external scripts, fonts, or stylesheets; attach to a PR, email it, or open locally
  • Multi-format input — JUnit XML, Google Test XML, go test -json, TAP 12/13, LCOV, Go coverprofile, Cobertura, Clover
  • Live search & filter — debounced search across suite and test names; filter by pass / fail / skip / flaky
  • Multi-file merge — combine N result files into one unified report, or keep them separate with --no-merge
  • Delta badges — compare any two runs with --baseline to see pass/fail/coverage changes
  • CI-first design — --fail exits 1 on failures or missed thresholds; --annotate emits GitHub or GitLab inline annotations
  • Auto-detection — extension and content sniffing; no --format flag needed in most cases
  • Shell completions — bash, zsh, fish, and PowerShell via trep completion <shell>

Quick install

Homebrew: 

brew tap trep-dev/homebrew-trep https://github.com/trep-dev/trep
brew install trep

Go install: 

go install github.com/trep-dev/trep/cmd/trep@latest

Scoop (Windows): 

scoop bucket add trep https://github.com/trep-dev/scoop-bucket
scoop install trep

See the Installation guide for all options including pre-built binaries.

Quick start

# Test results → HTML report
trep test results.xml

# Coverage → HTML report
trep cov coverage.out

# Both, cross-linked, with thresholds
trep report \
  --tests results.xml \
  --cov coverage.out \
  --threshold 80 --fail-tests --fail-cov

See Commands & Flags and Examples for the full reference.