simplecov-rspec 0.4.4 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 484e82254055894678693503184af02dd373567de941c2e23b5171a2b1d43099
-  data.tar.gz: 2b75d02a33e196bb9a8d0e802d88e5ff56cf4b5afccf6518d5d45db49548aee3
+  metadata.gz: 66e26ea8073a8373f072d8b58d5a11825fc26798d76b9ecf13b225279edfa06f
+  data.tar.gz: 59759b57e676fa16bbebd8d423dcf9852a3d4550c3b3864211c937003191c755
 SHA512:
-  metadata.gz: 55816daa25c63ff70efaa2ecd127467384d9cc70bfa6bd0006789dbf4ae731f41a0423a803d8e6d56ec9139c08a98ce72d6577181c8845ae5d85e592e884de42
-  data.tar.gz: f6e35a9fa9fb61073e1881112be2b035955089b65f86ed7c22beda11aef5d67b4c1d943ecd2a67f964220e6c449445fee8b1d32b3b4214891ce3b62595ad3c8b
+  metadata.gz: 253e3bbfe90ac2bc476f7e81eb9926f2457fb0b9a1cf4a066d116cdad7c2db00f15a33fa9a4622265580b309eead7b30ccadb0ef6ddc37936a9b52ecb9d0f369
+  data.tar.gz: 0b0c8be4624b3f85d3ede8bbb5f64b4a3e71d8287f27fd7a46e102b01318558c1c91b5b59fa2ff1c5505ff65513295da0a6495415b9a056c15fa736f06b63b41

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.4.4"
+  ".": "1.0.0"
 }

data/.rubocop.yml

@@ -4,7 +4,7 @@ inherit_gem:
 AllCops:
   # RuboCop enforces rules depending on the oldest version of Ruby which
   # your project supports:
-  TargetRubyVersion: 3.1
+  TargetRubyVersion: 3.2
 
 Style/StderrPuts:
   Enabled: false

data/CHANGELOG.md

