123456789_123456789_123456789_123456789_123456789_

Module: SimpleCov::Combine::MethodsCombiner

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

Overview

::SimpleCov::Combine different method coverage results on a single file.

Should be called through SimpleCov.combine.

Class Method Summary

Class Method Details

.combine(coverage_a, coverage_b) ⇒ Hash (mod_func)

Return merged methods or the existing methods if other is missing.

Method coverage maps [class, name, start_line, start_col, end_line, end_col] keys to hit counts. Keys are matched on their SOURCE identity — the location, ignoring the class and name elements — because Ruby records one entry per defined method: the same define_method block defined onto different classes, or under different names, in different processes arrives with different receivers or names for the same source method, and matching on the full key would keep both, letting a never-called copy's 0 shadow a covered method after merge (issue #1234). Combining sums the hit counts for matching methods and preserves methods that only appear in one result.

[ GitHub ] 

  


# File 'lib/simplecov/combine/methods_combiner.rb', line 32



def combine(coverage_a, coverage_b)
  merged = {} #: Hash[untyped, [untyped, Integer]]
  [coverage_a, coverage_b].each { |coverage| merge_methods(merged, coverage) }

  merged.values.to_h
end


  








  

    .identities   (mod_func)
  



  

    
Bounded by the project's method count, like RubyDataParser's parse
cache.

  



  [ GitHub ]


  

  


# File 'lib/simplecov/combine/methods_combiner.rb', line 55



def identities
  @identities ||= IdentityInterner.build { |key| source_identity(key) }
end


  








  

    .merge_methods(target, source)   (mod_func)
  



  

    
target and its pairs are always built by .combine above, so updating
them in place can't reach data a caller still holds.

  



  [ GitHub ]


  

  


# File 'lib/simplecov/combine/methods_combiner.rb', line 41



def merge_methods(target, source)
  source.each do |key, count|
    method_key = identities[key]
    entry = target[method_key]
    if entry
      entry[1] += count
    else
      target[method_key] = [key, count]
    end
  end
end


  








  

    .source_identity(key)   (mod_func)
  

  [ GitHub ]


  

  


# File 'lib/simplecov/combine/methods_combiner.rb', line 59



def source_identity(key)
  _class_name, _method_name, *location = SourceFile::RubyDataParser.call(key)
  location.freeze
end