uncov 0.4.2 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60ed1a2dd6520f9df75c5cc77e4b8b7b59d7ea61c6ae16c2e1ecad8bf86ae17a
-  data.tar.gz: 73bc05c3c969b1c8f2e7853f79aa96c2e793958c06bb0b0b3f4f6d03588501ca
+  metadata.gz: fc5eb3c1149eba5de56dd2bd43a4bf9a450abc25689456ef9290da0bb903b657
+  data.tar.gz: '08567ab62f909c0b8ebdf9f8bc8793edcb0e96e77408b10a5249da61cab7e42d'
 SHA512:
-  metadata.gz: 860d74da20e5c28b665829510cfc0e2e0aef47f1ba179a7e6d4fd0038740bdbe8b60b6ae471e15c1677d06a6fea62609ec543328034a5de58d55249d7dcee713
-  data.tar.gz: '0927a3a3c86100b376d92766ff6f7311797bb6345407948e418a4366a40231f38db1b9486934f1278f36b2977407fb5cf36935cac89a98f9841be991e504aa47'
+  metadata.gz: 849aec6d7483b7e76349d714ed59a7c53f0f3d9dd7c04e1423b808c0f00559274ef541fff97a024e001f7861a171c1079769229bc2bb2652500568f14f1f4283
+  data.tar.gz: 07eda0122c302e6003ed972585f7d0103985bbf56a5bf778029a3c3591ab9535cc94c8d3b83cc211f94eace1ebf495ef10eb365d8339807179e3ec3d8e294ad7

