123456789_123456789_123456789_123456789_123456789_

Class: SimpleCov::Result

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, Forwardable
Inherits: Object
Defined in: lib/simplecov/result.rb

Overview

A simplecov code coverage result, initialized from the Hash Ruby's built-in coverage library generates (Coverage.result).

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(original_result, command_name: nil, created_at: nil, not_loaded_files: Set.new) ⇒ Result

Initialize a new Result from given Coverage.result (a Hash of filenames each containing an array of coverage data)

[ GitHub ] 

  


# File 'lib/simplecov/result.rb', line 33



def initialize(original_result, command_name: nil, created_at: nil, not_loaded_files: Set.new)
  result = original_result
  @original_result = result.freeze
  @command_name = command_name
  @created_at = created_at
  @files = SimpleCov::FileList.new(
    result.filter_map { |filename, coverage| build_source_file(filename, coverage, not_loaded_files) }
          .sort_by(&:filename)
  )
  filter!
end


  







Class Method Details



  

    .from_hash(hash)  
  



  

    
Loads a #to_hash dump

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 82



def self.from_hash(hash)
  hash.map do |command_name, data|
    new(data.fetch("coverage"), command_name: command_name, created_at: Time.at(data["timestamp"]))
  end
end


  







Instance Attribute Details



  

    #command_name   (rw)
  



  

    
The command name that launched this result.
Delegated to SimpleCov.command_name if not set manually

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 67



def command_name
  @command_name ||= SimpleCov.command_name
end


  








  

    #command_name=(value)   (rw)
  



  

    
Explicitly set the command name that was used for this coverage result. Defaults to SimpleCov.command_name

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 22



attr_writer :command_name


  








  

    #created_at   (rw)
  



  

    
Defines when this result has been created. Defaults to Time.now

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 61



def created_at
  @created_at ||= Time.now
end


  








  

    #created_at=(value)   (rw)
  



  

    
Explicitly set the Time this result has been created

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 20



attr_writer :created_at


  








  

    #files   (readonly)
    Also known as: #source_files
  



  

    
Returns all files that are applicable to this result (sans filters!) as instances of SourceFile. Aliased as :source_files

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 17



attr_reader :files


  








  

    #original_result   (readonly)
  



  

    
Returns the original Coverage.result used for this instance of Result

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 15



attr_reader :original_result


  








  

    #source_files   (readonly)
  



  

    
Alias for #files.

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 18



alias source_files files


  







Instance Method Details



  

    #build_source_file(filename, coverage, not_loaded_files)   (private)
  

  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 90



def build_source_file(filename, coverage, not_loaded_files)
  return unless File.file?(filename)

  SimpleCov::SourceFile.new(
    filename,
    JSON.parse(JSON.dump(coverage)),
    loaded: !not_loaded_files.include?(filename)
  )
end


  








  

    #coverage   (private)
  

  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 100



def coverage
  keys = original_result.keys & filenames
  keys.zip(original_result.values_at(*keys)).to_h
end


  








  

    #filenames  
  



  

    
Returns all filenames for source files contained in this result

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 46



def filenames
  files.map(&:filename)
end


  








  

    #filter!   (private)
  



  

    
Applies all configured ::SimpleCov filters on this result's source files

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 106



def filter!
  @files = SimpleCov.filtered(files)
end


  








  

    #format!  
  



  

    
Applies the configured SimpleCov.formatter on this result

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 56



def format!
  SimpleCov.formatter.new.format(self)
end


  








  

    #groups  
  



  

    
Returns a Hash of groups for this result. Define groups using SimpleCov.add_group 'Models', 'app/models'

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 51



def groups
  @groups ||= SimpleCov.grouped(files)
end


  








  

    #to_hash  
  



  

    
Returns a hash representation of this Result that can be used for marshalling it into JSON

  



  [ GitHub ]


  

  


# File 'lib/simplecov/result.rb', line 72



def to_hash
  {
    command_name => {
      "coverage" => coverage,
      "timestamp" => created_at.to_i
    }
  }
end