Class: Covered::Config

Inherits:
Object
  • Object
show all
Defined in:
lib/covered/config.rb

Constant Summary collapse

PATH = 
"config/covered.rb"

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(root, coverage) ⇒ Config

Returns a new instance of Config.



40
41
42
43
44
45
46
 
# File 'lib/covered/config.rb', line 40

def initialize(root, coverage)
  @root = root
  @coverage = coverage
  @policy = nil
  
  @environment = nil
end

Instance Attribute Details

#coverage ⇒ Object (readonly)

Returns the value of attribute coverage.



54
55
56
 
# File 'lib/covered/config.rb', line 54

def coverage
  @coverage
end

Class Method Details

.coverage ⇒ Object 



24
25
26
 
# File 'lib/covered/config.rb', line 24

def self.coverage
  ENV['COVERAGE']
end

.load(root: self.root, coverage: self.coverage) ⇒ Object 



28
29
30
31
32
33
34
35
36
37
38
 
# File 'lib/covered/config.rb', line 28

def self.load(root: self.root, coverage: self.coverage)
  derived = Class.new(self)
  
  if path = self.path(root)
    config = Module.new
    config.module_eval(::File.read(path), path)
    derived.prepend(config)
  end
  
  return derived.new(root, coverage)
end

.path(root) ⇒ Object 



16
17
18
19
20
21
22
 
# File 'lib/covered/config.rb', line 16

def self.path(root)
  path = ::File.expand_path(PATH, root)
  
  if ::File.exist?(path)
    return path
  end
end

.root ⇒ Object 



12
13
14
 
# File 'lib/covered/config.rb', line 12

def self.root
  ENV['COVERED_ROOT'] || Dir.pwd
end

Instance Method Details

#call(output) ⇒ Object 



82
83
84
 
# File 'lib/covered/config.rb', line 82

def call(output)
  policy.call(output)
end

#each(&block) ⇒ Object 



86
87
88
 
# File 'lib/covered/config.rb', line 86

def each(&block)
  policy.each(&block)
end

#finish ⇒ Object 



73
74
75
76
77
78
79
80
 
# File 'lib/covered/config.rb', line 73

def finish
  # Finish coverage tracking:
  policy.finish
  
  # Restore the environment:
  ENV.replace(@environment)
  @environment = nil
end

#ignore_paths ⇒ Object 



90
91
92
 
# File 'lib/covered/config.rb', line 90

def ignore_paths
  ['test/', 'fixtures/', 'spec/', 'vendor/', 'config/']
end

#make_policy(policy) ⇒ Object

Override this method to implement your own policy.



95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
 
# File 'lib/covered/config.rb', line 95

def make_policy(policy)
  # Only files in the root would be tracked:
  policy.root(@root)
  
  patterns = ignore_paths.map do |path|
    File.join(@root, path)
  end
  
  # We will ignore any files in the test or spec directory:
  policy.skip(Regexp.union(patterns))
  
  # We will include all files under lib, even if they aren't loaded:
  policy.include("lib/**/*.rb")
  
  policy.persist!
  
  policy.reports!(@coverage)
end

#output ⇒ Object 



60
61
62
 
# File 'lib/covered/config.rb', line 60

def output
  policy.output
end

#policy ⇒ Object 



56
57
58
 
# File 'lib/covered/config.rb', line 56

def policy
  @policy ||= Policy.new.tap{|policy| make_policy(policy)}.freeze
end

#report? ⇒ Boolean Also known as: record?

Returns:

  • (Boolean) 


48
49
50
 
# File 'lib/covered/config.rb', line 48

def report?
  !!@coverage
end

#start ⇒ Object 



64
65
66
67
68
69
70
71
 
# File 'lib/covered/config.rb', line 64

def start
  # Save and setup the environment:
  @environment = ENV.to_h
  autostart!
  
  # Start coverage tracking:
  policy.start
end