# simplecov-ruby/simplecov

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/simplecov-ruby-simplecov).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

4,925 stars · 583 forks · Ruby · MIT

## Links

- GitHub: https://github.com/simplecov-ruby/simplecov
- awesome-repositories: https://awesome-repositories.com/repository/simplecov-ruby-simplecov.md

## Topics

`code-quality` `coverage` `coverage-library` `coverage-report` `rails` `ruby` `test-coverage`

## Description

SimpleCov is a code coverage library for Ruby. It tracks which lines, branches, and methods of Ruby code run during a test suite and reports how thoroughly the tests exercise the codebase. Behavior is declared in a start block or a project-level config file, where you set filters, groups, profiles, and per-criterion limits.

Beyond measurement, it works as a CI gate. It can fail a build when coverage drops below minimums, falls against a baseline, or leaves changed lines in a git diff untested. Per-file floors can be checked in and only ratchet upward, and uncovered lines can be emitted as inline annotations for GitHub, GitLab, Azure, TeamCity, Buildkite, or reviewdog. It also merges results from separate suites, parallel test workers, and subprocesses into one unified result, with a locked shared cache so concurrent runs don't overwrite each other.

Other capabilities build on recorded coverage. Per-test attribution maps each line to the tests that executed it, which supports selecting only the tests affected by a change and finding redundant tests. Low-overhead first-execution tracking can be run in live processes and compared against test coverage to find dead code and production code that lacks tests. Reports come as browsable HTML, JSON, lcov, Cobertura XML, Markdown, terminal tables, and badges. A command-line tool covers running tests with coverage, watching files, serving reports, and inspecting results. Branch, method, and eval coverage are unavailable on JRuby, where enforcement is limited to line coverage.

## Tags

### Testing & Quality Assurance

