Update dependency simplecov to v1

[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
simplecov (changelog)	0.22.0 → 1.0.0

---

Release Notes

simplecov-ruby/simplecov (simplecov)

v1.0.0

Compare Source

==================

First stable release of the 1.0 line. The entries below consolidate release candidates rc1 through rc5 and describe all changes since 0.22.1.

Breaking Changes

• Dropped support for Ruby 3.1 and JRuby 9.4. The minimum is now Ruby 3.2 (and JRuby 10, which reports RUBY_VERSION 3.4). Ruby 3.1 reached end of life in March 2025, and a recent i18n release calls Fiber[], a Ruby 3.2 API, at load time, so suites that load Rails no longer run on 3.1. Raising required_ruby_version to >= 3.2 also excludes JRuby 9.4, which reports RUBY_VERSION 3.1.x. See #​1171.
• JSON formatter: group stats changed from { "covered_percent": 80.0 } to full stats shape { "covered": 8, "missed": 2, "total": 10, "percent": 80.0, "strength": 0.0 }. The key covered_percent is renamed to percent.
• JSON formatter: simplecov_json_formatter gem is now built in. require "simplecov_json_formatter" continues to work via a shim.
• StringFilter now matches at path-segment boundaries. "lib" matches /lib/ but no longer matches /library/. Use a Regexp filter for substring matching.
• SourceFile#project_filename now returns a truly relative path with no leading separator (e.g. lib/foo.rb instead of /lib/foo.rb). This also removes the leading / from file path keys in coverage.json and from the filename in minimum_coverage_by_file error messages. Anchored RegexFilters that relied on a leading / (e.g. %r{^/lib/}) should be rewritten (e.g. %r{\Alib/}).
• Removed docile gem dependency. The SimpleCov.configure block is now evaluated via instance_exec with instance variable proxying.
• Removed automatic activation of JSONFormatter when the CC_TEST_REPORTER_ID environment variable is set. The default HTMLFormatter now emits coverage.json alongside the HTML report (using JSONFormatter.build_hash to serialize the same payload JSONFormatter writes), so the env-var special case is no longer needed. Because of this, listing JSONFormatter alongside HTMLFormatter is redundant and can be removed.
• SimpleCov.start now loads the test_frameworks profile by default, which filters paths under test/, spec/, features/, and autotest/. Running the suite always executes 100% of the test files themselves, which inflated the overall percentage and obscured application coverage. To opt back in (e.g. to surface dead test helpers), drop the filter with remove_filter %r{\A(test|features|spec|autotest)/}. See #​816.
• HTML and JSON formatters now write the "Coverage report generated for X to Y" status line (and the per-criterion totals beneath it) to stderr instead of stdout. The message is a diagnostic, not the program's output, and routing it to stdout polluted pipelines like rspec -f json. Suppress it entirely with silent: true on the formatter; redirect with 2>&1 if you want the old behavior. See #​1060.
• Under parallel_tests, SimpleCov now waits in the first started process (via ParallelTests.first_process?) rather than the last. This matches the convention parallel_tests's own README recommends for "do something once after all workers finish" hooks, so user code that has its own ParallelTests.wait_for_other_processes_to_finish in an RSpec.after(:suite) (or equivalent) no longer deadlocks against SimpleCov's wait when both pick the same process. As a side benefit, the previous PARALLEL_TEST_GROUPS=1 workaround for last_process?'s "" == "1" mismatch (#​1066) is no longer needed — first_process? handles that case naturally. Migration: the rare project that wired its own wait via ParallelTests.last_process? now hits the symmetric deadlock and must switch to first_process?. See #​922.
• Removed SimpleCov.coverage_criterion. It was a reader/writer for a value nothing in SimpleCov ever consumed, so it duplicated primary_coverage without affecting any behavior. Use primary_coverage to choose the report's leading criterion (or the coverage :branch, primary: true form).

Deprecations

• The configuration API has been redesigned around a smaller, more consistent set of verbs. The legacy methods continue to work but each emits a deprecation warning that names its replacement; a future release will remove them. Warnings are deduplicated by call site, so a deprecated method called in a loop or a configuration block re-evaluated once per parallel worker or spec file warns at most once per source location (see #​1204). See the "Migrating from the legacy configuration API" section in the README for the full migration table and a before/after example.
  • add_filter → skip (identical matcher grammar; no behavior change)
  • add_group → group (identical matcher grammar; no behavior change)
  • track_files → cover (cover includes unloaded files like track_files did and restricts the report to the matching set; pass every directory you want reported, e.g. cover "lib/**/*.rb", "app/**/*.rb", to keep the old additive-only behavior)
  • use_merging → merging (same value)
  • enable_for_subprocesses → merge_subprocesses (same value)
  • enable_coverage_for_eval → enable_coverage :eval (folds into the same call that enables :line / :branch / :method)
  • print_error_status (reader) → print_errors (the print_error_status= writer is unaffected for now)
• Calling SimpleCov.start from .simplecov is deprecated. Coverage tracking still begins for backward compatibility, but a one-time deprecation warning fires pointing the user at moving the call into spec_helper.rb / test_helper.rb; a future release will require the explicit SimpleCov.start from a test helper. The migration goes hand-in-hand with the bugfix below: once SimpleCov.start lives in the test helper, the parent process that auto-loads .simplecov never starts tracking and the empty-report-overwrite scenario can't arise. See #​581.
• # :nocov: toggle comments (and the configurable SimpleCov.nocov_token / SimpleCov.skip_token) are deprecated in favor of the new # simplecov:disable / # simplecov:enable directives. Each file that still uses # :nocov: emits a one-time deprecation warning to stderr at load time pointing at the recommended replacement, and any call to SimpleCov.nocov_token or SimpleCov.skip_token (getter or setter) likewise warns. The directive will be removed in a future release.
• SimpleCov::SourceFile#branches_coverage_percent and #methods_coverage_percent are deprecated in favor of the uniform covered_percent(:branch) / covered_percent(:method). covered_percent (and covered_strength) now take a criterion argument (defaulting to :line), so the same call reaches any criterion instead of line being the unprefixed default while branch and method had their own differently-named methods. coverage_statistics also now accepts a criterion (e.g. coverage_statistics(:branch)) to return that one CoverageStatistics rather than the whole Hash.
• minimum_coverage_by_file and minimum_coverage_by_group are deprecated in favor of the coverage method's minimum_per_file / minimum_per_group verbs. The legacy methods overloaded a single hash to carry both per-criterion defaults and per-path / per-group overrides, with minimum_coverage_by_file further distinguishing Symbol keys (criterion defaults) from String / Regexp keys (path overrides) and accepting either a bare number or a per-criterion hash as the value. The coverage block fixes the criterion so every threshold is a plain percentage with an only: target. The setter form emits a deprecation warning naming the replacement; the no-arg getter (read internally) is unchanged. Replace e.g. minimum_coverage_by_file line: 70, 'app/x.rb' => 100 with coverage(:line) { minimum_per_file 70; minimum_per_file 100, only: 'app/x.rb' }. See the "Per-criterion thresholds with coverage" README section.

Enhancements

• simplecov uncovered gained --criterion line|branch|method (default line) so the lowest-coverage listing can rank by branch or method coverage, not just line.
• Added the criterion-first coverage configuration method — a uniform way to configure each coverage criterion (:line, :branch, :method) in one place. coverage :line do minimum 90; minimum_per_file 80; maximum_drop 5 end (or the one-liner coverage :branch, minimum: 80) enables the criterion and declares its thresholds with identical syntax regardless of criterion, because the criterion is fixed by the enclosing call rather than smuggled into the argument as the historical "a bare number means line coverage, every other criterion needs a Hash" special case. Verbs: minimum, maximum, exact, maximum_drop, minimum_per_file (with only: String-path / Regexp overrides), and minimum_per_group. Options: primary: (the report's leading criterion), oneshot: (oneshot-lines mode for :line), and :eval. The flat minimum_coverage family remains as suite-wide sugar. Thresholds feed the same internal stores, so exit-code enforcement is unchanged. See the "Per-criterion thresholds with coverage" section in the README.
• JSON formatter: coverage.json now carries a top-level $schema field holding the URL of the versioned canonical JSON Schema the document conforms to, plus a human-readable meta.schema_version ("major.minor", currently "1.0"). The versioned canonical lives at schemas/coverage-v1.0.schema.json and is immutable per version, an unversioned convenience alias at schemas/coverage.schema.json always tracks the latest. Downstream tools can validate inputs, generate types, or pin to a known shape, and the document-level $schema makes each payload self-describing. The schema version is independent of the gem version: additive changes bump minor, removals or shape changes bump major and ship as a new schemas/coverage-vX.0.schema.json file so prior-version consumers stay valid. meta.commit carries the git commit SHA the report was generated against (or null outside a git checkout), so tools can recover the exact source from history even when source_in_json false omits the per-file source arrays.
• Added SimpleCov::ParallelAdapters — a pluggable adapter interface for parallel test runners. SimpleCov's coordination with parallel test runners (deciding which worker does final-result work, waiting for siblings, knowing how many resultsets to expect) now routes through an adapter chain rather than hard-coding the parallel_tests gem's API. Two adapters ship: ParallelTestsAdapter wraps the historical grosser/parallel_tests gem (precise, gem-API-based); GenericAdapter handles any runner that follows the TEST_ENV_NUMBER / PARALLEL_TEST_GROUPS env-var convention without shipping a Ruby API. The practical impact: parallel_rspec (and any similar env-var-only runner) now works out of the box — previously every worker thought it was the "final" one and they clobbered each other's resultsets. Custom runners can register their own adapter via SimpleCov::ParallelAdapters.register MyAdapter, where MyAdapter subclasses SimpleCov::ParallelAdapters::Base and overrides the four contract methods (active?, first_worker?, wait_for_siblings, expected_worker_count). See #​1065.
• Added SimpleCov.ignore_branches for opting out of synthetic :else branches that Ruby's Coverage library reports for constructs with no literal else keyword — exhaustive case/in pattern matches, case/when without else, ||= / &&=, and if / unless without else. Variadic; only :implicit_else is supported today, with room for future synthetic branch types. Calling it without (or before) enable_coverage :branch is harmless — the setting is stored and applies once branch coverage is enabled. Explicit else arms still count. See #​1033.
• Added SimpleCov.cover for declaring a positive coverage scope (the long-requested allowlist counterpart to add_filter). Accepts string globs, Regexps, blocks, or arrays of those; multiple calls union. When any cover matcher is configured the report drops every source file that doesn't match at least one of them, and string-glob matchers also expand on disk so files that exist but were never required during the run still appear in the report (at 0% coverage). Resolves the long-standing requests in #​696 and #​869. The companion SimpleCov.no_default_skips opts out of the filters that SimpleCov.start installs (hidden files, vendor/bundle/, test directories) so users who want to opt out wholesale don't have to call clear_filters themselves.
• SimpleCov.formatter false (and the equivalent SimpleCov.formatters []) now opts out of formatting entirely instead of raising ConfigurationError. SimpleCov::Result#format! returns nil when no formatter is configured. Intended for worker processes in big parallel CI runs (hundreds of jobs) where only a final SimpleCov.collate step needs a report — every other worker just drops its .resultset.json and exits without paying for HTML or multi-formatter output. See #​964.
• Setting TEST_ENV_NUMBER and PARALLEL_TEST_GROUPS no longer triggers a spurious "SimpleCov guessed you were running inside parallel tests but couldn't load it" warning when the parallel_tests gem isn't actually installed. SimpleCov now treats a LoadError on the auto-require as "the user set those env vars for some other reason (custom subprocess coordination, CI sharding) and isn't using parallel_tests" and silently skips. The new SimpleCov.parallel_tests true / false setting forces the auto-require on or off when finer control is needed. See #​1018.
• SimpleCov.minimum_coverage_by_file now accepts per-path overrides alongside the existing per-criterion defaults: pass String or Regexp keys to declare file- or directory-specific thresholds, e.g. minimum_coverage_by_file line: 70, 'app/mailers/request_mailer.rb' => 100. A String ending in / matches as a directory prefix; otherwise it must equal the project-relative path. Regexp keys match against the project-relative path. Per-path values may be a Numeric (primary criterion) or a per-criterion Hash; for each file the effective threshold is the defaults merged with any matching overrides (later overrides win per criterion, overrides win over defaults). The new overrides surface in coverage.json under the existing errors.minimum_coverage_by_file block. See #​575.
• Added SimpleCov.maximum_coverage (and the convenience SimpleCov.expected_coverage, which sets minimum_coverage and maximum_coverage to the same value) so the suite can be pinned to an exact coverage figure. A drop fails per the minimum; an unexpected increase also fails, prompting you to bump the threshold up rather than silently absorbing the improvement. Accepts the same Numeric / per-criterion Hash forms as minimum_coverage. Exits with status 4 (SimpleCov::ExitCodes::MAXIMUM_COVERAGE) when violated, and surfaces in coverage.json under errors.maximum_coverage. Comparisons floor the actual percent to two decimal places, so expected_coverage 95.42 still passes when the actual is e.g. 95.4287. See #​187.
• Added a bundled strict profile (SimpleCov.start "strict") that enables line, branch, and method coverage and pins the minimum threshold for each at 100%. Drops to line-only on engines without branch/method support (JRuby). See #​1061.
• SimpleCov.coverage_path is now explicitly settable rather than always computed from SimpleCov.root + SimpleCov.coverage_dir. Setting it pins the report destination regardless of later root / coverage_dir changes — useful for out-of-tree build directories (CMake/CTest etc.) where the coverage report doesn't live under the source root. See #​716.
• The "Coverage report generated for X to Y" status line now prints the report path relative to the current working directory when it lives under cwd, and includes the entry-point filename — coverage/index.html from the HTML formatter, coverage/coverage.json from the JSON formatter — so the line points at a concrete file (and is clickable in terminals that hyperlink paths). Paths outside cwd stay absolute. See #​197.
• Added SimpleCov.disable_coverage(criterion) so a project can opt out of line coverage entirely — e.g. enable_coverage :branch; disable_coverage :line for a branch-only run. SimpleCov.start now raises SimpleCov::ConfigurationError when every criterion has been disabled. The formatter summary and JSON output emit only the criteria that were actually measured, so a branch-only run produces no Line coverage: line, no lines key in coverage.json, and no zero-padded line numbers in the HTML report. See #​845.
• Added SimpleCov.remove_filter(arg) to drop a specific filter (matching by filter_argument) and SimpleCov.clear_filters to wipe the entire chain. Useful for selectively turning off one of the defaults loaded by SimpleCov.start — e.g. remove_filter(/\A\..*/) to stop hiding paths that begin with a dot. The README's "Default filters" section enumerates what's loaded by default and how to disable each piece. See #​803.
• Terminal output is now colorized when stderr is a TTY: coverage percentages in the formatter summary line and threshold-violation messages are rendered green (>= 90%), yellow (>= 75%), or red (< 75%) — matching the HTML report's thresholds. The "SimpleCov failed with exit N…" line is red and the "Stopped processing SimpleCov…" line is yellow. Respects NO_COLOR (force off, per no-color.org) and FORCE_COLOR (force on); NO_COLOR wins if both are set. See #​1157.
• CLI subcommands coverage, report, uncovered, and diff now colorize their printed percentages by the same threshold (and diff colors regressions red, improvements green). Auto-detect based on whether stdout is a TTY; the same NO_COLOR / FORCE_COLOR env vars apply. Each subcommand also accepts a --no-color flag as a per-invocation override.
• Added # simplecov:disable / # simplecov:enable directive comments for selectively skipping line, branch, and method coverage. Block form (own line) opens a region until the matching # simplecov:enable; inline form (trailing a code line) skips just that line. Categories may be combined (# simplecov:disable line, branch); omitting categories targets all three. Any trailing text is treated as a free-form reason and discarded (e.g. # simplecov:disable line legacy adapter). Directive markers inside string literals or heredocs are ignored.
• Added SimpleCov.source_in_json (default true) to make the per-file source array in coverage.json opt-out. Tools that read the project's source files from disk don't need the embedded copy, and on larger projects it dominates the JSON payload. The HTML report's coverage_data.js still embeds source unconditionally because the client-side viewer renders source from there. See #​1143.
• JSON formatter: meta.timestamp is now emitted with millisecond precision (iso8601(3)) so the concurrent-overwrite warning can distinguish writes within the same wall-clock second
• JSON formatter: added total section with aggregate coverage statistics (covered, missed, total, percent, strength) for line, branch, and method coverage. Line stats additionally include omitted (count of blank/comment lines, i.e. lines that cannot be covered)
• JSON formatter: per-file output now includes total_lines, lines_covered_percent, and when enabled: branches_covered_percent, methods array, and methods_covered_percent
• JSON formatter: group stats now include full statistics for all enabled coverage types, not just line coverage percent
• JSON formatter: added silent: keyword to JSONFormatter.new to suppress console output
• Merged simplecov-html formatter into the main gem. A backward-compatibility shim ensures require "simplecov-html" still works.
• Merged simplecov_json_formatter into the main gem. A backward-compatibility shim ensures require "simplecov_json_formatter" still works.
• CommandGuesser now appends the framework name to parallel test data (e.g. "RSpec (1/2)" instead of "(1/2)")
• SimpleCov::Result.new is roughly 7× faster for already-string-keyed input (the SimpleCov.collate hot path). The previous implementation deep-cloned each file's coverage data with JSON.parse(JSON.dump(coverage)) per source file — a useful normalization for live Coverage.result symbol keys, but pure overhead for resultsets loaded from disk that already have string keys. Result now stringifies the outer hash keys with transform_keys only when needed; the inner branch/method-key shape is already handled by SourceFile#restore_ruby_data_structure. See #​916.
• Added SimpleCov.parallel_wait_timeout (default 60 seconds), which controls how long the process that writes the final report waits for the other parallel-test workers to finish writing their resultsets before it merges. Raise it when one worker runs much heavier test files and routinely finishes well after the others, so its coverage is included in the merge and the minimum and maximum coverage checks run against the full total instead of being skipped against a partial one. See #​1171.
• Added SimpleCov.finalize_merge to separate storing mergeable worker resultsets from owning final report finalization. Parallel workers that write to explicit custom coverage destinations can now store their shard .resultset.json files without waiting on sibling shards they cannot see; an explicit SimpleCov.collate cleanup step then formats the merged report, enforces thresholds, and writes .last_run.json. SimpleCov infers this external-finalization mode only for recognized multi-worker parallel runs with merging enabled and a custom coverage destination, and emits a configuration warning until users set finalize_merge false (or true) explicitly. See #​1215.
• The gem no longer packages CHANGELOG.md, trimming the largest avoidable part of the payload (the changelog grew with every release). The changelog_uri gem metadata already links the copy on GitHub.
• HTML report: file lists now window at 1,000 rows. Lists with more file rows matching the active filters show the first 1,000 and a "Showing the first 1,000 of N files. Show all" row at the bottom. Browsers lay out every visible table row again after each re-sort, which froze multi-thousand-file reports for seconds per header click. The window is presentation only (sorting, filtering, and the totals row still cover every file) and "Show all" restores the full list for the rest of the session. Measured on a synthetic 8,000-file report in headless Chrome, initial render drops from 3.8s to 0.8s and each re-sort from about 700ms to under 200ms. See #​1171.
• HTML report: re-sorting and filtering large file lists is faster, and slow re-sorts are signaled instead of silently freezing the page. Sort values are cached after the first read, re-clicking the active sort column reverses the current order outright, name comparisons go through a cached collator, and file lists past 500 rows dim behind a "Sorting…" overlay that also absorbs stray clicks while the browser re-lays-out the table. Filter keystrokes are cheaper too: the coverage-bar width equalizer now writes one CSS custom property per measurement probe instead of inline styles on every bar, and the filename filter caches lowercased names instead of re-reading the DOM. See #​1171.
• HTML report: file lists sort on load by the primary coverage criterion (SimpleCov.primary_coverage, line by default), ascending, so the least-covered files lead the list. To carry the primary criterion to the report, coverage.json includes a primary_coverage field in meta, also documented in the coverage schema. See #​1171.

Bugfixes

• Added :eval_generated tokens to SimpleCov.ignore_branches and the new SimpleCov.ignore_methods so projects using macros like Rails' delegate (or any pattern that calls module_eval(body, __FILE__, __LINE__)) can drop the synthetic branch and method entries those macros inject. Ruby's Coverage attributes eval'd code to the caller's __FILE__ / __LINE__, so a delegate :foo, to: :bar line surfaces as if it had a def foo and an if branch right there. Detection uses Prism to walk the static source and treats any Coverage entry whose start_line lacks a real def keyword (for methods) or branch construct (for branches) as eval-generated. Opt in with ignore_methods :eval_generated and / or ignore_branches :eval_generated. Prism ships with Ruby 3.3+; on older Rubies gem install prism enables the filter, otherwise the setting is a no-op. See #​1046.
• Files added via cover / track_files that were never require'd during the run now contribute branch and method entries to the report, not just lines. Previously SimulateCoverage left those fields as empty hashes (because parsing source ourselves felt risky), which made unloaded files invisible to the branch and method denominators while their lines DID count — so a cover "{app,lib}/**/*.rb" glob over files without specs silently inflated branch% relative to line% (the OP's reproduction was via SonarQube, which surfaces the asymmetry more visibly than the SimpleCov HTML report). Branches and methods are now enumerated statically via SimpleCov::StaticCoverageExtractor, which uses Prism to walk the AST and emits Coverage-shaped tuples without loading the file. The shape matches what Ruby's own Coverage library reports for the same source: :if / :case / :while / :until constructs plus their :then / :else / :when / :in / :body arms, with the synthetic :else for case-without-explicit-else that the ignore_branches :implicit_else setting (see Enhancements) targets. Prism is bundled with Ruby 3.3+; on older Rubies gem install prism enables the fix, otherwise SimulateCoverage falls back to the previous "empty hashes" behavior. See #​1059.
• HTML report: two groups whose names share an alphanumeric suffix but differ only in a leading non-letter (e.g. ">100LOC" / "<10LOC", or any pair using different special characters) no longer render into the same DOM container. The JS that built HTML ids from group names stripped every non-letter prefix and then every remaining non-alphanumeric char, so both names sanitized to "LOC" and the second group silently replaced the first in the rendered tabs. The new encoding ("g-" + each-non-id-char-as-hex) preserves uniqueness across all input shapes. See #​1038.
• HTML report: filenames containing " or ' characters are now escaped when rendered into title="..." attributes. The previous DOM-based escapeHTML only escaped &, <, and >, so a project with such filenames could break out of the attribute. The replacement encodes all five HTML-attribute-sensitive characters via a replace callback (also avoids allocating a DOM node per call).
• HTML report: files with literally 0% branch or method coverage now display 0% instead of 100%. The per-file row rendering used f.branches_covered_percent || 100.0 (and the method equivalent), which treated a real 0 as falsy and substituted the disabled-criterion fallback. The check now distinguishes "criterion disabled" (undefined) from "criterion measured zero" (0).
• SimpleCov::Result now warns when it drops source files because their absolute paths aren't on the local filesystem, instead of silently producing an empty 0 / 0 (100.00%) report. The most common trigger is SimpleCov.collate invoked from a machine or working directory different from where the individual resultsets were generated — when every entry is missing the warning explicitly names that case and points at the issue; when only some are missing the warning is quieter and lists up to five paths with a (+N more) suffix. See #​980.
• Files added via track_files that were never loaded now use the same line classification as loaded files. Previously, SimulateCoverage ran the file through LinesClassifier, which marks every non-blank, non-comment line as relevant — so a multi-line method chain @x = a.foo.bar reported 4 relevant lines for the unloaded copy and 2 for the loaded copy, throwing off per-file and overall percentages. SimulateCoverage now uses Coverage.line_stub (the same stub Ruby would have produced if the file were required), then overlays # :nocov: toggles and # simplecov:disable line directive ranges that the runtime doesn't know about. The two paths now agree on every shape: multi-line statements, end keywords, blank lines, and SimpleCov-specific exclusion comments. Some projects will see their tracked_files percentages shift as a result. See #​654.
• Fix the parent-process / subprocess race where a Rakefile (or Rails Bundler.require) caused .simplecov to auto-load SimpleCov.start in the rake parent, which then shelled out to a test runner subprocess; the subprocess wrote a correct report, then the parent's at_exit would clobber it with an empty 0% report. Three layers of defense now apply: (1) .simplecov is treated as configuration only and no longer starts tracking from the parent (see Deprecations); (2) ResultMerger.store_result merges incoming entries with same-command_name entries that were written after our process_start_time instead of overwriting them; (3) SimpleCov.at_exit_behavior defers entirely when our merged result is empty and coverage/.last_run.json is fresher than this process. See #​581.
• Don't report misleading 100% branch/method coverage for files added via track_files that were never loaded. See #​902
• Fix HTML formatter tab bar layout: dark mode toggle no longer wraps onto two lines, and tabs connect seamlessly with the content panel
• Allow SimpleCov.root('/') so files outside the conventional project root can be tracked (e.g. Docker layouts where code and tests are siblings at /). The root-prefix regex no longer doubles the separator (//), and project_name no longer crashes when root has no parent segment. The user-facing :root_filter profile and the unconditional UselessResultsRemover now share a single regex source instead of computing it independently. See #​860.
• When SimpleCov.start runs after require "minitest/autorun" (e.g. under Rake::TestTask or Minitest::TestTask, which shell out as ruby -e 'require "minitest/autorun"; ...'), automatically set external_at_exit and route the report through Minitest.after_run. Previously, the at_exit LIFO order meant SimpleCov formatted a 0% report before Minitest ran. The opposite ordering (SimpleCov first) is still handled by lib/minitest/simplecov_plugin.rb. See #​1032, #​1099, and #​1112.
• Forked subprocesses (for example Rails' parallelize) are now named by a stable per-run serial rather than the child's OS process id. Because the pid changed every run, a re-run's worker results were never named the same as the previous run's and so never overwrote them. They accumulated in .resultset.json until merge_timeout dropped them, and while several runs sat inside that window together SimpleCov merged them all. When the set of files had drifted between those runs (a deleted file, a changed filter) the stale results leaked into the report, inflating the denominator and changing the coverage percentage from one run to the next. The serial sequence is identical from one run to the next, so a re-run's workers now overwrite the previous run's entries and the resultset stays bounded. See #​1171.
• The "Excluded N result(s) older than merge_timeout" warning is now emitted at most once, from the reporting process, instead of once per forked worker. Every worker merges the resultset too, and the default at_fork sets print_errors false for them, but this one warning did not honor the flag, so an eight-worker run printed eight copies. See #​1171.
• The "SimpleCov dropped N source file(s)" warning is now emitted at most once, from the process that writes the final report, instead of once per parallel worker. It was previously raised every time a result was built, so an eight-worker run produced eight copies. Fork-based runners that do not set TEST_ENV_NUMBER, such as Minitest's parallelize, match no parallel-test adapter, so SimpleCov now marks forked children (it already hooks Process._fork) and treats them as non-reporters when no adapter is active, leaving the process that did the forking to merge every slice and report once. See #​1171.
• The parallel_tests adapter now only activates and uses the native wait API when the native pid-file synchronization contract is present. Processes that inherit TEST_ENV_NUMBER / PARALLEL_TEST_GROUPS without PARALLEL_PID_FILE, or lose PARALLEL_PID_FILE before SimpleCov's at_exit hook runs, now use the generic resultset polling path instead of calling ParallelTests.wait_for_other_processes_to_finish and failing when parallel_tests fetches the missing pid-file path. See #​1210.
• The default at_exit formatter now writes reports only from the final parallel-test worker while still storing each worker's resultset for the final merge, so JSON/XML/HTML formatters no longer clobber canonical coverage files from non-final workers. See #​1210.
• SimpleCov.parallel_tests false now disables the generic TEST_ENV_NUMBER adapter as well as the parallel_tests gem adapter, so projects that use those environment variables for a different coverage collation flow can opt out consistently. See #​1208.
• Parallel result coordination now stores the final worker's own resultset before waiting for sibling resultsets, preventing an off-by-one timeout where the final worker reported N-1 of N workers and skipped threshold checks immediately before producing a complete merged report. See #​1208.
• Static branch coverage now matches Ruby's runtime branch tuple identities for unless and safe-navigation calls, and resultset merges now combine serialized branch tuples by source location instead of by their local sequential ids. This prevents equivalent branches from being duplicated when static and runtime branch extraction assign different ids. See #​1206.

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At 12:00 AM through 04:59 AM and 10:00 PM through 11:59 PM, Monday through Friday (* 0-4,22-23 * * 1-5)
  • Only on Sunday and Saturday (* * * * 0,6)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.