data/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 2025-05-26: [v0.6.0](https://github.com/mpapis/uncov/releases/tag/v0.6.0)
+
+### Minor
+
+- [#47](https://github.com/mpapis/uncov/pull/47): Extensible with plugins, by [@mpapis](https://github.com/mpapis)
+- [#56](https://github.com/mpapis/uncov/pull/56): Add Simplecov and FileSystem filters, by [@mpapis](https://github.com/mpapis)
+
+### Patch
+
+- [#59](https://github.com/mpapis/uncov/pull/59): Simplify git rev-parse target, by [@mpapis](https://github.com/mpapis)
+
+
+## 2025-05-12: [v0.5.0](https://github.com/mpapis/uncov/releases/tag/v0.5.0)
+
+### Minor
+
+- [#43](https://github.com/mpapis/uncov/pull/43): Trigger tests on test_file_changes. Add git_files report generator., by [@mpapis](https://github.com/mpapis)
+- [#45](https://github.com/mpapis/uncov/pull/45): Add diff_files report type, by [@mpapis](https://github.com/mpapis)
+- [#46](https://github.com/mpapis/uncov/pull/46): Add nocov report filter and flags, by [@mpapis](https://github.com/mpapis)
+
+### Patch
+
+- [#44](https://github.com/mpapis/uncov/pull/44): Allow any git revision specification for target, by [@mpapis](https://github.com/mpapis)
+
+
+
 ## 2025-05-10: [v0.4.2](https://github.com/mpapis/uncov/releases/tag/v0.4.2)
 
 ### Patch

data/README.md

@@ -13,6 +13,8 @@ Uncov uses `git diff` to detect changes and `simplecov` reports to detect uncove
 - Identify changed Ruby files
 - Run tests automatically for (changed) relevant files
 - Print report of uncovered lines in (changed) files
+- Print report of covered :nocov: lines in (changed) files
+- Extensible with gem plugins
 
 
 ## Installation
@@ -36,16 +38,35 @@ uncov
 $ uncov -h
 Usage: uncov [options]
     -t, --target TARGET              Target branch for comparison, default: "HEAD"
-    -r, --report TYPE                Report type to generate, one_of: "diff_lines"(default)
-    -o, --output-format FORMAT       Output format, one_of: "terminal"(default)
+    -r, --report FILTER              Report filter to generate file/line list, one_of: "DiffFiles", "DiffLines"(default), "FileSystem", "GitFiles", "NocovLines", "Simplecov"
+    -o, --output-format FORMAT       Output format, one_of: "Terminal"(default)
     -C, --context LINES_NUMBER       Additional lines context in output, default: 1
         --test-command COMMAND       Test command that generates SimpleCov, default: "COVERAGE=true bundle exec rake test"
         --simplecov-file PATH        SimpleCov results file, default: "autodetect"
-        --relevant-files             Relevant files shell filename globing: https://ruby-doc.org/core-3.1.1/File.html#method-c-fnmatch, default: "{{bin,exe,exec}/*,{app,lib}/**/*.{rake,rb},Rakefile}"
+        --relevant-files FN_GLOB     Only show uncov for matching code files AND trigger tests if matching code files are newer than the report, default: "{{bin,exe,exec}/*,{app,lib}/**/*.{rake,rb},Rakefile}"
+        --relevant-tests FN_GLOB     Trigger tests if matching test files are newer than the report, default: "{test,spec}/**/*_{test,spec}.rb"
+        --nocov-ignore               Ignore :nocov: markers - consider all lines, default: false
+        --nocov-covered              Report :nocov: lines that have coverage, default: false
         --debug                      Get some insights, default: false
-    -v, --version                    Show version
     -h, --help                       Print this help
-uncov 0.4.2 by Michal Papis <mpapis@gmail.com>
+
+Report FILTERs:
+ DiffFiles - Report missing coverage on added/changed files in the git diff
+ DiffLines - Report missing coverage on added lines in the git diff
+FileSystem - Report missing coverage on file system
+  GitFiles - Report missing coverage on files tracked with git
+NocovLines - Report coverage on nocov lines, requires one or both: --nocov-ignore / --nocov-covered
+ Simplecov - Report missing coverage on files tracked with simplecov
+
+Report FILTERs take NOTICE:
+git*/diff*  - filters will not consider new files unless added to the git index with `git add`.
+nocov*      - filters/flags only work with coverage/.resultset.json SimpleCov files,
+              coverage.json does not provide the information needed.
+
+FN_GLOB: shell filename globing -> https://ruby-doc.org/core-3.1.1/File.html#method-c-fnmatch
+         in bash: `shopt -s extglob dotglob globstar` and test with `ls {app,lib}/**/*.rb`
+
+uncov 0.6.0 by Michal Papis <mpapis@gmail.com>
 ```
 
 
@@ -62,6 +83,16 @@ COVERAGE=1 rspec
 ```
 
 
+## Plugins
+Uncov uses [pluginator](https://github.com/rvm/pluginator) to load plugins.
+
+See [lib/plugins/uncov](lib/plugins/uncov) for default plugins.
+
+To create your own plugin, create a gem with a `lib/plugins/uncov/...` structure - same as uncov has,
+the plugins will be loaded automatically.
+
+When you use uncov from a Gemfile then the new gam has to be added there too.
+
 ## Using in CI
 `uncov` uses itself to check new missing code coverage [.github/workflows/ci.yml](.github/workflows/ci.yml),
 no need to set minimal, always get better.

data/lib/{uncov → plugins/uncov}/formatter/terminal.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require 'colorize'
-require 'forwardable'
 
 # print report to terminal with colors
 class Uncov::Formatter::Terminal
@@ -14,14 +13,20 @@ class Uncov::Formatter::Terminal
   end
 
   def output
-    puts "Found #{report.uncovered_files.size} files with uncovered changes:".yellow
+    return puts 'No files to report.'.green if report.files.empty?
+    return puts "All changed files(#{report.files.count}) have 100% test coverage!".green unless report.trigger?
+
+    output_header
     output_files
-    puts
-    puts format('Overall coverage of changes: %.2f%%', report.coverage).yellow
+    output_summary
+  end
+
+  def output_header
+    puts "Files with uncovered changes: (#{report.display_files.size} / #{report.files.count})".yellow
   end
 
   def output_files
-    report.uncovered_files.each do |file_coverage|
+    report.display_files.each do |file_coverage|
       output_file(file_coverage)
     end
   end
@@ -40,8 +45,8 @@ class Uncov::Formatter::Terminal
       '%<name>s -> %<coverage>.2f%% (%<covered_lines>d / %<relevant_lines>d) changes covered, uncovered lines:',
       name: file_coverage.file_name,
       coverage: file_coverage.coverage,
-      covered_lines: file_coverage.covered_lines.count,
-      relevant_lines: file_coverage.relevant_lines.count
+      covered_lines: file_coverage.covered_lines_count,
+      relevant_lines: file_coverage.relevant_lines_count
     ).yellow
   end
 
@@ -50,6 +55,8 @@ class Uncov::Formatter::Terminal
       puts format_line(line, max).red
     elsif line.context
       puts format_line(line, max).green
+    elsif line.nocov_covered?
+      puts format_line(line, max).blue
     else
       # :nocov:
       raise 'unknown display line' # unreachable code
@@ -64,4 +71,14 @@ class Uncov::Formatter::Terminal
   def number_length(file_coverage)
     file_coverage.display_lines.last.number.to_s.length
   end
+
+  def output_summary
+    puts
+    puts format(
+      'Overall coverage of changes: %<coverage>.2f%% (%<covered_lines>d / %<relevant_lines>d)',
+      coverage: report.coverage,
+      covered_lines: report.covered_lines_count,
+      relevant_lines: report.relevant_lines_count
+    ).yellow
+  end
 end

data/lib/plugins/uncov/report/filters/diff_files.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# report only files lines from the diff
+module Uncov::Report::Filters::DiffFiles
+  class << self
+    def description = 'Report missing coverage on added/changed files in the git diff'
+    def simplecov_trigger = :git_diff
+
+    def files(finder)
+      finder.git_diff_files.file_names.map do |file_name|
+        Uncov::Report::File.new(
+          file_name:,
+          git: true,
+          lines: lines(finder, file_name)
+        )
+      end
+    end
+
+    private
+
+    def lines(finder, file_name)
+      lines_hash = file_lines(finder, file_name)
+      Uncov::Report::Context.add_context(finder, file_name, lines_hash)
+      lines_hash.sort.to_h.values
+    end
+
+    def file_lines(finder, file_name)
+      finder.file_system_files.lines(file_name).keys.to_h do |line_number|
+        [line_number, finder.build_line(file_name, line_number)]
+      end
+    end
+  end
+end

data/lib/plugins/uncov/report/filters/diff_lines.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# report only files lines from the diff
+module Uncov::Report::Filters::DiffLines
+  class << self
+    def description = 'Report missing coverage on added lines in the git diff'
+    def simplecov_trigger = :git_diff
+
+    def files(finder)
+      finder.git_diff_files.file_names.map do |file_name|
+        Uncov::Report::File.new(
+          file_name:,
+          git: true,
+          lines: lines(finder, file_name)
+        )
+      end
+    end
+
+    private
+
+    def lines(finder, file_name)
+      lines_hash = git_diff_files_lines(finder, file_name)
+      Uncov::Report::Context.add_context(finder, file_name, lines_hash)
+      lines_hash.sort.to_h.values
+    end
+
+    def git_diff_files_lines(finder, file_name)
+      finder.git_diff_files.lines(file_name).keys.to_h do |line_number|
+        [line_number, finder.build_line(file_name, line_number)]
+      end
+    end
+  end
+end

data/lib/plugins/uncov/report/filters/file_system.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# report all files lines from the file system
+module Uncov::Report::Filters::FileSystem
+  class << self
+    def description = 'Report missing coverage on file system'
+    def simplecov_trigger = :file_system
+
+    def files(finder)
+      finder.file_system_files.file_names.map do |file_name|
+        Uncov::Report::File.new(
+          file_name:,
+          git: finder.git_files.file?(file_name),
+          lines: lines(finder, file_name)
+        )
+      end
+    end
+
+    private
+
+    def lines(finder, file_name)
+      lines_hash = file_lines(finder, file_name)
+      Uncov::Report::Context.add_context(finder, file_name, lines_hash)
+      lines_hash.sort.to_h.values
+    end
+
+    def file_lines(finder, file_name)
+      finder.file_system_files.lines(file_name).keys.to_h do |line_number|
+        [line_number, finder.build_line(file_name, line_number)]
+      end
+    end
+  end
+end

data/lib/plugins/uncov/report/filters/git_files.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# report only files lines from the diff
+module Uncov::Report::Filters::GitFiles
+  class << self
+    def description = 'Report missing coverage on files tracked with git'
+    def simplecov_trigger = :git
+
+    def files(finder)
+      finder.git_files.file_names.map do |file_name|
+        Uncov::Report::File.new(
+          file_name:,
+          git: true,
+          lines: lines(finder, file_name)
+        )
+      end
+    end
+
+    private
+
+    def lines(finder, file_name)
+      lines_hash = file_lines(finder, file_name)
+      Uncov::Report::Context.add_context(finder, file_name, lines_hash)
+      lines_hash.sort.to_h.values
+    end
+
+    def file_lines(finder, file_name)
+      finder.file_system_files.lines(file_name).keys.to_h do |line_number|
+        [line_number, finder.build_line(file_name, line_number)]
+      end
+    end
+  end
+end

data/lib/plugins/uncov/report/filters/nocov_lines.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# report only files lines from the diff
+module Uncov::Report::Filters::NocovLines
+  class << self
+    def description = 'Report coverage on nocov lines, requires one or both: --nocov-ignore / --nocov-covered'
+    def simplecov_trigger = :file_system
+
+    def files(finder)
+      finder.nocov_files.file_names.filter_map do |file_name|
+        next if finder.nocov_files.lines(file_name).empty?
+
+        Uncov::Report::File.new(
+          file_name:,
+          git: finder.git_files.file?(file_name),
+          lines: lines(finder, file_name)
+        )
+      end
+    end
+
+    private
+
+    def lines(finder, file_name)
+      lines_hash = nocov_files_lines(finder, file_name)
+      Uncov::Report::Context.add_context(finder, file_name, lines_hash)
+      lines_hash.sort.to_h.values
+    end
+
+    def nocov_files_lines(finder, file_name)
+      finder.nocov_files.lines(file_name).keys.to_h do |line_number|
+        [line_number, finder.build_line(file_name, line_number)]
+      end
+    end
+  end
+end

data/lib/plugins/uncov/report/filters/simplecov.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+# report only files lines from the simplecov
+module Uncov::Report::Filters::Simplecov
+  class << self
+    def description = 'Report missing coverage on files tracked with simplecov'
+    def simplecov_trigger = :file_system
+
+    def files(finder)
+      finder.simplecov_files.file_names.map do |file_name|
+        Uncov::Report::File.new(
+          file_name:,
+          git: finder.git_files.file?(file_name),
+          lines: lines(finder, file_name)
+        )
+      end
+    end
+
+    private
+
+    def lines(finder, file_name)
+      lines_hash = file_lines(finder, file_name)
+      Uncov::Report::Context.add_context(finder, file_name, lines_hash)
+      lines_hash.sort.to_h.values
+    end
+
+    def file_lines(finder, file_name)
+      finder.file_system_files.lines(file_name).keys.to_h do |line_number|
+        [line_number, finder.build_line(file_name, line_number)]
+      end
+    end
+  end
+end

data/lib/uncov/cli.rb

@@ -6,9 +6,9 @@ require 'optparse'
 class Uncov::CLI
   def self.start(args)
     Uncov.configure(args)
-    report = Uncov::Report.build
+    report = Uncov::Report.generate
     Uncov::Formatter.output(report)
-    !report.uncov?
+    !report.trigger?
   rescue StandardError => e
     raise if Uncov.configuration.debug
 

data/lib/uncov/configuration/option.rb

@@ -2,16 +2,16 @@
 
 # configuration option
 class Uncov::Configuration::Option
-  attr_reader :name, :description, :options, :default, :allowed_values, :value_parse, :value
+  attr_reader :name, :description, :options, :default, :value_parse, :value
 
   def initialize(name, description, options, default, allowed_values, value_parse)
     @name = name
     @description = description
     @options = Array(options)
     @default = default.freeze
+    @value = default
     @allowed_values = allowed_values
     @value_parse = value_parse
-    self.value = default
   end
 
   def value=(value)
@@ -41,10 +41,16 @@ class Uncov::Configuration::Option
       if value == default
         "#{value.inspect}(default)"
       else
-        # :nocov: for now as there is no case yet in Configuration
         value.inspect
-        # :nocov:
       end
     end
   end
+
+  def allowed_values
+    if @allowed_values.respond_to?(:call)
+      @allowed_values = @allowed_values.call
+    else
+      @allowed_values
+    end
+  end
 end

data/lib/uncov/configuration.rb

@@ -1,11 +1,12 @@
 # frozen_string_literal: true
 
 require_relative 'formatter'
-require_relative 'report'
+require_relative 'report/filters'
 
 # handle configuration for uncov
 class Uncov::Configuration
   CONFIG_FILE = '.uncov'
+  # equivalent of `shopt -s extglob dotglob globstar` for testing with `bash` & `ls`
   FILE_MATCH_FLAGS = File::FNM_EXTGLOB | File::FNM_PATHNAME | File::FNM_DOTMATCH
 
   class << self
@@ -19,16 +20,23 @@ class Uncov::Configuration
   end
 
   option 'target', 'Target branch for comparison', options: ['-t', '--target TARGET'], default: 'HEAD'
-  option 'report', 'Report type to generate', options: ['-r', '--report TYPE'], default: 'diff_lines', allowed_values: Uncov::Report.types
+  option 'report', 'Report filter to generate file/line list',
+         options: ['-r', '--report FILTER'], default: 'DiffLines', allowed_values: -> { Uncov::Report::Filters.filters.keys }
   option 'output_format', 'Output format',
-         options: ['-o', '--output-format FORMAT'], default: 'terminal', allowed_values: Uncov::Formatter.formats
+         options: ['-o', '--output-format FORMAT'], default: 'Terminal', allowed_values: -> { Uncov::Formatter.formatters.keys }
   option 'context', 'Additional lines context in output',
          options: ['-C', '--context LINES_NUMBER'], default: 1, value_parse: lambda(&:to_i)
   option 'test_command', 'Test command that generates SimpleCov',
          options: '--test-command COMMAND', default: 'COVERAGE=true bundle exec rake test'
   option 'simplecov_file', 'SimpleCov results file', options: '--simplecov-file PATH', default: 'autodetect'
-  option 'relevant_files', 'Relevant files shell filename globing: https://ruby-doc.org/core-3.1.1/File.html#method-c-fnmatch',
-         options: '--relevant-files', default: '{{bin,exe,exec}/*,{app,lib}/**/*.{rake,rb},Rakefile}'
+  option 'relevant_files', 'Only show uncov for matching code files AND trigger tests if matching code files are newer than the report',
+         options: '--relevant-files FN_GLOB', default: '{{bin,exe,exec}/*,{app,lib}/**/*.{rake,rb},Rakefile}'
+  option 'relevant_tests', 'Trigger tests if matching test files are newer than the report',
+         options: '--relevant-tests FN_GLOB', default: '{test,spec}/**/*_{test,spec}.rb'
+  option 'nocov_ignore', 'Ignore :nocov: markers - consider all lines',
+         options: '--nocov-ignore', default: false, value_parse: ->(_value) { true }
+  option 'nocov_covered', 'Report :nocov: lines that have coverage',
+         options: '--nocov-covered', default: false, value_parse: ->(_value) { true }
   option 'debug', 'Get some insights', options: '--debug', default: false, value_parse: ->(_value) { true }
 
   def initialize
@@ -66,16 +74,40 @@ class Uncov::Configuration
   def parser_header(parser) = parser.banner = 'Usage: uncov [options]'
 
   def parser_footer(parser)
-    parser.on('-v', '--version', 'Show version') do
-      puts "uncov #{Uncov::VERSION} by Michal Papis <mpapis@gmail.com>"
-      throw :exit, 0
-    end
     parser.on('-h', '--help', 'Print this help') do
-      puts parser
-      puts "uncov #{Uncov::VERSION} by Michal Papis <mpapis@gmail.com>"
+      puts parser.help
       throw :exit, 0
     end
+    footer_extras(parser)
   end
 
-  def options = @options ||= {}
+  def footer_extras(parser)
+    # TODO: the release workflow does not like ' in help, please avoid it - or fix the workflow
+    parser.separator <<~HELP
+
+      Report FILTERs:
+      #{footer_extras_types}
+
+      Report FILTERs take NOTICE:
+      git*/diff*  - filters will not consider new files unless added to the git index with `git add`.
+      nocov*      - filters/flags only work with coverage/.resultset.json SimpleCov files,
+                    coverage.json does not provide the information needed.
+
+      FN_GLOB: shell filename globing -> https://ruby-doc.org/core-3.1.1/File.html#method-c-fnmatch
+               in bash: `shopt -s extglob dotglob globstar` and test with `ls {app,lib}/**/*.rb`
+
+      uncov #{Uncov::VERSION} by Michal Papis <mpapis@gmail.com>
+    HELP
+  end
+
+  def footer_extras_types
+    report_type_length = Uncov::Report::Filters.filters.keys.map(&:length).max
+    Uncov::Report::Filters.filters.map do |name, filter|
+      format("%#{report_type_length}s - %s", name, filter.description)
+    end.join("\n")
+  end
+
+  def options
+    @options ||= {}
+  end
 end

data/lib/uncov/finder/file_system.rb

@@ -4,15 +4,25 @@
 class Uncov::Finder::FileSystem
   include Uncov::Cache
 
-  def files = all_files.to_h { |file_name| [file_name, lines_proc(file_name)] }
+  def code_files
+    list_files(Uncov.configuration.relevant_files).to_h do |file_name|
+      [file_name, read_lines(file_name)]
+    end
+  end
+
+  def simplecov_trigger_files
+    code_files.keys + test_files
+  end
 
   private
 
-  def all_files
-    Dir.glob(Uncov.configuration.relevant_files, Uncov::Configuration::FILE_MATCH_FLAGS).select { |f| File.file?(f) }
+  def test_files
+    list_files(Uncov.configuration.relevant_tests)
   end
 
-  def lines_proc(file_name) = -> { cache(file_name) { read_lines(file_name) } }
+  def list_files(glob)
+    Dir.glob(glob, Uncov::Configuration::FILE_MATCH_FLAGS).select { |f| File.file?(f) }
+  end
 
   def read_lines(file_name)
     File.readlines(file_name).each_with_index.to_h { |line, line_index| [line_index + 1, line.rstrip] }

data/lib/uncov/finder/files.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+# wrap finder results to have the same interface as finder
+class Uncov::Finder::Files
+  attr_reader :files
+
+  def initialize(files)
+    @files = files
+  end
+
+  def file?(file_name)
+    @files.key?(file_name)
+  end
+
+  def file_names
+    @files.keys
+  end
+
+  def lines(file_name)
+    @files[file_name] || {}
+  end
+
+  def line(file_name, line_number)
+    @files.dig(file_name, line_number)
+  end
+
+  def line?(file_name, line_number)
+    lines(file_name)&.key?(line_number)
+  end
+end

data/lib/uncov/finder/git.rb

@@ -3,14 +3,34 @@
 require_relative 'git_base'
 
 # collect list of files stored in git
-module Uncov::Finder::Git
-  class << self
-    include Uncov::Finder::GitBase
+class Uncov::Finder::Git
+  include Uncov::Finder::GitBase
 
-    def files
-      open_repo.ls_files.keys.filter_map do |file_name|
-        [file_name, true] if relevant_file?(file_name)
+  def code_files
+    cache(:code_files) do
+      all_file_names.filter_map do |file_name|
+        [file_name, true] if relevant_code_file?(file_name)
       end.to_h
     end
   end
+
+  def simplecov_trigger_files
+    code_files.keys + test_files
+  end
+
+  private
+
+  def test_files
+    cache(:test_files) do
+      all_file_names.select do |file_name|
+        relevant_test_file?(file_name)
+      end
+    end
+  end
+
+  def all_file_names
+    cache(:all_files) do
+      open_repo.ls_files.keys
+    end
+  end
 end

data/lib/uncov/finder/git_base.rb

@@ -4,14 +4,22 @@ require 'git'
 
 # common parts for git finders
 module Uncov::Finder::GitBase
+  include Uncov::Cache
+
   protected
 
-  def relevant_file?(path)
+  def relevant_code_file?(path)
     File.fnmatch?(Uncov.configuration.relevant_files, path, Uncov::Configuration::FILE_MATCH_FLAGS)
   end
 
+  def relevant_test_file?(path)
+    File.fnmatch?(Uncov.configuration.relevant_tests, path, Uncov::Configuration::FILE_MATCH_FLAGS)
+  end
+
   def open_repo
-    ::Git.open('.')
+    cache(:repo) do
+      ::Git.open('.')
+    end
   rescue ArgumentError => e
     raise Uncov::NotGitRepoError, Uncov.configuration.path if e.message.end_with?(' is not in a git working tree')