A collection of custom Go development and testing tools to improve productivity, code quality, and testing insights.
This repository provides a centralized Makefile and .golangci.yml configuration. The Makefile orchestrates fetching the latest configurations, installing necessary tools, formatting code, running tests, checking coverage diffs, and executing mutation testing.
A utility to compare test coverage between your current branch and a base branch (or commit) and report any regressions or uncovered new code. It generates and parses base coverage on the fly and compares it against your local coverage profile to ensure new code meets testing standards.
Usage:
cover-diff -coverprofile <path-to-coverage.out> [-base <branch-or-commit>]A post-processor for gomutants HTML reports that adds ignore filtering, dynamic line shifting, and self-healing ignore files.
It parses the HTML report generated by gomutants, synchronizes ignored mutations defined in .gomutants-ignore across Git history, marks matching surviving mutants as Ignored, and configures the report viewer to show only surviving mutants by default.
Advanced Features:
- Intelligent Shifting: You can manually add a mutant to the
.gomutants-ignorefile. As you add, remove, or rename files and lines of code in your repository, the tool uses Git diffs to automatically update file paths and shift line numbers so ignored mutations stay synced with the codebase. - Self-Healing: During each run, the tool filters
.gomutants-ignoreagainst the current surviving mutations. If your test suite improves and kills a previously ignored mutation (or the mutated code is removed), the tool automatically removes that entry from.gomutants-ignore.
Ignore File Format:
The tool expects a .gomutants-ignore file in the root of your project:
# format: path:line:column:mutatorName
internal/coverage/coverage.go:69:10:BRANCH_IF
internal/git/client.go:49:48:INTEGER_DECREMENT
Usage:
gomutants-ignore [-htmlreport <path-to-mutation-report.html>]To use these tools and configurations in a new repository, you only need to copy the Makefile over. The Makefile will handle downloading the latest configurations and installing the required CLI tools.
-
Download the
Makefileto your project root:curl -sSfL https://raw.githubusercontent.com/danrneal/go-tools/main/Makefile -o Makefile
-
Run the complete pipeline to install tools, fetch configs, and run all checks:
make all
-
For faster development cycles (skipping tool updates and full mutation testing), use:
make fast
go-tools is licensed under the MIT License.