@@ -4,6 +4,19 @@ Changes for each release are listed in this file.
 
 This project adheres to [Semantic Versioning](https://semver.org/) for its releases.
 
+## [1.0.0](https://github.com/main-branch/simplecov-rspec/compare/v0.4.4...v1.0.0) (2026-08-05)
+
+
+### ⚠ BREAKING CHANGES
+
+* `coverage_threshold:` and `list_uncovered_lines:` are removed in favor of `minimum_coverage:` and `list_uncovered:`; the `LIST_UNCOVERED_LINES` env var is removed in favor of `LIST_UNCOVERED`; and `COVERAGE_THRESHOLD` now sets only the line-coverage threshold instead of an overall coverage percentage. Update calls to `SimpleCov::RSpec.start` and any CI environment variables accordingly.
+* drops support for Ruby 3.1 and JRuby 9.4; the minimum is now Ruby 3.2 (or JRuby 10, which reports RUBY_VERSION 3.4).
+
+### Features
+
+* Rely on SimpleCov's own minimum_coverage instead of reimplementing it ([d2fed78](https://github.com/main-branch/simplecov-rspec/commit/d2fed78ff5e5cb2bbf18bc89cb3b301455de0bce))
+* Require Ruby >= 3.2, matching SimpleCov 1.0's own floor ([9452587](https://github.com/main-branch/simplecov-rspec/commit/9452587137e1b698019d4214981f82ed796b9c1d))
+
 ## [0.4.4](https://github.com/main-branch/simplecov-rspec/compare/v0.4.3...v0.4.4) (2026-04-24)
 
 

data/README.md

@@ -8,10 +8,14 @@
 Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-%23FE5196?logo=conventionalcommits&logoColor=white)](https://conventionalcommits.org)
 [![Slack](https://img.shields.io/badge/slack-main--branch/simplecov--rspec-yellow.svg?logo=slack)](https://main-branch.slack.com/archives/C07MCM9J72B)
 
-`simplecov-rspec` is a Ruby gem that integrates SimpleCov with RSpec to ensure your
-tests meet a minimum coverage threshold. It enhances your test suite by automatically
-failing tests when coverage falls below a specified threshold and, optionally,
-listing uncovered lines to help you improve coverage.
+`simplecov-rspec` is a Ruby gem that integrates SimpleCov with RSpec. SimpleCov
+(`>= 1.0`) already enforces `minimum_coverage` for line, branch, and method coverage
+and fails the build when a threshold is missed. This gem layers three things on top
+that SimpleCov doesn't do on its own:
+
+1. Suppresses coverage failures when RSpec is run in dry-run mode (e.g. from an IDE).
+2. Lists (or summarizes) the individual uncovered lines, branches, and methods.
+3. Lets all of the above be overridden from the environment, for CI.
 
 When `simplecov-rspec` is used, RSpec will report an error if the percent of test
 coverage falls below a defined threshold:
@@ -19,10 +23,10 @@ coverage falls below a defined threshold:
 ```text
 Coverage report generated for RSpec to /Projects/example_project/coverage. 284 / 286 LOC (99.3%) covered.
 
-FAIL: RSpec Test coverage fell below 100%
+Line coverage (99.3%) is below the expected minimum coverage (100.00%).
 ```
 
-If configured to list the lines that were not covered by tests, RSpec will additionally output:
+If configured to list the items that were not covered by tests, RSpec will additionally output:
 
 ```text
 2 lines are not covered by tests:
@@ -30,16 +34,18 @@ If configured to list the lines that were not covered by tests, RSpec will addit
   ./lib/example_project.rb:75
 ```
 
-* [Installation](#installation)
-* [Getting started](#getting-started)
-    * [Basic setup](#basic-setup)
-    * [Configuration from environment variables](#configuration-from-environment-variables)
-* [Development](#development)
-* [Contributing](#contributing)
-    * [Commit message guidelines](#commit-message-guidelines)
-    * [Pull request guidelines](#pull-request-guidelines)
-* [License](#license)
-* [Code of conduct](#code-of-conduct)
+- [Installation](#installation)
+- [Getting started](#getting-started)
+  - [Basic setup](#basic-setup)
+  - [Listing uncovered items](#listing-uncovered-items)
+  - [Configuration block](#configuration-block)
+  - [Configuration from environment variables](#configuration-from-environment-variables)
+- [Development](#development)
+- [Contributing](#contributing)
+  - [Commit message guidelines](#commit-message-guidelines)
+  - [Pull request guidelines](#pull-request-guidelines)
+- [License](#license)
+- [Code of conduct](#code-of-conduct)
 
 ## Installation
 
@@ -48,13 +54,13 @@ To install the gem, add to the following line to your application's gemspec OR G
 gemspec:
 
 ```ruby
-  spec.add_development_dependency "simplecov-rspec", '~> 0.1'
+  spec.add_development_dependency "simplecov-rspec", '~> 1.0'
 ```
 
 Gemfile:
 
 ```ruby
-gem "simplecov-rspec", "~> 0.1", groups: [:development, :test]
+gem "simplecov-rspec", "~> 1.0", groups: [:development, :test]
 ```
 
 and then run `bundle install`
@@ -102,54 +108,105 @@ This is equivalent to starting with the following options:
 
 ```ruby
 SimpleCov::RSpec.start(
-    coverage_threshold: 100,
+    minimum_coverage: { line: 100 },
     fail_on_low_coverage: true,
-    list_uncovered_lines: false
+    list_uncovered: false,
+    list_uncovered_detail: true
 )
 ```
 
-The test coverage threshold is the minimum percent of lines covered by tests as
-tracked by SimpleCov.
+`minimum_coverage` is the minimum percent of lines (and, optionally, branches and
+methods) covered by tests, enforced by SimpleCov itself.
 
-To initialize SimpleCov with a test coverage threshold less than 100%:
+To require less than 100% line coverage:
 
 ```ruby
-SimpleCov::RSpec.start(coverage_threshold: 90)
+SimpleCov::RSpec.start(minimum_coverage: 90)
 ```
 
+To also require branch (and/or method) coverage, pass a Hash. Any criterion named
+here is automatically enabled via `SimpleCov.enable_coverage`:
+
+```ruby
+SimpleCov::RSpec.start(minimum_coverage: { line: 100, branch: 90 })
+```
+
+### Listing uncovered items
+
+To list the individual lines, branches, and/or methods that are not covered, set
+`list_uncovered`. It accepts `:all`, a single criterion, or an Array of criteria —
+independent of what `minimum_coverage` enforces:
+
+```ruby
+SimpleCov::RSpec.start(minimum_coverage: { line: 100, branch: 90 }, list_uncovered: :all)
+```
+
+```text
+1 line is not covered by tests:
+  ./lib/example_project.rb:74
+
+1 branch is not covered by tests:
+  ./lib/example_project.rb:82 (else branch)
+```
+
+For a quieter CI log, set `list_uncovered_detail: false` to print only the count per
+criterion, along with a hint on how to see the details:
+
+```ruby
+SimpleCov::RSpec.start(list_uncovered: :all, list_uncovered_detail: false)
+```
+
+```text
+2 lines are not covered by tests.
+1 branch is not covered by tests.
+
+Run with LIST_UNCOVERED_DETAIL=true to see the uncovered lines and branches.
+```
+
+### Configuration block
+
 A configuration block can be given to the `start` method to further configure
 SimpleCov:
 
 ```ruby
 # Initialize SimpleCov with a specific formatter
-SimpleCov::RSpec.start { formatter = SimpleCov::Formatter::LcovFormatter }
+SimpleCov::RSpec.start { formatter SimpleCov::Formatter::LcovFormatter }
 ```
 
-This block is passed on to `SimpleCov::RSpec.start`. See [Configuring
-SimpleCov](https://github.com/simplecov-ruby/simplecov?tab=readme-ov-file#configuring-simplecov)
+This block is passed on to `SimpleCov.start`. See [Configuring
+SimpleCov](https://github.com/simplecov-ruby/simplecov?tab=readme-ov-file#configuration)
 for details.
 
 ### Configuration from environment variables
 
 Environment variables can be used to configure `simplecov-rspec`. These environment
-variables take presidence over the values passed to `SimpleCov::RSpec.start`.
-
-* **`COVERAGE_THRESHOLD`**: Sets the minimum coverage threshold (0-100). Overrides
-  `coverage_threshold`.
+variables take precedence over the values passed to `SimpleCov::RSpec.start`.
+
+* **`COVERAGE_THRESHOLD`**: Sets the minimum line coverage threshold (0-100). Overrides
+  `minimum_coverage[:line]`.
+* **`COVERAGE_THRESHOLD_BRANCH`**: Sets the minimum branch coverage threshold (0-100), and
+  enables branch coverage. Overrides `minimum_coverage[:branch]`.
+* **`COVERAGE_THRESHOLD_METHOD`**: Sets the minimum method coverage threshold (0-100), and
+  enables method coverage. Overrides `minimum_coverage[:method]`.
 * **`FAIL_ON_LOW_COVERAGE`**: Controls whether tests fail if coverage is below the threshold.
   Set to 'true', 'yes', 'on', or '1' (case insensitive) to enable.
-* **`LIST_UNCOVERED_LINES`**: Determines if uncovered lines are listed. Set to 'true',
-  'yes', 'on', or '1' (case insensitive) to enable.
+* **`LIST_UNCOVERED`**: Controls which criteria to list uncovered items for. Set to 'all',
+  'true', 'yes', 'on', or '1' to report every criterion; 'false', 'no', 'off', or '0' to
+  report none; or a comma-separated list, e.g. `line,branch`.
+* **`LIST_UNCOVERED_DETAIL`**: Controls whether uncovered items are listed individually, or
+  just summarized as a count per criterion. Set to 'true', 'yes', 'on', or '1' (case
+  insensitive) to show individual items.
 
 For example, here is a bash script to run tests in an infinite loop while writing
 test output to `fail.txt`:
 
 ```bash
-while true; do COV_NO_FAIL=TRUE rspec >> fail.txt; done
+while true; do FAIL_ON_LOW_COVERAGE=false rspec >> fail.txt; done
 ```
 
-In a CI system, you might want to set `LIST_UNCOVERED_LINES=yes` in order to list
-uncovered lines on different platforms than the one you run for local development.
+In a CI system, you might want to set `LIST_UNCOVERED=all` in order to list uncovered
+lines, branches, and methods on a platform other than the one you use for local
+development.
 
 ## Development
 

data/lib/simplecov-rspec/list_uncovered_option.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module SimpleCov
+  class RSpec
+    # Resolves the `list_uncovered:` option (plus its `LIST_UNCOVERED` ENV override)
+    # into a normalized Array<Symbol>, in a fixed line/branch/method order.
+    #
+    # @api private
+    #
+    module ListUncoveredOption
+      # The coverage criteria this gem knows how to report on
+      ALL_CRITERIA = %i[line branch method].freeze
+
+      # LIST_UNCOVERED environment variable values that mean "every criterion"
+      ALL_ENV_VALUES = %w[yes on true 1 all].freeze
+
+      # LIST_UNCOVERED environment variable values that mean "no criteria"
+      NONE_ENV_VALUES = %w[false no off 0].freeze
+
+      module_function
+
+      # Resolve the effective criteria, applying the ENV override if present
+      # @param value [false, :all, Symbol, Array<Symbol>] the `list_uncovered:` argument
+      # @param env [Hash] the environment variables
+      # @param env_var [String] the ENV var name that overrides `value`
+      # @return [Array<Symbol>]
+      # @raise [ArgumentError] if value is not one of the accepted forms, or names an unknown criterion
+      # @example
+      #   ListUncoveredOption.resolve(:all, env: {}, env_var: 'LIST_UNCOVERED') # => [:line, :branch, :method]
+      def resolve(value, env:, env_var:)
+        value = from_env(env.fetch(env_var)) if env.key?(env_var)
+        ALL_CRITERIA & normalize(value)
+      end
+
+      # Parse a raw LIST_UNCOVERED environment variable value
+      # @param raw [String] the raw LIST_UNCOVERED environment variable value
+      # @return [false, :all, Array<Symbol>]
+      # @example
+      #   ListUncoveredOption.from_env('line,branch') # => [:line, :branch]
+      def from_env(raw)
+        raw = raw.strip.downcase
+        return false if raw.empty? || NONE_ENV_VALUES.include?(raw)
+        return :all if ALL_ENV_VALUES.include?(raw)
+
+        raw.split(',').map { |criterion| criterion.strip.to_sym }
+      end
+
+      # Normalize a `list_uncovered:`-style value into an Array of Symbols
+      # @param value [false, true, :all, Symbol, Array<Symbol>]
+      # @return [Array<Symbol>]
+      # @example
+      #   ListUncoveredOption.normalize(:branch) # => [:branch]
+      def normalize(value)
+        case value
+        when nil, false then []
+        when :all       then ALL_CRITERIA
+        when Symbol     then validate([value])
+        when Array      then validate(value)
+        else
+          raise ArgumentError,
+                "list_uncovered must be false, :all, a Symbol, or an Array of Symbols; got #{value.inspect}"
+        end
+      end
+
+      # Raise unless every given criterion is one this gem knows how to report on
+      # @param criteria [Array<Symbol>]
+      # @return [Array<Symbol>]
+      # @raise [ArgumentError] if criteria contains anything outside ALL_CRITERIA
+      # @example
+      #   ListUncoveredOption.validate([:line]) # => [:line]
+      def validate(criteria)
+        invalid = criteria - ALL_CRITERIA
+        return criteria if invalid.empty?
+
+        raise ArgumentError, "Unknown coverage criterion #{invalid.inspect}; must be one of #{ALL_CRITERIA.inspect}"
+      end
+    end
+  end
+end

data/lib/simplecov-rspec/uncovered_report.rb

@@ -0,0 +1,186 @@
+# frozen_string_literal: true
+
+module SimpleCov
+  class RSpec
+    # Formats the "uncovered lines/branches/methods" report printed after a run: either
+    # a full listing of every uncovered item, or a per-criterion count with a hint on
+    # how to see the details.
+    #
+    # @api private
+    #
+    class UncoveredReport
+      # Maps a coverage criterion to its [singular, plural] noun, for report formatting
+      # @api private
+      CRITERION_LABELS = {
+        line: %w[line lines],
+        branch: %w[branch branches],
+        method: %w[method methods]
+      }.freeze
+
+      # Build a report for the given result, criteria, and detail level
+      # @param result [SimpleCov::Result] the SimpleCov result to report on
+      # @param criteria [Array<Symbol>] which criteria (:line, :branch, :method) to report
+      # @param detail [Boolean] list individual items, or just a count per criterion
+      # @param detail_env_var [String] the ENV var name to suggest for switching to detail
+      # @example
+      #   UncoveredReport.new(result: SimpleCov.result, criteria: [:line], detail: true, detail_env_var: 'X')
+      def initialize(result:, criteria:, detail:, detail_env_var:)
+        @result = result
+        @criteria = criteria
+        @detail = detail
+        @detail_env_var = detail_env_var
+      end
+
+      # The formatted report text, or an empty string if there is nothing to report
+      # @return [String]
+      def to_s = detail ? detailed_text : summary_text
+
+      private
+
+      # The SimpleCov result being reported on
+      # @return [SimpleCov::Result]
+      # @api private
+      attr_reader :result
+
+      # Which criteria (:line, :branch, :method) to report on
+      # @return [Array<Symbol>]
+      # @api private
+      attr_reader :criteria
+
+      # Whether to list individual items, or just a count per criterion
+      # @return [Boolean]
+      # @api private
+      attr_reader :detail
+
+      # The ENV var name to suggest for switching to detail
+      # @return [String]
+      # @api private
+      attr_reader :detail_env_var
+
+      # The full listing, one blank-line-separated section per criterion
+      # @return [String]
+      def detailed_text
+        criteria.filter_map { |criterion| section(criterion) }.join("\n\n")
+      end
+
+      # A criterion's report section, or nil when nothing is uncovered
+      # @param criterion [Symbol]
+      # @return [String, nil]
+      def section(criterion)
+        items = uncovered_items(criterion)
+        return nil if items.empty?
+
+        ["#{header(criterion, items.count)}:", *items.map { |item| "  #{item}" }].join("\n")
+      end
+
+      # The per-criterion counts, plus a hint on how to see the details
+      # @return [String]
+      def summary_text
+        summarized = criteria.filter_map do |criterion|
+          count = uncovered_count(criterion)
+          [criterion, count] if count.positive?
+        end
+        return '' if summarized.empty?
+
+        counts = summarized.map { |criterion, count| "#{header(criterion, count)}." }.join("\n")
+        "#{counts}\n\nRun with #{detail_env_var}=true to see the uncovered #{noun_list(summarized.map(&:first))}."
+      end
+
+      # The "N lines are not covered by tests" header for a criterion
+      # @param criterion [Symbol]
+      # @param count [Integer]
+      # @return [String]
+      def header(criterion, count)
+        singular, plural = CRITERION_LABELS.fetch(criterion)
+        "#{count} #{pluralize(count, "#{singular} is", "#{plural} are")} not covered by tests"
+      end
+
+      # The formatted, uncovered items for a single criterion, across all files
+      # @param criterion [Symbol]
+      # @return [Array<String>]
+      def uncovered_items(criterion)
+        result.files.flat_map { |file| items_for(file, criterion) }
+      end
+
+      # The count of uncovered items for a single criterion across all files
+      #
+      # @param criterion [Symbol]
+      # @return [Integer]
+      def uncovered_count(criterion)
+        result.files.sum { |file| count_for(file, criterion) }
+      end
+
+      # The formatted, uncovered items of one criterion within a single file
+      # @param file [SimpleCov::SourceFile]
+      # @param criterion [Symbol]
+      # @return [Array<String>]
+      def items_for(file, criterion) = send(:"#{criterion}_items", file)
+
+      # The count of uncovered items of one criterion within a single file
+      # @param file [SimpleCov::SourceFile]
+      # @param criterion [Symbol]
+      # @return [Integer]
+      def count_for(file, criterion) = send(:"#{criterion}_count", file)
+
+      # The formatted, uncovered lines within a single file
+      # @param file [SimpleCov::SourceFile]
+      # @return [Array<String>]
+      def line_items(file) = file.missed_lines.map { |line| "#{project_path(file)}:#{line.number}" }
+
+      # The formatted, uncovered branches within a single file
+      # @param file [SimpleCov::SourceFile]
+      # @return [Array<String>]
+      def branch_items(file) = file.missed_branches.map { |branch| branch_text(file, branch) }
+
+      # The formatted, uncovered methods within a single file
+      # @param file [SimpleCov::SourceFile]
+      # @return [Array<String>]
+      def method_items(file)
+        file.missed_methods.map { |method| "#{project_path(file)}:#{method.start_line} #{method}" }
+      end
+
+      # The count of uncovered lines within a single file
+      # @param file [SimpleCov::SourceFile]
+      # @return [Integer]
+      def line_count(file) = file.missed_lines.count
+
+      # The count of uncovered branches within a single file
+      # @param file [SimpleCov::SourceFile]
+      # @return [Integer]
+      def branch_count(file) = file.missed_branches.count
+
+      # The count of uncovered methods within a single file
+      # @param file [SimpleCov::SourceFile]
+      # @return [Integer]
+      def method_count(file) = file.missed_methods.count
+
+      # A single formatted, uncovered branch
+      # @param file [SimpleCov::SourceFile]
+      # @param branch [SimpleCov::SourceFile::Branch]
+      # @return [String]
+      def branch_text(file, branch) = "#{project_path(file)}:#{branch.report_line} (#{branch.type} branch)"
+
+      # The path to a source file, relative to the project root
+      # @param file [SimpleCov::SourceFile]
+      # @return [String]
+      def project_path(file) = File.join('.', file.project_filename)
+
+      # Join plural nouns into a friendly list, e.g. "lines and branches"
+      # @param criteria_list [Array<Symbol>]
+      # @return [String]
+      def noun_list(criteria_list)
+        nouns = criteria_list.map { |criterion| CRITERION_LABELS.fetch(criterion).last }
+        return nouns.first if nouns.size == 1
+
+        "#{nouns[0..-2].join(', ')} and #{nouns.last}"
+      end
+
+      # Return the singular or plural form of a word based on the count
+      # @param count [Integer] the count
+      # @param singular [String] the singular form of the phrase
+      # @param plural [String] the plural form of the phrase
+      # @return [String]
+      def pluralize(count, singular, plural) = count == 1 ? singular : plural
+    end
+  end
+end

data/lib/simplecov-rspec/version.rb

@@ -3,6 +3,6 @@
 module Simplecov
   class Rspec
     # This gem's version
-    VERSION = '0.4.4'
+    VERSION = '1.0.0'
   end
 end

data/lib/simplecov-rspec.rb

@@ -1,55 +1,59 @@
 # frozen_string_literal: true
 
 require 'simplecov'
+require_relative 'simplecov-rspec/list_uncovered_option'
+require_relative 'simplecov-rspec/uncovered_report'
 
 # SimpleCov namespace
 module SimpleCov
-  # Configure SimpleCov to fail RSpec if the test coverage falls below a given threshold
+  # Configure SimpleCov to enforce coverage thresholds for RSpec, on top of what
+  # SimpleCov itself already provides.
   #
-  # Configures RSpec to:
+  # SimpleCov (>= 1.0) can already enforce `minimum_coverage` for line, branch, and
+  # method coverage, and will exit with a non-zero status when a threshold is missed.
+  # This gem layers three things SimpleCov doesn't do on its own:
   #
-  # 1. Fail (and exit with with a non-zero exitcode) if the test
-  #    coverage is below the configured threshold and
-  # 2. (optionally) list the lines of code not covered by tests.
+  # 1. Suppresses coverage failures when RSpec is run in dry-run mode (e.g. from an IDE).
+  # 2. Lists (or summarizes) the individual uncovered lines, branches, and methods.
+  # 3. Lets all of the above be overridden from the environment, for CI.
   #
-  # Simply add the line `SimpleCov::RSpec.start` in place of `SimpleCov::Start` in
+  # Simply add the line `SimpleCov::RSpec.start` in place of `SimpleCov.start` in
   # the project's `spec_helper.rb`. This line must appear before the project is
   # required.
   #
-  # @example Initialize SimpleCov with defaults
+  # @example Initialize SimpleCov with defaults (100% line coverage required)
   #   SimpleCov::RSpec.start
   #
-  # @example Initialize SimpleCov with a test coverage threshold other than 100%
-  #   SimpleCov::RSpec.start(coverage_threshold: 90, fail_on_low_coverage: true, list_uncovered_lines: false)
+  # @example Require 100% line coverage and 90% branch coverage
+  #   SimpleCov::RSpec.start(minimum_coverage: { line: 100, branch: 90 })
   #
-  # @example Pass a configuration block to SimpleCov::RSpec.start
-  #   SimpleCov::RSpec.start { formatter = SimpleCov::Formatter::LcovFormatter }
+  # @example List every uncovered line, branch, and method when coverage is incomplete
+  #   SimpleCov::RSpec.start(minimum_coverage: { line: 100, branch: 90 }, list_uncovered: :all)
   #
-  # @example Bash script to run tests in an infinite loop writing failures to `fail.txt`:
-  #   while true; do FAIL_ON_LOW_COVERAGE=TRUE rspec >> fail.txt; done
+  # @example Report only counts, with a hint on how to see the details
+  #   SimpleCov::RSpec.start(list_uncovered: :all, list_uncovered_detail: false)
   #
-  # @!attribute [r] env
-  #   Command line environment variables (default: ENV)
-  #   @return [Hash]
-  #   @api private
-  #   @private
-  #
-  # @!attribute [r] simplecov_module
-  #   The SimpleCov module (default: ::SimpleCov)
-  #   @return [Module]
-  #   @api private
-  #   @private
-  #
-  # @!attribute [r] start_config_block
-  #   A configuration block to pass to `SimpleCov.start`
-  #   @return [Proc]
-  #   @api private
-  #   @private
+  # @example Pass a configuration block to SimpleCov.start
+  #   SimpleCov::RSpec.start { formatter SimpleCov::Formatter::LcovFormatter }
   #
   # @api public
   #
   class RSpec
-    # rubocop:disable Layout/LineLength
+    # @!attribute [r] env
+    #   The environment variables consulted for overrides
+    #   @return [Hash]
+    #   @api private
+    #
+    # @!attribute [r] simplecov_module
+    #   The SimpleCov module being configured
+    #   @return [Module]
+    #   @api private
+    #
+    # @!attribute [r] start_config_block
+    #   A configuration block passed through to `SimpleCov.start`
+    #   @return [Proc, nil]
+    #   @api private
+    #
 
     # Configure and start SimpleCov for RSpec
     #
@@ -60,128 +64,153 @@ module SimpleCov
     #
     # @api public
     #
-    # @overload start(coverage_threshold: 100, fail_on_low_coverage: true, list_uncovered_lines: false, rspec_dry_run: ::RSpec.configuration.dry_run?, env: ENV, &start_config_block)
+    # @overload start(minimum_coverage: { line: 100 }, fail_on_low_coverage: true, list_uncovered: false, list_uncovered_detail: true, rspec_dry_run: ::RSpec.configuration.dry_run?, env: ENV, &start_config_block) # rubocop:disable Layout/LineLength
     #
-    #   @param coverage_threshold [Integer] the test coverage threshold (default: 100)
+    #   @param minimum_coverage [Integer, Hash] the minimum coverage threshold (default: `{ line: 100 }`)
     #
-    #     Coverage below this threshold will cause the rspec to fail if
-    #     fail_on_low_coverage is true.
+    #     An Integer sets the line coverage threshold. A Hash sets a threshold per
+    #     criterion, e.g. `{ line: 100, branch: 90, method: 100 }`. Passed straight
+    #     through to `SimpleCov.minimum_coverage`; any criterion given here is
+    #     automatically enabled via `SimpleCov.enable_coverage`.
     #
-    #   @param fail_on_low_coverage [Boolean] whether to fail if the coverage is below the threshold (default: true)
+    #   @param fail_on_low_coverage [Boolean] whether to fail if coverage is below the threshold (default: true)
     #
-    #     This setting will be read from the environment variable FAIL_ON_LOW_COVERAGE if
-    #     it is NOT given in the `.start` method. Setting that environment variable
-    #     to 'true', 'yes', 'on', or '1' will cause this setting to be `false`
-    #     (the logic is inverted). Any other value will cause this seetting to
-    #     be `true`.
+    #     When `false` (or when RSpec is in dry-run mode), `SimpleCov.minimum_coverage`
+    #     is never set, so SimpleCov will not fail the build regardless of coverage.
     #
-    #   @param list_uncovered_lines [Boolean] whether to list the lines not covered by tests (default: false)
+    #     Read from the `FAIL_ON_LOW_COVERAGE` environment variable if set: `true`,
+    #     `yes`, `on`, or `1` (case-insensitive) enables it; anything else disables it.
     #
-    #     All lines not covered by tests will be listed if the coverage is below the threshold.
-    #     Probably only makes sense to use if the threshold is 100%.
+    #   @param list_uncovered [false, :all, Symbol, Array<Symbol>] which coverage criteria to
+    #     list uncovered items for (default: false)
     #
-    #     This setting will be read from the environment variable LIST_UNCOVERED_LINES
-    #     if it is NOT given in the `.start` method. Setting that environment variable
-    #     to 'true', 'yes', 'on', or '1' will cause this setting to be `true`. Any
-    #     other value will cause this setting to be `false`.
+    #     `false` reports nothing. `:all` reports line, branch, and method. A Symbol or
+    #     Array of Symbols (`:line`, `:branch`, `:method`) reports just those criteria,
+    #     independent of what `minimum_coverage` enforces.
     #
-    #   @param start_config_block [Proc] a configuration block to pass to `SimpleCov.start` (default: nil)
+    #     Read from the `LIST_UNCOVERED` environment variable if set: `all`, `true`,
+    #     `yes`, `on`, or `1` means every criterion; `false`, `no`, `off`, or `0` means
+    #     none; otherwise a comma-separated list of criteria, e.g. `line,branch`.
     #
-    #   @param rspec_dry_run [Boolean] whether the rspec run is a dry run
+    #   @param list_uncovered_detail [Boolean] list individual items, or just a count (default: true)
     #
-    #     Typically not set by the user. Used for this gem's unit testing.
+    #     When `false`, only the count of uncovered items per criterion is printed,
+    #     followed by a hint on how to see the details.
     #
-    #     If RSpec is being run in dry run mode, test coverage under the threshold will not fail the build.
+    #     Read from the `LIST_UNCOVERED_DETAIL` environment variable if set: `true`,
+    #     `yes`, `on`, or `1` (case-insensitive) shows details; anything else summarizes.
     #
-    #     The purpose of this is to allow the test coverage to be run in a dry run by an IDE
-    #     so it can report failed tests and coverage without reporting that the entire RSpec
-    #     run has failed.
+    #   @param start_config_block [Proc] a configuration block to pass to `SimpleCov.start` (default: nil)
+    #
+    #   @param rspec_dry_run [Boolean] whether the rspec run is a dry run
+    #
+    #     Typically not set by the user. If RSpec is being run in dry run mode, test
+    #     coverage under the threshold will not fail the build. This allows test
+    #     coverage to be run in a dry run by an IDE so it can report failed tests and
+    #     coverage without reporting that the entire RSpec run has failed.
     #
     #   @param simplecov_module [Module] the SimpleCov module (default: ::SimpleCov)
     #
     #     Typically not set by the user. Used for this gem's unit testing.
     #
-    #     Allows the SimpleCov module to be mocked.
-    #
     #   @param env [Hash] the environment variables (default: ENV)
     #
     #     Typically not set by the user. Used for this gem's unit testing.
     #
     #   @example Initialize SimpleCov with a test coverage threshold other than 100%
-    #     SimpleCov::RSpec.start(coverage_threshold: 90)
+    #     SimpleCov::RSpec.start(minimum_coverage: 90)
     #
     #   @example Initialize SimpleCov to not fail the test run if the coverage is below the threshold
     #     SimpleCov::RSpec.start(fail_on_low_coverage: false)
     #
     #     # OR use an environment variable to override the default
-    #     ENV['FAIL_ON_LOW_COVERAGE'] = 'true'
-    #     SimpleCov::RSpec.start
-    #
-    #     # OR use an environment variable to override the default from the rspec command line
-    #     FAIL_ON_LOW_COVERAGE=TRUE rspec
+    #     FAIL_ON_LOW_COVERAGE=true rspec
     #
-    #   @example Initialize SimpleCov to list the lines not covered by tests
-    #     SimpleCov::RSpec.start(list_uncovered_lines: true)
+    #   @example Initialize SimpleCov to list the lines, branches, and methods not covered by tests
+    #     SimpleCov::RSpec.start(list_uncovered: :all)
     #
     #     # OR use an environment variable to override the default
-    #     ENV['LIST_UNCOVERED_LINES'] = 'true'
-    #     SimpleCov::RSpec.start
-    #
-    #     # OR use an environment variable to override the default from the rspec command line
-    #     LIST_UNCOVERED_LINES=TRUE rspec
+    #     LIST_UNCOVERED=all rspec
     #
     def self.start(...) = new(...).send(:start)
 
-    # rubocop:enable Layout/LineLength
-
-    # Environment variable to override coverage_threshold
+    # Environment variable to override minimum_coverage[:line]
     # @api private
     # @private
     COVERAGE_THRESHOLD = 'COVERAGE_THRESHOLD'
 
+    # Environment variable to override minimum_coverage[:branch]
+    # @api private
+    # @private
+    COVERAGE_THRESHOLD_BRANCH = 'COVERAGE_THRESHOLD_BRANCH'
+
+    # Environment variable to override minimum_coverage[:method]
+    # @api private
+    # @private
+    COVERAGE_THRESHOLD_METHOD = 'COVERAGE_THRESHOLD_METHOD'
+
     # Environment variable to override fail_on_low_coverage
     # @api private
     # @private
     FAIL_ON_LOW_COVERAGE = 'FAIL_ON_LOW_COVERAGE'
 
-    # Environment variable to override list_uncovered_lines
+    # Environment variable to override list_uncovered
+    # @api private
+    # @private
+    LIST_UNCOVERED = 'LIST_UNCOVERED'
+
+    # Environment variable to override list_uncovered_detail
     # @api private
     # @private
-    LIST_UNCOVERED_LINES = 'LIST_UNCOVERED_LINES'
+    LIST_UNCOVERED_DETAIL = 'LIST_UNCOVERED_DETAIL'
 
-    # Default value for coverage_threshold
+    # Maps a coverage criterion to the environment variable that overrides its threshold
     # @api private
     # @private
-    DEFAULT_TEST_COVERAGE_THRESHOLD = 100
+    CRITERION_ENV_VARS = {
+      line: COVERAGE_THRESHOLD,
+      branch: COVERAGE_THRESHOLD_BRANCH,
+      method: COVERAGE_THRESHOLD_METHOD
+    }.freeze
+
+    # Default value for minimum_coverage
+    # @api private
+    # @private
+    DEFAULT_MINIMUM_COVERAGE = { line: 100 }.freeze
 
     # Default value for fail_on_low_coverage
     # @api private
     # @private
-    DEFAULT_FAIL_ON_LOW_COVERAGEERAGE = true
+    DEFAULT_FAIL_ON_LOW_COVERAGE = true
+
+    # Default value for list_uncovered_detail
+    # @api private
+    # @private
+    DEFAULT_LIST_UNCOVERED_DETAIL = true
 
-    # Default value for list_uncovered_lines
+    # Environment variable values that mean "true"
     # @api private
     # @private
-    DEFAULT_LIST_UNCOVERED_LINES = false
+    TRUTHY_ENV_VALUES = %w[yes on true 1].freeze
 
     attr_reader :env, :simplecov_module, :start_config_block
 
-    # The coverage threshold
+    # The minimum coverage threshold, per criterion
     #
-    # Searches the ENV, the value given in the `.start` method, and the default value
-    # and returns the first value found.
+    # Searches the ENV, the value given in the `.start` method, and the default value,
+    # merging them (ENV takes precedence per-criterion).
     #
-    # @return [Integer]
+    # @return [Hash{Symbol => Integer}]
     #
     # @api private
     # @private
     #
-    def coverage_threshold
-      return env.fetch(COVERAGE_THRESHOLD).to_i if env.key?(COVERAGE_THRESHOLD)
-
-      return @coverage_threshold.to_i unless @coverage_threshold.nil?
+    def minimum_coverage
+      base = @minimum_coverage
+      base = { line: base } if base.is_a?(Integer)
+      validate_minimum_coverage!(base)
 
-      DEFAULT_TEST_COVERAGE_THRESHOLD
+      (base || DEFAULT_MINIMUM_COVERAGE).merge(env_minimum_coverage_overrides)
     end
 
     # Whether to fail if the coverage is below the threshold
@@ -196,55 +225,48 @@ module SimpleCov
     #
     def fail_on_low_coverage?
       return false if rspec_dry_run?
-
       return env_true?(FAIL_ON_LOW_COVERAGE) if env.key?(FAIL_ON_LOW_COVERAGE)
-
       return @fail_on_low_coverage unless @fail_on_low_coverage.nil?
 
-      DEFAULT_FAIL_ON_LOW_COVERAGEERAGE
+      DEFAULT_FAIL_ON_LOW_COVERAGE
     end
 
-    # Whether to list the lines not covered by tests
+    # The coverage criteria to list uncovered items for
     #
-    # Searches the ENV, the value given in the `.start` method, and the default value
-    # and returns the first value found.
+    # Searches the ENV and the value given in the `.start` method, and normalizes
+    # the result to an Array of Symbols in a fixed (line, branch, method) order.
     #
-    # @return [Boolean]
+    # @return [Array<Symbol>]
     #
     # @api private
     # @private
     #
-    def list_uncovered_lines?
-      return env_true?(LIST_UNCOVERED_LINES) if env.key?(LIST_UNCOVERED_LINES)
-
-      return @list_uncovered_lines unless @list_uncovered_lines.nil?
-
-      DEFAULT_LIST_UNCOVERED_LINES
+    def list_uncovered_criteria
+      @list_uncovered_criteria ||= ListUncoveredOption.resolve(@list_uncovered, env: env, env_var: LIST_UNCOVERED)
     end
 
-    # Whether the rspec run is a dry run
+    # Whether to list individual uncovered items, or just a count per criterion
     #
     # @return [Boolean]
     #
     # @api private
     # @private
     #
-    def rspec_dry_run? = @rspec_dry_run
+    def list_uncovered_detail?
+      return env_true?(LIST_UNCOVERED_DETAIL) if env.key?(LIST_UNCOVERED_DETAIL)
+      return @list_uncovered_detail unless @list_uncovered_detail.nil?
 
-    # An uncovered line
-    #
-    # @!attribute project_filename [rw]
-    #   The path to the file with uncovered lines relative to the project root
-    #   @return [String]
-    #   @api private
+      DEFAULT_LIST_UNCOVERED_DETAIL
+    end
+
+    # Whether the rspec run is a dry run
     #
-    # @!attribute line_number [rw]
-    #   The line number of the uncovered line
-    #   @return [Integer]
-    #   @api private
+    # @return [Boolean]
     #
     # @api private
-    UncoveredLine = Struct.new(:project_filename, :line_number)
+    # @private
+    #
+    def rspec_dry_run? = @rspec_dry_run
 
     private
 
@@ -255,17 +277,19 @@ module SimpleCov
     # @api private
     # @private
     def initialize(
-      coverage_threshold: nil,
+      minimum_coverage: nil,
       fail_on_low_coverage: nil,
-      list_uncovered_lines: nil,
+      list_uncovered: nil,
+      list_uncovered_detail: nil,
       rspec_dry_run: ::RSpec.configuration.dry_run?,
       env: ENV,
       simplecov_module: ::SimpleCov,
       &start_config_block
     )
-      @coverage_threshold = coverage_threshold
+      @minimum_coverage = minimum_coverage
       @fail_on_low_coverage = fail_on_low_coverage
-      @list_uncovered_lines = list_uncovered_lines
+      @list_uncovered = list_uncovered
+      @list_uncovered_detail = list_uncovered_detail
       @start_config_block = start_config_block
       @rspec_dry_run = rspec_dry_run
       @env = env
@@ -274,15 +298,29 @@ module SimpleCov
 
     # rubocop:enable Metrics/ParameterLists
 
-    # Set the at_exit hook and then configure and start SimpleCov
+    # Configure SimpleCov and start it
     # @return [Void]
     # @api private
     # @private
     def start
       simplecov_module.at_exit(&at_exit_hook)
+      simplecov_module.enable_coverage(*criteria_to_enable) if criteria_to_enable.any?
+      simplecov_module.minimum_coverage(minimum_coverage) if enforce_minimum_coverage?
       simplecov_module.start(&start_config_block)
     end
 
+    # Whether SimpleCov should be configured to enforce minimum_coverage itself
+    # @return [Boolean]
+    # @api private
+    # @private
+    def enforce_minimum_coverage? = !rspec_dry_run? && fail_on_low_coverage?
+
+    # The coverage criteria that need to be enabled via SimpleCov.enable_coverage
+    # @return [Array<Symbol>]
+    # @api private
+    # @private
+    def criteria_to_enable = (minimum_coverage.keys + list_uncovered_criteria).uniq
+
     # Called by SimpleCov.at_exit
     # @return [Proc]
     # @api private
@@ -290,102 +328,87 @@ module SimpleCov
     def at_exit_hook
       lambda do
         simplecov_module.result.format!
-        output_at_exit_report
-        exit 1 if coverage_below_threshold? && fail_on_low_coverage?
+        output_uncovered_report
       end
     end
 
-    # Output the at_exit report
+    # Output the uncovered items report (detailed or summary), if requested
     # @return [Void]
     # @api private
     # @private
-    def output_at_exit_report
-      low_coverage_report if show_low_coverage_report?
-      uncovered_lines_report if show_uncovered_lines_report?
-      $stderr.puts if show_low_coverage_report? || show_uncovered_lines_report?
-    end
+    def output_uncovered_report
+      return if list_uncovered_criteria.empty?
 
-    # Whether to show the low coverage
-    # @return [Boolean]
-    # @api private
-    # @private
-    def show_low_coverage_report? = coverage_below_threshold?
+      report = UncoveredReport.new(
+        result: simplecov_module.result,
+        criteria: list_uncovered_criteria,
+        detail: list_uncovered_detail?,
+        detail_env_var: LIST_UNCOVERED_DETAIL
+      ).to_s
+      return if report.empty?
 
-    # Whether the test coverage is below the threshold
-    # @return [Boolean]
-    # @api private
-    # @private
-    def coverage_below_threshold? = simplecov_module.result.covered_percent < coverage_threshold
+      $stderr.puts
+      $stderr.puts report
+    end
 
-    # Output the low coverage report
+    # Raise unless `base` is a valid `minimum_coverage` value
+    #
+    # Valid values include `nil`, or a Hash keyed by `:line`, `:branch`, and/or
+    # `:method`, with Numeric values
+    #
+    # @param base [nil, Hash] the normalized `minimum_coverage` value
     # @return [Void]
+    # @raise [ArgumentError] if `base` is not nil or a Hash, has an unknown key, or has a
+    #   non-Numeric value
     # @api private
     # @private
-    def low_coverage_report
-      $stderr.puts
-      $stderr.print 'FAIL: ' if fail_on_low_coverage?
-      $stderr.puts "Test coverage is below the low coverage threshold of #{coverage_threshold}%"
-    end
+    def validate_minimum_coverage!(base)
+      unless base.nil? || base.is_a?(Hash)
+        raise ArgumentError, "minimum_coverage must be nil, an Integer, or a Hash; got #{base.inspect}"
+      end
 
-    # Whether there are uncovered lines
-    # @return [Boolean]
-    # @api private
-    def uncovered_lines_found? = simplecov_module.result.files.any? { |source_file| source_file.missed_lines.any? }
+      base&.each_pair { |criterion, threshold| validate_minimum_coverage_entry!(criterion, threshold) }
+    end
 
-    # Whether to show the uncovered lines
-    # @return [Boolean]
+    # Raise unless `criterion` is a known criterion with a Numeric `threshold`
+    # @param criterion [Object] the candidate `minimum_coverage` key
+    # @param threshold [Object] the candidate `minimum_coverage` value
+    # @return [Void]
+    # @raise [ArgumentError] if `criterion` is unknown, or `threshold` is not Numeric
     # @api private
     # @private
-    def show_uncovered_lines_report? = list_uncovered_lines? && uncovered_lines_found?
+    def validate_minimum_coverage_entry!(criterion, threshold)
+      unless CRITERION_ENV_VARS.key?(criterion)
+        raise ArgumentError,
+              "minimum_coverage keys must be #{CRITERION_ENV_VARS.keys.inspect}; got #{criterion.inspect}"
+      end
 
-    # Return the uncovered lines from the SimpleCov result
-    # @return [Array<UncoveredLine>]
-    # @api private
-    def uncovered_lines
-      @uncovered_lines ||=
-        simplecov_module.result.files.flat_map do |source_file|
-          source_file.missed_lines.map do |line|
-            project_filename = File.join('.', source_file.project_filename)
-            UncoveredLine.new(project_filename, line.number)
-          end
-        end
-    end
+      return if threshold.is_a?(Numeric)
 
-    # Return the singular or plural form of a word based on the count
-    # @param count [Integer] the count
-    # @param singular [String] the singular form of the phrase
-    # @param plural [String] the plural form of the phrase
-    # @return [String]
-    # @api private
-    def pluralize(count, singular, plural) = count == 1 ? singular : plural
+      raise ArgumentError,
+            "minimum_coverage[#{criterion.inspect}] must be a Numeric; got #{threshold.inspect}"
+    end
 
-    # Output the uncovered lines
-    # @return [Void]
+    # The per-criterion COVERAGE_THRESHOLD* ENV overrides, as a minimum_coverage Hash
+    # @return [Hash{Symbol => Integer}]
     # @api private
     # @private
-    def uncovered_lines_report
-      $stderr.puts
-      count = uncovered_lines.count
-      things = pluralize(uncovered_lines.count, 'line is', 'lines are')
-      $stderr.puts "#{count} #{things} not covered by tests:\n"
-      uncovered_lines.each do |uncovered_line|
-        $stderr.puts "  #{uncovered_line.project_filename}:#{uncovered_line.line_number}"
+    def env_minimum_coverage_overrides
+      CRITERION_ENV_VARS.each_with_object({}) do |(criterion, var), overrides|
+        overrides[criterion] = env.fetch(var).to_i if env.key?(var)
       end
     end
 
     # Return `true` if the environment variable is set to a truthy value
     #
     # @example
-    #   env_true?('LIST_UNCOVERED_LINES')
+    #   env_true?('LIST_UNCOVERED_DETAIL')
     #
     # @param name [String] the name of the environment variable
     # @return [Boolean]
     # @api private
     # @private
     #
-    def env_true?(name)
-      value = env.fetch(name, '').downcase
-      %w[yes on true 1].include?(value)
-    end
+    def env_true?(name) = TRUTHY_ENV_VALUES.include?(env.fetch(name, '').downcase)
   end
 end

data/release-please-config.json

@@ -6,8 +6,8 @@
       "package-name": "simplecov-rspec",
       "changelog-path": "CHANGELOG.md",
       "version-file": "lib/simplecov-rspec/version.rb",
-      "bump-minor-pre-major": true,
-      "bump-patch-for-minor-pre-major": true,
+      "bump-minor-pre-major": false,
+      "bump-patch-for-minor-pre-major": false,
       "draft": false,
       "prerelease": false,
       "include-component-in-tag": false,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simplecov-rspec
 version: !ruby/object:Gem::Version
-  version: 0.4.4
+  version: 1.0.0
 platform: ruby
 authors:
 - James Couball
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.22'
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -85,14 +85,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.2'
+        version: '13.4'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.2'
+        version: '13.4'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -113,14 +113,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.66'
+        version: '1.89'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.66'
+        version: '1.89'
 - !ruby/object:Gem::Dependency
   name: simplecov-lcov
   requirement: !ruby/object:Gem::Requirement
@@ -149,6 +149,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '4.4'
+- !ruby/object:Gem::Dependency
+  name: irb
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.13'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -198,9 +212,9 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.9'
 description: |
-  Configures RSpec to fail (and exit with with a non-zero exitcode) if the
-  test coverage is below the configured threshold and (optionally) list the
-  lines of code not covered by tests.
+  Configures SimpleCov's line, branch, and method coverage thresholds for RSpec,
+  suppresses failures during RSpec dry runs, and (optionally) lists or summarizes
+  the lines, branches, and methods not covered by tests.
 email:
 - jcouball@yahoo.com
 executables: []
@@ -220,6 +234,8 @@ files:
 - README.md
 - Rakefile
 - lib/simplecov-rspec.rb
+- lib/simplecov-rspec/list_uncovered_option.rb
+- lib/simplecov-rspec/uncovered_report.rb
 - lib/simplecov-rspec/version.rb
 - package.json
 - release-please-config.json
@@ -230,8 +246,8 @@ metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/main-branch/simplecov-rspec
   source_code_uri: https://github.com/main-branch/simplecov-rspec
-  documentation_uri: https://rubydoc.info/gems/simplecov-rspec/0.4.4
-  changelog_uri: https://rubydoc.info/gems/simplecov-rspec/0.4.4/file/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/simplecov-rspec/1.0.0
+  changelog_uri: https://rubydoc.info/gems/simplecov-rspec/1.0.0/file/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
@@ -240,7 +256,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
@@ -248,9 +264,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements:
 - 'Platform: Mac, Linux, or Windows'
-- 'Ruby: MRI 3.1 or later, TruffleRuby 24 or later, or JRuby 9.4 or later'
-rubygems_version: 4.0.6
+- 'Ruby: MRI 3.2 or later, TruffleRuby 24 or later, or JRuby 10 or later'
+rubygems_version: 4.0.16
 specification_version: 4
-summary: Configure SimpleCov to fail RSpec if the test coverage falls below a given
-  threshold
+summary: Configure SimpleCov coverage thresholds and uncovered item reporting for
+  RSpec
 test_files: []