go-imp

module
v0.8.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 27, 2026 License: Apache-2.0

README

imp

CI

imp is meta-testing for Go: it tests whether your tests catch broken behavior. It introduces small, realistic faults into your code and reports which ones your suite misses. Find weak assertions, missing edge cases, and hard-to-test code—and keep coding agents focused on correctness, not just green checkmarks.

Coverage tells you which code ran. imp helps you find out whether your tests would notice if it were wrong.

Install

Install the latest release with:

go install github.com/smedijan/go-imp/cmd/imp@latest

Then run it from a Go module:

imp run

Use grouped JSON for agents and scripts, with optional status filtering:

imp run --json --statuses lived,not-covered --output findings.json

Omit --output to write the selected format to stdout. Counts and quality gates always describe the whole run, even when findings are filtered.

See the installation guide for mise and Go options. Then follow the quick start or read the FAQ.

Documentation

The website has installation, usage, and configuration guides.

Documentation tracks the latest imp; there are no versioned docs. The site uses Zensical, with the existing docs/mkdocs.yml configuration format. The tasks resolve the latest available Zensical release:

mise run docs-serve  # Live preview at http://127.0.0.1:8000
mise run docs-build  # Strict production build

License

The source code is licensed under Apache-2.0. Documentation by the imp authors is licensed under CC BY-SA 4.0.


imp is an independent continuation of go-gremlins/gremlins, helping developers and coding agents build Go test suites that catch behavioral regressions.

Directories

Path Synopsis
cmd
Package cmd implements the imp command-line interface.
Package cmd implements the imp command-line interface.
imp command
imp is a mutation testing tool for Go.
imp is a mutation testing tool for Go.
internal/flags
Package flags provides common command-line flag definitions for imp commands.
Package flags provides common command-line flag definitions for imp commands.
internal
configuration
Package configuration manages application settings from flags, config files, and environment variables.
Package configuration manages application settings from flags, config files, and environment variables.
coverage
Package coverage analyzes Go test coverage to identify which code is tested.
Package coverage analyzes Go test coverage to identify which code is tested.
diff
Package diff parses git diff output to identify changed lines for incremental mutation testing.
Package diff parses git diff output to identify changed lines for incremental mutation testing.
engine
Package engine orchestrates mutation testing by discovering, applying, and testing mutations.
Package engine orchestrates mutation testing by discovering, applying, and testing mutations.
engine/workdir
Package workdir manages temporary working directories for isolated mutation testing.
Package workdir manages temporary working directories for isolated mutation testing.
engine/workerpool
Package workerpool provides a worker pool for concurrent mutation testing execution.
Package workerpool provides a worker pool for concurrent mutation testing execution.
exclusion
Package exclusion provides file exclusion rules based on regex patterns.
Package exclusion provides file exclusion rules based on regex patterns.
execution
Package execution provides error types and status codes for command execution.
Package execution provides error types and status codes for command execution.
gomodule
Package gomodule detects and provides information about Go modules.
Package gomodule detects and provides information about Go modules.
log
Package log writes diagnostics to stderr, separate from report data.
Package log writes diagnostics to stderr, separate from report data.
mutator
Package mutator provides mutation types, statuses, and interfaces for mutation testing.
Package mutator provides mutation types, statuses, and interfaces for mutation testing.
report
Package report renders mutation results for humans and automation.
Package report renders mutation results for humans and automation.
report/internal
Package internal provides the versioned JSON report schema.
Package internal provides the versioned JSON report schema.
report/output
Package output publishes reports to streams or atomically replaced files.
Package output publishes reports to streams or atomically replaced files.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL