solargraph_test_coverage 0.2.1 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1038b1738247fe8ef8aa47e6675989d5d1e97e4e18c2f26fb9d6aafceca5f6a6
-  data.tar.gz: 9893901996387356d5547b57aa4ebb787998845976c8d7ae067bba3985acf49e
+  metadata.gz: c76dedeaddccb806778b5846c3587233919f1d78088edde15bb7b61681013896
+  data.tar.gz: 387c79384703dd5e92dddf31995982539a233094c7b985ad2977ff1265b2c16c
 SHA512:
-  metadata.gz: 28ab19d5bfe978d8783bfd03f584b49228cc0d06bf310d8c1b8e5cdc20815d077c8587b3faac1ec1d6ddce6b2f7e7af74ace67a91ca94c0125269536607cad15
-  data.tar.gz: f91c21643e59dd1001712f2e62248adccb52a0032ac6d300177a7779e3283bddca769f67c24b307dcba8947b1b5279607c2e32e532bf1c44b11d419df064f5e7
+  metadata.gz: 8d80b6d4abe2d40414c5dbc84652c1c4161a5b1d439b79e232414a1cbfbab1f27c51cf11e4d00a940309a01d5813ef59b4d88e57374ba1ce8ef81725b56b0c6a
+  data.tar.gz: 8bb2180c520a7b8b1c9dcecb191b68fc3c4be7c68c65cd2b4b5bc1ec6f8a40102f069cba5d0e4edebdd28753631657a4f50eb3886b6cbc1bde74c5cee293f70b

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    solargraph_test_coverage (0.2.1)
+    solargraph_test_coverage (0.2.4)
       solargraph (~> 0.40, > 0.40)
 
 GEM

data/README.md

@@ -39,6 +39,7 @@ test_coverage:
   - test_missing
   exclude_paths:
   - 'app/controller'
+  - 'concerns'
 ```
 
 

data/lib/solargraph_test_coverage/branch.rb

@@ -3,22 +3,15 @@
 module SolargraphTestCoverage
   # Adapted from SimpleCov - Small class that turns branch coverage data into something easier to work with
   class Branch
-    class << self
-      #
-      # Builds an array of Branch objects for every branch in results hash.
-      #
-      # @return [Array]
-      #
-      def build_from(results)
-        results.fetch(:branches, {}).flat_map do |condition, branches|
-          _condition_type, _condition_id, condition_start_line, * = condition
+    def self.build_from(results)
+      results.fetch(:branches, {}).flat_map do |condition, branches|
+        _condition_type, _condition_id, condition_start_line, * = condition
 
-          branches.map do |branch_data, hit_count|
-            type, _id, start_line, _start_col, end_line, _end_col = branch_data
+        branches.map do |branch_data, hit_count|
+          type, _id, start_line, _start_col, end_line, _end_col = branch_data
 
-            new(start_line: start_line, end_line: end_line, coverage: hit_count,
-                inline: start_line == condition_start_line, type: type)
-          end
+          new(start_line: start_line, end_line: end_line, coverage: hit_count,
+              inline: start_line == condition_start_line, type: type)
         end
       end
     end
@@ -33,44 +26,18 @@ module SolargraphTestCoverage
       @type       = type
     end
 
-    #
-    # Predicate method for @inline instance variable
-    #
-    # @return [Boolean]
-    #
     def inline?
       @inline
     end
 
-    #
-    # Return true if there is relevant count defined > 0
-    #
-    # @return [Boolean]
-    #
     def covered?
       coverage.positive?
     end
 
-    #
-    # The line on which we want to report the coverage
-    #
-    # Usually we choose the line above the start of the branch (so that it shows up
-    # at if/else) because that
-    # * highlights the condition
-    # * makes it distinguishable if the first line of the branch is an inline branch
-    #   (see the nested_branches fixture)
-    #
-    # @return [Integer]
-    #
     def report_line
       inline? ? start_line : start_line - 1
     end
 
-    #
-    # Return array with coverage count and badge
-    #
-    # @return [Hash]
-    #
     def report
       { type: type, line: report_line }
     end

data/lib/solargraph_test_coverage/config.rb

@@ -1,81 +1,124 @@
 # frozen_string_literal: true
 
-# frozen_string_literal = true
-
 module SolargraphTestCoverage
-  class Config
-    class << self
-      DEFAULTS = {
-        'preload_rails' => true,         # can be true or false - performance optimization
-        'test_framework' => 'rspec',     # can be 'rspec' or 'minitest'
-        'coverage' => [                  # All diagnostics are enabled by default
-          'line',                        # Specifying an array with fewer diagnostics will overwrite this
-          'branch',
-          'test_failing',
-          'test_missing'
-        ],
-        'exclude_paths' => [             # don't attempt to find/run a spec for files that match these paths
-          'app/controller'
-        ]
-      }.freeze
-
-      def preload_rails?
-        plugin_config['preload_rails']
-      end
+  module Config
+    extend self
 
-      def exclude_paths
-        plugin_config['exclude_paths']
-      end
+    DEFAULTS = {
+      'preload_rails' => true,         # can be true or false - performance optimization
+      'test_framework' => 'rspec',     # can be 'rspec' or 'minitest'
+      'coverage' => [                  # All diagnostics are enabled by default
+        'line',                        # Specifying an array with fewer diagnostics will overwrite this
+        'branch',
+        'test_failing',
+        'test_missing'
+      ],
+      'exclude_paths' => [             # don't attempt to find/run a spec for files that match these paths
+        'app/controller',
+        'concerns'
+      ]
+    }.freeze
 
-      def line_coverage?
-        plugin_config['coverage'].include? 'line'
-      end
+    def preload_rails?
+      plugin_config['preload_rails']
+    end
 
-      def branch_coverage?
-        plugin_config['coverage'].include? 'branch'
-      end
+    def exclude_paths
+      plugin_config['exclude_paths']
+    end
 
-      def test_failing_coverage?
-        plugin_config['coverage'].include? 'test_failing'
-      end
+    def line_coverage?
+      plugin_config['coverage'].include? 'line'
+    end
 
-      def test_missing_coverage?
-        plugin_config['coverage'].include? 'test_missing'
-      end
+    def branch_coverage?
+      plugin_config['coverage'].include? 'branch'
+    end
+
+    def test_failing_coverage?
+      plugin_config['coverage'].include? 'test_failing'
+    end
+
+    def test_missing_coverage?
+      plugin_config['coverage'].include? 'test_missing'
+    end
 
-      def test_framework
-        plugin_config['test_framework']
+    def test_framework
+      plugin_config['test_framework']
+    end
+
+    def test_dir
+      case test_framework
+      when 'rspec'
+        'spec'
+      when 'minitest'
+        'test'
       end
+    end
 
-      def test_dir
-        case test_framework
-        when 'rspec'
-          'spec'
-        when 'minitest'
-          'test'
-        end
+    def test_file_suffix
+      case test_framework
+      when 'rspec'
+        '_spec.rb'
+      when 'minitest'
+        '_test.rb'
       end
+    end
 
-      def test_file_suffix
-        case test_framework
-        when 'rspec'
-          '_spec.rb'
-        when 'minitest'
-          '_test.rb'
-        end
+    def require_testing_framework!
+      case test_framework
+      when 'rspec'
+        require 'rspec/core'
+      when 'minitest'
+        require 'minitest/autorun'
+      else
+        raise UnknownTestingGem
       end
+    end
 
-      private
+    # This gives us a nice speed-boost when running test in child process
+    #
+    # We rescue the LoadError since Solargraph would catch it otherwise,
+    # and not load the plugin at all.
+    #
+    # Adding the spec/ directory to the $LOAD_PATH lets 'require "spec_helper"'
+    # commonly found in rails_helper work.
+    #
+    # If Coverage was started in Rails/Spec helper by SimpleCov,
+    # calling Coverage.result after requiring stops and resets it.
+    #
+    # This is a bit experimental
+    #
+    def preload_rails!
+      return if defined?(Rails) || !File.file?('spec/rails_helper.rb')
 
-      def plugin_config
-        @plugin_config ||= workspace_config.tap do |config|
-          DEFAULTS.each_key { |key| config[key] = DEFAULTS[key] unless config.key?(key) }
-        end
-      end
+      $LOAD_PATH.unshift(test_path) unless $LOAD_PATH.include?(test_path)
+
+      require File.join(test_path, 'rails_helper')
+      Coverage.result(stop: true, clear: true) if Coverage.running?
+
+      true
+    rescue LoadError => e
+      Solargraph::Logging.logger.warn "LoadError when trying to require 'rails_helper'"
+      Solargraph::Logging.logger.warn "[#{e.class}] #{e.message}"
 
-      def workspace_config
-        Solargraph::Workspace::Config.new(Dir.pwd).raw_data.fetch('test_coverage', {})
+      false
+    end
+
+    private
+
+    def plugin_config
+      @plugin_config ||= workspace_config.tap do |config|
+        DEFAULTS.each_key { |key| config[key] = DEFAULTS[key] unless config.key?(key) }
       end
     end
+
+    def workspace_config
+      Solargraph::Workspace::Config.new(Dir.pwd).raw_data.fetch('test_coverage', {})
+    end
+
+    def test_path
+      ReporterHelpers.test_path
+    end
   end
 end

data/lib/solargraph_test_coverage/fork_process.rb

@@ -5,12 +5,9 @@ module SolargraphTestCoverage
   # When called with a block, runs the content of said block in a new (forked) process
   # the return value of the process/block can be captured and used in parent process
   class ForkProcess
-    #
     # Executes block in forked process, and captures returned value of that block
     # Returns result of block
     #
-    # @return [Object]
-    #
     def self.run
       read, write = IO.pipe
 

data/lib/solargraph_test_coverage/reporter_helpers.rb

@@ -0,0 +1,81 @@
+# frozen_string_literal: true
+
+module SolargraphTestCoverage
+  # Some helper functions for the diagnostics
+  module ReporterHelpers
+    def exclude_file?(source_filename)
+      return true if source_filename.start_with? test_path
+
+      Config.exclude_paths.any? { |path| source_filename.sub(Dir.pwd, '').include? path }
+    end
+
+    def test_file(source)
+      relative_filepath = source.location.filename.sub(Dir.pwd, '').split('/').reject(&:empty?)
+      relative_filepath[0] = Config.test_dir
+
+      File.join(Dir.pwd, relative_filepath.join('/')).sub('.rb', Config.test_file_suffix)
+    end
+
+    # @return [Hash]
+    def run_test(source)
+      ForkProcess.run do
+        Coverage.start(lines: true, branches: true)
+        runner = TestRunner.with(test_file(source)).run!
+        Coverage.result.fetch(source.location.filename, {}).merge({ test_status: runner.passed? })
+      end
+    end
+
+    def messages(source, results)
+      messages = [
+        line_warnings(source, results),
+        branch_warnings(source, results),
+        test_passing_error(source, results)
+      ]
+
+      messages.flatten.compact
+    end
+
+    def line_warnings(source, results)
+      uncovered_lines(results).map { |line| line_coverage_warning(source, line) }
+    end
+
+    def branch_warnings(source, results)
+      uncovered_branches(results).map { |branch| branch_coverage_warning(source, branch.report) }
+    end
+
+    def test_passing_error(source, results)
+      results[:test_status] ? [] : [test_failing_error(source)]
+    end
+
+    # Adapted from SingleCov
+    # Coverage returns nil for untestable lines (like 'do', 'end', 'if' keywords)
+    # otherwise returns int showing how many times a line was called
+    #
+    #  [nil, 1, 0, 1, 0] -> [3, 5]
+    #  Returns array of line numbers with 0 coverage
+    def uncovered_lines(results)
+      return [] unless results[:lines]
+
+      results[:lines].each_with_index
+                     .select { |c, _| c&.zero? }
+                     .map { |_, i| i }
+                     .compact
+    end
+
+    def uncovered_branches(results)
+      Branch.build_from(results).reject(&:covered?)
+    end
+
+    def range(start_line, start_column, end_line, end_column)
+      Solargraph::Range.from_to(start_line, start_column, end_line, end_column).to_hash
+    end
+
+    def self.test_path
+      File.join(Dir.pwd, Config.test_dir)
+    end
+
+    def test_path
+      ReporterHelpers.test_path
+    end
+  end
+end

data/lib/solargraph_test_coverage/test_coverage_reporter.rb

@@ -3,11 +3,8 @@
 # test_coverage reporter for Solargraph
 module SolargraphTestCoverage
   class TestCoverageReporter < Solargraph::Diagnostics::Base
-    include Helpers
+    include ReporterHelpers
 
-    # LSP Diagnostic method
-    # @return [Array]
-    #
     def diagnose(source, _api_map)
       return [] if source.code.empty? || exclude_file?(source.location.filename)
       return [test_missing_error(source)] unless File.file?(test_file(source))
@@ -20,43 +17,6 @@ module SolargraphTestCoverage
 
     private
 
-    # Compiles all diagnostic messages for source file
-    # @return [Array]
-    #
-    def messages(source, results)
-      messages = [
-        line_warnings(source, results),
-        branch_warnings(source, results),
-        test_passing_error(source, results)
-      ]
-
-      messages.flatten.compact
-    end
-
-    # Creates array of warnings for uncovered lines
-    # @return [Array]
-    #
-    def line_warnings(source, results)
-      uncovered_lines(results).map { |line| line_coverage_warning(source, line) }
-    end
-
-    # Creates array of warnings for uncovered branches
-    # @return [Array]
-    #
-    def branch_warnings(source, results)
-      uncovered_branches(results).map { |branch| branch_coverage_warning(source, branch.report) }
-    end
-
-    # Creates array containing error for failing spec
-    # @return [Array]
-    #
-    def test_passing_error(source, results)
-      results[:test_status] ? [] : [test_failing_error(source)]
-    end
-
-    # Creates LSP warning message for missing line coverage
-    # @return [Hash]
-    #
     def line_coverage_warning(source, line)
       return unless Config.line_coverage?
 
@@ -68,11 +28,6 @@ module SolargraphTestCoverage
       }
     end
 
-    # Creates LSP warning message for missing branch coverage
-    # Line numbers are off by 1, since Branch Coverage starts counting at 1, not 0
-    #
-    # @return [Hash]
-    #
     def branch_coverage_warning(source, report)
       return unless Config.branch_coverage?
 
@@ -84,9 +39,6 @@ module SolargraphTestCoverage
       }
     end
 
-    # Creates LSP error message if test file is failing
-    # @return [Hash]
-    #
     def test_failing_error(source)
       return unless Config.test_failing_coverage?
 
@@ -98,19 +50,14 @@ module SolargraphTestCoverage
       }
     end
 
-    #
-    # Creates LSP error message if no test file can be found
-    #
-    # @return [Hash]
-    #
     def test_missing_error(source)
       return unless Config.test_missing_coverage?
 
       {
         range: range(0, 0, 0, source.code.lines[0].length),
-        severity: Solargraph::Diagnostics::Severities::ERROR,
+        severity: Solargraph::Diagnostics::Severities::HINT,
         source: 'TestCoverage',
-        message: "No unit test file found at #{test_file(source)}"
+        message: "No test file found at '#{test_file(source).sub("#{Dir.pwd}/", '')}'"
       }
     end
   end

data/lib/solargraph_test_coverage/test_runner.rb

@@ -18,10 +18,14 @@ module SolargraphTestCoverage
     end
 
     def run!
-      @result = test_framework_runner.run([@test_file])
+      @result = test_framework_runner.run(test_options)
       self
     end
 
+    def test_options
+      raise NotImplementedError
+    end
+
     def passed?
       raise NotImplementedError
     end
@@ -33,6 +37,10 @@ module SolargraphTestCoverage
 
   # Test Runner Subclass for RSpec
   class RSpecRunner < TestRunner
+    def test_options
+      [@test_file, '-o', '/dev/null']
+    end
+
     def passed?
       @result&.zero?
     end
@@ -44,6 +52,10 @@ module SolargraphTestCoverage
 
   # Test Runner Subclass for Minitest
   class MinitestRunner < TestRunner
+    def test_options
+      [@test_file]
+    end
+
     def passed?
       @result
     end

data/lib/solargraph_test_coverage/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SolargraphTestCoverage
-  VERSION = '0.2.1'
+  VERSION = '0.2.5'
 end

data/lib/solargraph_test_coverage.rb

@@ -3,7 +3,7 @@
 require 'solargraph_test_coverage/version'
 require 'solargraph_test_coverage/branch'
 require 'solargraph_test_coverage/fork_process'
-require 'solargraph_test_coverage/helpers'
+require 'solargraph_test_coverage/reporter_helpers'
 require 'solargraph_test_coverage/config'
 require 'solargraph_test_coverage/test_runner'
 require 'solargraph_test_coverage/test_coverage_reporter'
@@ -16,8 +16,8 @@ module SolargraphTestCoverage
 
   class UnknownTestingGem < StandardError; end
 
-  Helpers.require_testing_framework!
-  Helpers.preload_rails! if Config.preload_rails?
+  Config.require_testing_framework!
+  Config.preload_rails! if Config.preload_rails?
 
   Solargraph::Diagnostics.register 'test_coverage', TestCoverageReporter
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solargraph_test_coverage
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.5
 platform: ruby
 authors:
 - Cameron Kolkey
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2021-09-01 00:00:00.000000000 Z
+date: 2021-09-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: solargraph
@@ -48,7 +48,7 @@ files:
 - lib/solargraph_test_coverage/branch.rb
 - lib/solargraph_test_coverage/config.rb
 - lib/solargraph_test_coverage/fork_process.rb
-- lib/solargraph_test_coverage/helpers.rb
+- lib/solargraph_test_coverage/reporter_helpers.rb
 - lib/solargraph_test_coverage/test_coverage_reporter.rb
 - lib/solargraph_test_coverage/test_runner.rb
 - lib/solargraph_test_coverage/version.rb

data/lib/solargraph_test_coverage/helpers.rb

@@ -1,125 +0,0 @@
-# frozen_string_literal: true
-
-module SolargraphTestCoverage
-  # Some helper functions for the diagnostics
-  module Helpers
-    # Determines if a file should be excluded from running diagnostics
-    # @return [Boolean]
-    #
-    def exclude_file?(source_filename)
-      return true if source_filename.start_with? test_path
-
-      Config.exclude_paths.each { |path| return true if source_filename.sub(Dir.pwd, '').include? path }
-
-      false
-    end
-
-    # Attempts to find the corresponding unit test file
-    # @return [String]
-    #
-    def test_file(source)
-      relative_filepath = source.location.filename.sub(Dir.pwd, '').split('/').reject(&:empty?)
-      relative_filepath[0] = Config.test_dir
-
-      File.join(Dir.pwd, relative_filepath.join('/'))
-          .sub('.rb', Config.test_file_suffix)
-    end
-
-    # Runs test file in a child process with specified testing framework
-    # Returns coverage results for current working file
-    #
-    # @return [Hash]
-    #
-    def run_test(source)
-      ForkProcess.run do
-        Coverage.start(lines: true, branches: true)
-        runner = TestRunner.with(test_file(source)).run!
-        Coverage.result.fetch(source.location.filename, {}).merge({ test_status: runner.passed? })
-      end
-    end
-
-    # Adapted from SingleCov
-    # Coverage returns nil for untestable lines (like do, end, if keywords)
-    # otherwise returns int showing how many times a line was called
-    #
-    #  [nil, 1, 0, 1, 0] -> [3, 5]
-    #
-    # @return [Array]
-    #
-    def uncovered_lines(results)
-      results.fetch(:lines)
-             .each_with_index
-             .select { |c, _| c&.zero? }
-             .map { |_, i| i }
-             .compact
-    end
-
-    # Builds a new Branch object for each branch tested from results hash
-    # Then removes branches which have test coverage
-    #
-    # @return [Array]
-    #
-    def uncovered_branches(results)
-      Branch.build_from(results).reject(&:covered?)
-    end
-
-    # Builds a range for warnings/errors
-    # @return [Hash]
-    #
-    def range(start_line, start_column, end_line, end_column)
-      Solargraph::Range.from_to(start_line, start_column, end_line, end_column).to_hash
-    end
-
-    # requires the specified testing framework
-    # @return [Boolean]
-    #
-    def self.require_testing_framework!
-      case Config.test_framework
-      when 'rspec'
-        require 'rspec/core'
-      when 'minitest'
-        require 'minitest/autorun'
-      else
-        raise UnknownTestingGem
-      end
-    end
-
-    # Only called once, when gem is loaded
-    # Preloads rails via spec/rails_helper if Rails isn't already defined
-    # This gives us a nice speed-boost when running test in child process
-    #
-    # We rescue the LoadError since Solargraph would catch it otherwise,
-    # and not load the plugin at all.
-    #
-    # Adding the spec/ directory to the $LOAD_PATH lets 'require "spec_helper"'
-    # commonly found in rails_helper work.
-    #
-    # If Coverage was started in Rails/Spec helper by SimpleCov,
-    # calling Coverage.result after requiring stops and resets it.
-    #
-    # This is a bit experimental - I'm not sure if there will be downstream side-effects
-    # from having Rails preloaded, but... we'll see :)
-    #
-    # @return [Boolean]
-    #
-    def self.preload_rails!
-      return if defined?(Rails) || !File.file?('spec/rails_helper.rb')
-
-      $LOAD_PATH.unshift(test_path) unless $LOAD_PATH.include?(test_path)
-
-      require File.join(test_path, 'rails_helper')
-      Coverage.result(stop: true, clear: true) if Coverage.running?
-
-      true
-    rescue LoadError => e
-      Solargraph::Logging.logger.warn "LoadError when trying to require 'rails_helper'"
-      Solargraph::Logging.logger.warn "[#{e.class}] #{e.message}"
-
-      false
-    end
-
-    def test_path
-      File.join(Dir.pwd, Config.test_dir)
-    end
-  end
-end