- [Code Coverage Analysis](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-analysis.md) — Measures which lines, branches, and methods of Ruby and Rails application code run during a test suite and reports the results readably. ([source](https://github.com/simplecov-ruby/simplecov/tree/main/test_projects))
- [Ruby Coverage API Integrations](https://awesome-repositories.com/f/testing-quality-assurance/ruby-coverage-api-integrations.md) — Hooks into Ruby's native coverage facility to track which lines, branches, and methods run during a test suite and reports test thoroughness.
- [Coverage Threshold Validation](https://awesome-repositories.com/f/testing-quality-assurance/automated-test-suites/coverage-threshold-validation.md) — Declares minimum, maximum, exact, per-file, per-group, and maximum-drop limits for line, branch, or method coverage that fail the run when violated. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/CHANGELOG.md))
- [Quality Gates](https://awesome-repositories.com/f/testing-quality-assurance/ci-integration-testing/quality-gates.md) — Fails builds and pull requests when coverage falls below minimums, regresses against a baseline, or leaves changed lines untested.
- [Changed-Line Coverage Gates](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-analysis/coverage-diff-analysis/changed-line-coverage-gates.md) — Computes line, branch, and method coverage for only the lines a diff touched and fails below a minimum, gating each change. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/CHANGELOG.md))
- [Coverage Result Merging](https://awesome-repositories.com/f/testing-quality-assurance/coverage-result-merging.md) — Merges coverage from separate suites, parallel workers and subprocesses by summing line and branch hits into one unified result.
- [Coverage Settings Configuration](https://awesome-repositories.com/f/testing-quality-assurance/coverage-settings-configuration.md) — Defines thresholds, groups, filters, and tracked criteria in a start block or config file, with minimums, maximum drops, and per-file limits. ([source](https://github.com/simplecov-ruby/simplecov#readme))
- [Runtime Coverage Instrumentation](https://awesome-repositories.com/f/testing-quality-assurance/runtime-coverage-instrumentation.md) — Hooks into the Ruby runtime's native coverage facility to count line, branch, method and first-execution hits without rewriting source files.
- [Code Coverage Reportings](https://awesome-repositories.com/f/testing-quality-assurance/software-testing/test-execution-orchestration/code-coverage-reportings.md) — Tracks which lines, branches and methods of Ruby code execute during tests and reports how thoroughly the suite exercises the codebase.
- [Unit Testing and Code Coverage](https://awesome-repositories.com/f/testing-quality-assurance/unit-testing-and-code-coverage.md) — Tracks which lines and branches of Ruby code run during a test suite and reports how thoroughly the tests exercise the codebase. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/simplecov.gemspec))
- [CI Coverage Annotations](https://awesome-repositories.com/f/testing-quality-assurance/ci-coverage-annotations.md) — Emits uncovered-line findings as native inline annotations for GitHub, GitLab, Azure, TeamCity, Buildkite and reviewdog. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/CHANGELOG.md))
- [Changed-Line Coverage Measurements](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-analysis/changed-line-coverage-measurements.md) — Measures coverage only on lines touched in a git diff against a base ref and can require every added line to be tested. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/README.md))
- [Coverage Diff Analysis](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-analysis/coverage-diff-analysis.md) — Scores only lines touched in a diff against a base reference and fails the build when new code falls below a chosen minimum. ([source](https://github.com/simplecov-ruby/simplecov#readme))
- [Coverage Exclusion Directives](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-analysis/coverage-exclusion-directives.md) — Disable line, branch, or method coverage for a span of code by placing enable and disable comments around it. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/docs/Configuration.md))
- [Coverage Exclusions](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-analysis/coverage-exclusions.md) — Excludes marked code regions from line, branch, or method coverage using enable and disable comments, including within measured view templates. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/CHANGELOG.md))
- [Dead Code Detection](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-analysis/dead-code-detection.md) — Crosses production coverage with test coverage to list code run by neither, code only tests exercise, and production code lacking tests. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/docs/CLI.md))
- [Per-File Coverage Floors](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-analysis/per-file-coverage-floors.md) — Writes a checked-in baseline giving each file its own minimum at current coverage, tightening over time so coverage cannot slide back. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/README.md))
- [Per-Test Coverage Recording](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-analysis/per-test-coverage-recording.md) — Records which lines each individual test executed in one instrumented run and saves the mapping to a coverage file. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/docs/Redundant_Tests.md))
- [Code Coverage Collection](https://awesome-repositories.com/f/testing-quality-assurance/code-coverage-collection.md) — Lets users tailor how coverage is collected, filtered, and reported through a start block or project config file. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/simplecov.gemspec))
- [Coverage Report File Filters](https://awesome-repositories.com/f/testing-quality-assurance/coverage-report-file-filters.md) — Narrow the report to chosen paths with positive matchers, drop excluded files first, and list never-loaded files at zero percent. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/docs/Configuration.md))
- [Parallel Runner Coordination](https://awesome-repositories.com/f/testing-quality-assurance/parallel-runner-coordination.md) — Detects which parallel worker finishes last and waits for siblings through pluggable adapters, so concurrent workers stop overwriting each other's results. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/CHANGELOG.md))
- [Parallel Test Coverage Merging](https://awesome-repositories.com/f/testing-quality-assurance/parallel-test-coverage-merging.md) — Recognizes parallel test runners, labels suites by process number and locks the shared cache while merging so concurrent runs cannot corrupt data. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/docs/Troubleshooting.md))
- [Per-File Coverage Floors](https://awesome-repositories.com/f/testing-quality-assurance/per-file-coverage-floors.md) — Records a checked-in file of per-file minimums that only ratchet upward while new files are held to the standard minimum. ([source](https://github.com/simplecov-ruby/simplecov#readme))
- [Per-Test Coverage Attribution](https://awesome-repositories.com/f/testing-quality-assurance/per-test-coverage-attribution.md) — Records which test executed each line into a stored mapping that powers covering-test queries, affected-test selection and redundancy checks.
- [Production Code Usage Tracking](https://awesome-repositories.com/f/testing-quality-assurance/production-code-usage-tracking.md) — Records which lines run in live processes using low-overhead first-execution tracking, with flush interval, sampling, and buffer limits set at startup. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/docs/Production.md))
- [Change-Based Test Selection](https://awesome-repositories.com/f/testing-quality-assurance/software-testing/testing-frameworks/test-frameworks/browser-and-ui-testing/change-based-test-selection.md) — Runs only tests that touch changed code using recorded test-to-line mappings, falling back to the full suite when the mapping cannot be trusted. ([source](https://github.com/simplecov-ruby/simplecov#readme))
- [Terminal Coverage Inspection](https://awesome-repositories.com/f/testing-quality-assurance/terminal-coverage-inspection.md) — Provides a command-line tool to watch files, show annotated source, check report freshness, list worst files and generate badges. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/README.md))
- [Per-Test Coverage Attribution](https://awesome-repositories.com/f/testing-quality-assurance/testing-best-practices-methodologies/quality-assurance-practices/testing-methodologies/test-coverage-metrics/per-test-coverage-attribution.md) — Distinguishes lines executed by tests from load-time lines and lists the covering tests behind each line in the HTML report. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/CHANGELOG.md))

### Data & Databases

- [Coverage Report Formats](https://awesome-repositories.com/f/data-databases/reporting-tools/multi-format-generators/coverage-report-formats.md) — Produces HTML coverage reports with searchable file navigation that stay fast and easy to browse on very large codebases. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/docs/Alternate_Formatters.md))

### Development Tools & Productivity

- [Block-Based Configuration Interfaces](https://awesome-repositories.com/f/development-tools-productivity/block-based-configuration-interfaces.md) — Lets behavior be declared in a start block or project config file with filters, groups, profiles and per-criterion limits.
- [Coverage Command-Line Tools](https://awesome-repositories.com/f/development-tools-productivity/coverage-command-line-tools.md) — Provides a command-line tool to run tests with coverage, watch files, serve reports, and inspect results, with help and a manual page. ([source](https://github.com/simplecov-ruby/simplecov#readme))
- [Pluggable Formatters](https://awesome-repositories.com/f/development-tools-productivity/terminal-output-formatters/pluggable-formatters.md) — Passes collected coverage to interchangeable formatter classes or templates that render HTML, JSON, lcov, Cobertura XML or Markdown output.

### Programming Languages & Runtimes

- [Branch Coverage Tracking](https://awesome-repositories.com/f/programming-languages-runtimes/conditional-branching/branch-coverage-tracking.md) — Tracks whether each conditional branch was taken during tests, with an option to ignore synthetic implicit-else branches. ([source](https://github.com/simplecov-ruby/simplecov/blob/main/docs/Configuration.md))
