123456789_123456789_123456789_123456789_123456789_

Module: SimpleCov::SimulateCoverage

Relationships & Source Files
Defined in: lib/simplecov/simulate_coverage.rb

Overview

Responsible for producing file coverage metrics.

Class Method Summary

Class Method Details

.call(absolute_path) ⇒ Hash (mod_func)

Simulate a file coverage report for a file that was tracked but never required. Returns the same hash shape as Coverage.result (lines, branches, methods).

The line classification comes from Coverage.line_stub — the same classification the runtime would have produced if the file had been required — overlaid with SimpleCov's # :nocov: toggles and # simplecov:disable line directive ranges, which Coverage doesn't know about. This keeps "relevant lines" identical whether a file was loaded or just tracked, fixing the multi-line statement discrepancy in https://github.com/simplecov-ruby/simplecov/issues/654.

Branches and methods are enumerated by static analysis (via StaticCoverageExtractor, which uses Prism). Earlier behavior left both as empty hashes, which made unloaded files invisible to the branch/method denominators while their lines DID count — so a track_files/cover glob that picked up files without specs silently inflated branch% relative to line%. See https://github.com/simplecov-ruby/simplecov/issues/1059. When Prism isn't loadable (Ruby < 3.3 without the prism gem) or the file can't be parsed, fall back to the old empty hashes — old behavior, old tradeoff.

[ GitHub ] 

  


# File 'lib/simplecov/simulate_coverage.rb', line 38



def call(absolute_path)
  source_lines = read_lines(absolute_path)
  lines = coverage_stub(absolute_path, source_lines) ||
          LinesClassifier.new.classify(source_lines)
  synthesized = StaticCoverageExtractor.call(source_lines.join) ||
                {"branches" => {}, "methods" => {}}

  {
    "lines" => lines,
    "branches" => synthesized["branches"],
    "methods" => synthesized["methods"]
  }
end


  








  

    .coverage_stub(path, source_lines)   (mod_func)
  



  

    
Combine Coverage.line_stub (which gets multi-line statements right)
with LinesClassifier (which knows about # :nocov: toggles and
# simplecov:disable line ranges). Returns nil — and the caller
falls back to LinesClassifier alone — when Coverage can't read
or parse the file, or when the runtime doesn't expose line_stub
(JRuby and TruffleRuby).

  



  [ GitHub ]


  

  


# File 'lib/simplecov/simulate_coverage.rb', line 64



def coverage_stub(path, source_lines)
  return nil unless Coverage.respond_to?(:line_stub)

  stub = Coverage.line_stub(path)
  classifier_output = LinesClassifier.new.classify(source_lines)
  stub.each_index { |idx| stub[idx] = nil if classifier_output[idx].nil? }
  stub
rescue Errno::ENOENT, SyntaxError
  nil
end


  








  

    .read_lines(path)   (mod_func)
  

  [ GitHub ]


  

  


# File 'lib/simplecov/simulate_coverage.rb', line 52



def read_lines(path)
  File.readlines(path)
rescue Errno::ENOENT
  []
end