Module: SingleCov

Defined in:
lib/single_cov.rb,
lib/single_cov/version.rb

Constant Summary collapse

COVERAGES = 
[]
MAX_OUTPUT = 
40
RAILS_APP_FOLDERS = 
["models", "serializers", "helpers", "controllers", "mailers", "views", "jobs", "channels"]
UNCOVERED_COMMENT_MARKER = 
/#.*uncovered/
VERSION = 
"1.8.2"

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.coverage_report ⇒ Object

enable coverage reporting: path to output file, changed by forking-test-runner at runtime to combine many reports



10
11
12
 
# File 'lib/single_cov.rb', line 10

def coverage_report
  @coverage_report
end

.coverage_report_lines ⇒ Object

emit only line coverage in coverage report for older coverage systems



13
14
15
 
# File 'lib/single_cov.rb', line 13

def coverage_report_lines
  @coverage_report_lines
end

Class Method Details

.all_covered?(result) ⇒ Boolean

Returns:

  • (Boolean) 


32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
 
# File 'lib/single_cov.rb', line 32

def all_covered?(result)
  errors = COVERAGES.flat_map do |file, expected_uncovered|
    next no_coverage_error(file) unless coverage = result["#{root}/#{file}"]

    uncovered = uncovered(coverage)
    next if uncovered.size == expected_uncovered

    # ignore lines that are marked as uncovered via comments
    # TODO: warn when using uncovered but the section is indeed covered
    content = File.readlines("#{root}/#{file}")
    uncovered.reject! do |line_start, _, _, _|
      content[line_start - 1].match?(UNCOVERED_COMMENT_MARKER)
    end
    next if uncovered.size == expected_uncovered

    bad_coverage_error(file, expected_uncovered, uncovered)
  end.compact

  return true if errors.empty?

  errors[MAX_OUTPUT..-1] = "... coverage output truncated" if errors.size >= MAX_OUTPUT
  @error_logger.puts errors

  errors.all? { |l| warning?(l) }
end

.assert_full_coverage(tests: default_tests, currently_complete: [], location: nil) ⇒ Object 



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
 
# File 'lib/single_cov.rb', line 79

def assert_full_coverage(tests: default_tests, currently_complete: [], location: nil)
  location ||= caller(0..1)[1].split(':in').first
  complete = tests.select { |file| File.read(file) =~ /SingleCov.covered!(?:(?!uncovered).)*(\s*|\s*\#.*)$/ }
  missing_complete = currently_complete - complete
  newly_complete = complete - currently_complete
  errors = []

  if missing_complete.any?
    errors << <<~MSG
      The following file(s) were previously marked as having 100% SingleCov test coverage (had no `coverage:` option) but are no longer marked as such.
      Please increase test coverage in these files to maintain 100% coverage and remove `coverage:` usage.
      #{missing_complete.join("\n")}
    MSG
  end

  if newly_complete.any?
    errors << <<~MSG
      The following files are newly at 100% SingleCov test coverage.
      Please add the following to #{location} to ensure 100% coverage is maintained moving forward.
      #{newly_complete.join("\n")}
    MSG
  end

  raise errors.join("\n") if errors.any?
end

.assert_tested(files: glob('{app,lib}/**/*.rb'), tests: default_tests, untested: []) ⇒ Object 



67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/single_cov.rb', line 67

def assert_tested(files: glob('{app,lib}/**/*.rb'), tests: default_tests, untested: [])
  missing = files - tests.map { |t| guess_covered_file(t) }
  fixed = untested - missing
  missing -= untested

  if fixed.any?
    raise "Remove #{fixed.inspect} from untested!"
  elsif missing.any?
    raise missing.map { |f| "missing test for #{f}" }.join("\n")
  end
end

.assert_used(tests: default_tests) ⇒ Object 



58
59
60
61
62
63
64
65
 
# File 'lib/single_cov.rb', line 58

def assert_used(tests: default_tests)
  bad = tests.select do |file|
    File.read(file) !~ /SingleCov.(not_)?covered!/
  end
  unless bad.empty?
    raise bad.map { |f| "#{f}: needs to use SingleCov.covered!" }.join("\n")
  end
end

.covered!(file: nil, uncovered: 0) ⇒ Object

mark the file under test as needing coverage



26
27
28
29
30
 
# File 'lib/single_cov.rb', line 26

def covered!(file: nil, uncovered: 0)
  file = ensure_covered_file(file)
  COVERAGES << [file, uncovered]
  main_process!
end

.disable ⇒ Object

use this in forks when using rspec to silence duplicated output



137
138
139
 
# File 'lib/single_cov.rb', line 137

def disable
  @disabled = true
end

.not_covered! ⇒ Object

mark a test file as not covering anything to make assert_used pass



21
22
23
 
# File 'lib/single_cov.rb', line 21

def not_covered!
  main_process!
end

.rewrite(&block) ⇒ Object

optionally rewrite the matching path single-cov guessed with a lambda



16
17
18
 
# File 'lib/single_cov.rb', line 16

def rewrite(&block)
  @rewrite = block
end

.setup(framework, root: nil, branches: true, err: $stderr) ⇒ Object 



105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
 
# File 'lib/single_cov.rb', line 105

def setup(framework, root: nil, branches: true, err: $stderr)
  @error_logger = err

  if defined?(SimpleCov)
    raise "Load SimpleCov after SingleCov"
  end

  @branches = branches
  @root = root

  case framework
  when :minitest
    minitest_should_not_be_running!
    return if minitest_running_subset_of_tests?
  when :rspec
    return if rspec_running_subset_of_tests?
  else
    raise "Unsupported framework #{framework.inspect}"
  end

  start_coverage_recording

  override_at_exit do |status, _exception|
    if enabled? && main_process? && status == 0
      results = coverage_results
      generate_report results
      exit 1 unless SingleCov.all_covered?(results)
    end
  end
end