SimpleCov

Overview

SimpleCov is a Ruby code-coverage tool built on Ruby’s Coverage library. It is best suited to Ruby teams that want to shape reports and enforce coverage thresholds within their test workflow. Its broad reporting and tracking options come with a setup constraint: it must start before application code is required.

Key features

HTML and JSON reports, mergeable results across test suites, and configurable filters, groups, and profiles give teams control over how coverage is organized. Line and branch coverage thresholds can establish a minimum bar, while changed-line coverage can gate patches. That combination is useful for teams tracking overall coverage as well as reviewers focused on newly changed code.

Opt-in test tracking maps lines to the RSpec examples or Minitest tests that cover them, helping developers identify which tests exercise a section of code. Oneshot coverage records production code usage, so teams can identify code untouched by tests or live traffic. These features offer different views of coverage, but SimpleCov remains specific to Ruby rather than a general multi-language tool.

The Rails profile can include ERB, Haml, and Slim templates in reports. CLI commands cover report viewing, test selection, patch coverage, history, status, and badges. Open-source formatter and integration plugins, editor integrations, and hosted commercial services extend the surrounding ecosystem.

SimpleCov must start before application code is required if those files are to be tracked. Teams with test setup that loads application code first will need to address that ordering. The project says it is built in CI on Ruby 3.2+ and JRuby 10+; JRuby supports line coverage only, a meaningful limitation for teams relying on branch or other coverage types.

Pricing

SimpleCov — free. The free plan is MIT licensed and covers Ruby line, branch, method, oneshot-line, and eval coverage, with HTML and JSON formats, historical trends, and coverage gates. There is no trial to evaluate before using the free plan, and no paid SimpleCov tier is described.

This is a straightforward fit for Ruby developers and teams that want coverage reporting without a software charge. The trade-off is scope rather than a lower-tier cap: SimpleCov supports Ruby, and JRuby users are limited to line coverage.

Platforms

SimpleCov is listed for Linux, macOS, Windows, and web. Its supported language is Ruby. The project identifies MIT as its license. It directs code and bug reports to its issue tracker and discussion and announcements to a Google Groups mailing list.

Who it's for

Choose SimpleCov if your Ruby project needs configurable coverage reports, test-to-line mapping, production usage signals, or threshold checks for changed code. It is particularly useful where teams want coverage gates without adopting a paid coverage product. Look elsewhere if you need a cross-language tool or JRuby branch coverage.

Pros and cons

• Pros: HTML and JSON output, suite merging, filters and profiles, and historical trends support varied reporting needs.
• Pros: Test mapping and oneshot production coverage add context about what exercises code in tests and live traffic.
• Pros: Line and branch thresholds, including changed-line gates, let teams apply coverage rules to code changes.
• Cons: Startup order matters: SimpleCov must run before application code loads to track those files.
• Cons: JRuby supports line coverage only, limiting teams that need other coverage types on that runtime.
• Cons: Ruby-only support makes it a poor fit for projects seeking one coverage tool across multiple languages.

Alternatives

Test Coverage Tools is a useful starting point for comparing coverage products across categories.

• OpenClover is another free option if you want coverage tooling across Linux, macOS, web, and Windows; its plan is described as having no license tiers, keys, or usage limits.
• Coverage.py is the more relevant choice for Python projects; it is free and open source, with an enterprise subscription available through Tidelift.
• Coveralls suits readers looking for a hosted coverage service, with a free option for open-source and public repositories.
• Coverlet is the alternative for modern .NET SDK-style projects; it is free and MIT licensed.
• gofmt is a free command-line option included with a Go installation.
• Microsoft Code Coverage is a free, closed-source alternative for teams considering that approach.
• ReportGenerator offers a free open-source tier with basic features and a trial with full access; choose it if those report-generation options better match your needs.
• Codecov is a hosted alternative with a free Developer plan whose stated limits distinguish private repositories from public ones.

Verdict

SimpleCov is a strong choice for Ruby teams that want flexible reports and practical coverage gates without a software cost. Its test mapping and production usage recording add useful context beyond aggregate coverage. Choose another tool if you need cross-language coverage, or if JRuby branch coverage is essential; for SimpleCov users, getting startup order right is non-negotiable.