covered 0.26.0 → 0.28.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0b3b51e8cda089a57c22c3ef8e75f7f0da473883048f2526c343eeaff2b96578
-  data.tar.gz: a4ae054e1b15e1c4a0398c2bd2aaa4ee2291fab2d4f3315eaf8e0772b6e5921c
+  metadata.gz: 289a32298170797803df03aec0f13ab6452bcc2787d38e85860ead1bca0b17b0
+  data.tar.gz: 6f682d81566f970a93a4aed6b00e1db77603fcf2a982245e75c60e7c30f15652
 SHA512:
-  metadata.gz: 1e841ed5b73e93b103adae84f250f43e204b75d8acb3de82ef4ec0dc6ef10a2db8c7c28cf00cad3a094678480bf07f7a4425e0f6284ea481f0e70c1ed68f7baa
-  data.tar.gz: 6e9b2dab1f92cf567126d20ea2ec77dfd7c8959ac397b1f73cfd3793d91fc7672408452ef4cf345962e55425ea13014de79a9b16f0978fbc2156a43ac2a0746d
+  metadata.gz: 4495fe21349a2cd25fbfc81e7de1b0d2c00465635f543b991cb8f740e8dad98653dd7a59552e065fb51a5224e39ce12601199ca912fde16033eb43b109f1197d
+  data.tar.gz: e43586380b8587f803c1175f3a919eafd55a860dd61092057ecbf729cce902671e7046fe81fb0baacbd699f4968bdb571b3fe8a10017f80b6341365291584003

data/bake/covered/debug.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022-2024, by Samuel Williams.
+# Copyright, 2022-2025, by Samuel Williams.
 
 def initialize(context)
 	super
 	
-	require_relative '../../lib/covered'
+	require_relative "../../lib/covered"
 end
 
 # Debug the coverage of a file. Show which lines should be executable.

data/bake/covered/policy.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023-2024, by Samuel Williams.
+# Copyright, 2023-2025, by Samuel Williams.
 # Copyright, 2023, by Michael Adams.
 
 def initialize(context)
 	super
 	
-	require_relative '../../lib/covered/config'
+	require_relative "../../lib/covered/config"
 end
 
 # Load the current coverage policy.

data/bake/covered/validate.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2022-2023, by Samuel Williams.
+# Copyright, 2022-2025, by Samuel Williams.
 
 def initialize(context)
 	super
 	
-	require_relative '../../lib/covered/config'
+	require_relative "../../lib/covered/config"
 end
 
 # Validate the coverage of multiple test runs.

data/context/configuration.md

@@ -0,0 +1,355 @@
+# Configuration
+
+This guide will help you to configure covered for your project's specific requirements.
+
+## Quick Start
+
+The simplest way to configure covered is through environment variables:
+
+``` bash
+# Basic coverage with default report
+COVERAGE=true rspec
+
+# Specific report types
+COVERAGE=PartialSummary rspec
+COVERAGE=BriefSummary rspec
+COVERAGE=MarkdownSummary rspec
+
+# Multiple reports (comma-separated)
+COVERAGE=PartialSummary,BriefSummary rspec
+```
+
+## Configuration File
+
+For advanced configuration, create a `config/covered.rb` file in your project:
+
+~~~ ruby
+# config/covered.rb
+
+def ignore_paths
+	super + ["engines/", "app/assets/", "db/migrate/"]
+end
+
+def include_patterns
+	super + ["bake/**/*.rb", "engines/**/*.rb"]
+end
+
+def make_policy(policy)
+	super
+	
+	# Custom policy configuration
+	policy.skip(/\/generated\//)
+	policy.include("lib/templates/**/*.erb")
+end
+~~~
+
+## Environment Variables
+
+Covered uses several environment variables for configuration:
+
+| Variable       | Description                       | Default            |
+|----------------|-----------------------------------|--------------------|
+| `COVERAGE`     | Report types to generate          | `nil` (no reports) |
+| `COVERED_ROOT` | Project root directory            | `Dir.pwd`          |
+| `RUBYOPT`      | Modified internally for autostart | Current value      |
+
+### Examples
+
+``` bash
+# Disable coverage entirely
+unset COVERAGE
+
+# Enable default report (BriefSummary)
+COVERAGE=true
+
+# Custom project root
+COVERED_ROOT=/path/to/project COVERAGE=PartialSummary rspec
+```
+
+## Report Types
+
+Covered provides several built-in report types:
+
+### Summary Reports
+
+- **`Summary`** - Full detailed coverage report with line-by-line analysis
+- **`FullSummary`** - Complete coverage without threshold filtering
+- **`BriefSummary`** - Shows overall statistics + top 5 files with least coverage
+- **`PartialSummary`** - Shows only code segments with incomplete coverage + lists 100% covered files
+- **`MarkdownSummary`** - Coverage report formatted as Markdown
+- **`Quiet`** - Suppresses all output
+
+### Usage Examples
+
+``` ruby
+# In config/covered.rb
+def make_policy(policy)
+	super
+	
+	# Add multiple reports
+	policy.reports << Covered::PartialSummary.new
+	policy.reports << Covered::MarkdownSummary.new(threshold: 0.8)
+end
+```
+
+## Path Configuration
+
+### Ignoring Paths
+
+Default ignored paths include `test/`, `spec/`, `fixtures/`, `vendor/`, and `config/`. Customize with:
+
+``` ruby
+def ignore_paths
+	super + [
+		"engines/",           # Engine directories
+		"app/assets/",        # Asset files
+		"db/migrate/",        # Database migrations
+		"tmp/",               # Temporary files
+		"log/",               # Log files
+		"coverage/",          # Coverage output
+		"public/packs/"       # Webpack outputs
+	]
+end
+```
+
+### Including Patterns
+
+Default includes `lib/**/*.rb`. Extend for additional patterns:
+
+``` ruby
+def include_patterns
+	super + [
+		"app/**/*.rb",        # Application code
+		"bake/**/*.rb",       # Bake tasks
+		"engines/**/*.rb",    # Engine code
+		"lib/templates/**/*.erb"  # Template files (Ruby 3.2+)
+	]
+end
+```
+
+## Advanced Policy Configuration
+
+The `make_policy` method provides fine-grained control:
+
+``` ruby
+def make_policy(policy)
+	super
+	
+	# Filter by regex patterns
+	policy.skip(/\/generated\//)        # Skip generated files
+	policy.skip(/\.generated\.rb$/)     # Skip files ending in .generated.rb
+	
+	# Include specific files
+	policy.include("config/application.rb")
+	
+	# Only track specific patterns
+	policy.only(/^app\//)
+	
+	# Set custom root
+	policy.root(File.expand_path('..', __dir__))
+	
+	# Enable persistent coverage across runs
+	policy.persist!
+	
+	# Configure reports programmatically
+	if ENV['CI']
+		policy.reports << Covered::MarkdownSummary.new
+	else
+		policy.reports << Covered::PartialSummary.new
+	end
+end
+```
+
+## Common Configuration Patterns
+
+### Rails Applications
+
+``` ruby
+def ignore_paths
+	super + [
+		"app/assets/",
+		"db/migrate/",
+		"db/seeds.rb",
+		"config/environments/",
+		"config/initializers/",
+		"tmp/",
+		"log/",
+		"public/",
+		"storage/"
+	]
+end
+
+def include_patterns
+	super + [
+		"app/**/*.rb",
+		"lib/**/*.rb",
+		"config/application.rb",
+		"config/routes.rb"
+	]
+end
+```
+
+### Gem Development
+
+``` ruby
+def ignore_paths
+	super + ["examples/", "benchmark/"]
+end
+
+def include_patterns
+	super + ["bin/**/*.rb"]
+end
+
+def make_policy(policy)
+	super
+	
+	# Only track the gem's main code
+	policy.only(/^lib\//)
+end
+```
+
+### Monorepo/Multi-Engine
+
+``` ruby
+def ignore_paths
+	super + [
+		"engines/*/spec/",
+		"engines/*/test/",
+		"shared/fixtures/"
+	]
+end
+
+def include_patterns
+	super + [
+		"engines/*/lib/**/*.rb",
+		"engines/*/app/**/*.rb",
+		"shared/lib/**/*.rb"
+	]
+end
+```
+
+## Template Coverage (Ruby 3.2+)
+
+For projects using ERB, Haml, or other template engines:
+
+``` ruby
+def include_patterns
+	super + [
+		"app/views/**/*.erb",
+		"lib/templates/**/*.erb",
+		"app/views/**/*.haml"
+	]
+end
+
+def make_policy(policy)
+	super
+	
+	# Ensure template coverage is enabled
+	require 'covered/erb' if defined?(ERB)
+end
+```
+
+## CI/CD Integration
+
+### GitHub Actions
+
+``` ruby
+def make_policy(policy)
+	super
+	
+	if ENV['GITHUB_ACTIONS']
+		# Use markdown format for GitHub
+		policy.reports << Covered::MarkdownSummary.new
+		
+		# Fail build on low coverage
+		policy.reports << Class.new do
+			def call(wrapper, output = $stdout)
+				statistics = wrapper.each.inject(Statistics.new) { |s, c| s << c }
+				if statistics.ratio < 0.90
+					exit 1
+				end
+			end
+		end.new
+	end
+end
+```
+
+### Custom Thresholds
+
+``` ruby
+def make_policy(policy)
+	super
+	
+	# Different thresholds for different environments
+	threshold = case ENV['RAILS_ENV']
+	when 'production' then 0.95
+	when 'staging' then 0.90
+	else 0.80
+	end
+	
+	policy.reports << Covered::Summary.new(threshold: threshold)
+end
+```
+
+## Performance Optimization
+
+For large codebases:
+
+``` ruby
+def make_policy(policy)
+	super
+	
+	# Skip large generated directories
+	policy.skip(/\/node_modules\//)
+	policy.skip(/\/vendor\/bundle\//)
+	policy.skip(/\/coverage\//)
+	
+	# Use more efficient reports for large projects
+	if Dir['**/*.rb'].length > 1000
+		policy.reports << Covered::BriefSummary.new
+	else
+		policy.reports << Covered::PartialSummary.new
+	end
+end
+```
+
+## Troubleshooting
+
+### Common Issues
+
+**Coverage not working:**
+- Ensure `require 'covered/rspec'` (or similar) is at the top of your test helper
+- Check that `COVERAGE` environment variable is set
+- Verify the configuration file path is correct: `config/covered.rb`
+
+**Missing files in reports:**
+- Files must be required/loaded during test execution to be tracked
+- Use `include_patterns` to track files not loaded by tests
+- Check `ignore_paths` isn't excluding desired files
+
+**Performance issues:**
+- Use `BriefSummary` instead of `Summary` for large codebases
+- Add more specific patterns to `ignore_paths`
+- Use `policy.only()` to limit scope
+
+**Template coverage not working:**
+- Requires Ruby 3.2+ for full template support
+- Ensure template engines are loaded before coverage starts
+- Check that template files match `include_patterns`
+
+### Debug Configuration
+
+``` ruby
+def make_policy(policy)
+	super
+	
+	# Debug: print current configuration
+	if ENV['DEBUG_COVERAGE']
+		puts "Ignore paths: #{ignore_paths}"
+		puts "Include patterns: #{include_patterns}"
+		puts "Root: #{@root}"
+	end
+end
+```
+
+See the {ruby Covered::Config} class for complete API documentation.

data/context/getting-started.md

@@ -0,0 +1,66 @@
+# Getting Started
+
+This guide explains how to get started with `covered` and integrate it with your test suite.
+
+## Installation
+
+Add this line to your application's `Gemfile`:
+
+``` ruby
+gem 'covered'
+```
+
+### Sus Integration
+
+In your `config/sus.rb` add the following:
+
+``` ruby
+require 'covered/sus'
+include Covered::Sus
+```
+
+### RSpec Integration
+
+In your `spec/spec_helper.rb` add the following before loading any other code:
+
+``` ruby
+require 'covered/rspec'
+```
+
+Ensure that you have a `.rspec` file with `--require spec_helper`:
+
+    --require spec_helper
+    --format documentation
+    --warnings
+
+### Minitest Integration
+
+In your `test/test_helper.rb` add the following before loading any other code:
+
+``` ruby
+require 'covered/minitest'
+require 'minitest/autorun'
+```
+
+In your test files, e.g. `test/dummy_test.rb` add the following at the top:
+
+``` ruby
+require_relative 'test_helper'
+```
+
+### Template Coverage
+
+Covered supports coverage of templates which are compiled into Ruby code. This is only supported on Ruby 3.2+ due to
+enhancements in the coverage interface.
+
+### Partial Summary
+
+    COVERAGE=PartialSummary rspec
+
+This report only shows snippets of source code with incomplete coverage.
+
+### Brief Summary
+
+    COVERAGE=BriefSummary rspec
+
+This report lists several files in order of least coverage.l

data/context/index.yaml

@@ -0,0 +1,17 @@
+# Automatically generated context index for Utopia::Project guides.
+# Do not edit then files in this directory directly, instead edit the guides and then run `bake utopia:project:agent:context:update`.
+---
+description: A modern approach to code coverage.
+metadata:
+  documentation_uri: https://socketry.github.io/covered/
+  funding_uri: https://github.com/sponsors/ioquatix/
+  source_code_uri: https://github.com/socketry/covered.git
+files:
+- path: getting-started.md
+  title: Getting Started
+  description: This guide explains how to get started with `covered` and integrate
+    it with your test suite.
+- path: configuration.md
+  title: Configuration
+  description: This guide will help you to configure covered for your project's specific
+    requirements.

data/context/usage.md

@@ -0,0 +1,110 @@
+## General Information
+
+As per the official documentation, `covered` is a modern code-coverage library for Ruby.
+
+Instead of relying only on Ruby’s built-in `Coverage` API, it combines **tracepoints** with  
+static analysis from the `parser` gem so it can track _any_ Ruby that eventually gets executed  
+(including code produced by `eval`, or templates such as ERB/ HAML that are compiled to Ruby).
+Because it knows which lines are _actually_ executable, the reported percentages are usually  
+more accurate than classic line-count tools like SimpleCov.
+
+## Installation
+
+Add this line to your application's `Gemfile`:
+
+```ruby
+gem 'covered'
+```
+
+## Configuration
+
+### Configure what you see
+
+Under the hood, `covered` uses a single environment variable `COVERAGE` to:
+1. turn the coverage tracking on/ off
+2. allow the user to select how much detail to be printed
+
+By default, when the `COVERAGE` is not specifically set anywhere, you will not see anything, and nothing will be stored during the runs.
+
+You can modify this behavior either by defining the environment variable or specifying it when running the tests command. Your choices of values are:
+1. `BriefSummary` - you see a brief summary showcasing the overall percentage of line coverage.
+	- Ideally you would use this for quick feedback locally
+	- You can also use this to set a threshold through Github Actions around merging rules in Pull Requests.
+2. `PartialSummary` - you see contextual snippets around missing lines
+	- Ideally you would use this for quickly investigating missing coverage in specific files
+	- You can also use this to set a threshold through Github Actions around merging rules in Pull Requests, and also deliver information about which lines are not tested to the developer.
+3. `FullSummary` - you see every line, both covered and uncovered, which may be overwhelming
+	- Ideally you would use this when doing a deep dive that requires verbosity.
+4. `Quiet` - you do not see anything in the console but the coverage is saved internally for later usage
+	- Ideally used in CI pipelines.
+
+### Configure file choices for coverage
+
+You can configure covered by creating a `config/covered.rb` file in your project.
+
+```ruby
+def ignore_paths
+	super + ["engines/"]
+end
+
+def include_patterns
+	super + ["bake/**/*.rb"]
+end
+```
+
+1. `ignore_paths` specifies which paths to ignore when computing coverage for a given project.
+2. `include_patterns` specifies which paths to include when computing coverage for a given project.
+
+More information around the Configuration possibilities can be found here: https://socketry.github.io/covered/source/Covered/Config/index.html.
+
+One possibly helpful functionality to take note of is that you can override the `make_policy` method in order to implement your own policy.
+## Integration
+
+### Sus Integration
+
+In your `config/sus.rb` add the following:
+
+```ruby
+require 'covered/sus'
+include Covered::Sus
+```
+### RSpec Integration
+
+In your `spec/spec_helper.rb` add the following before loading any other code:
+
+```ruby
+require 'covered/rspec'
+```
+
+Ensure that you have a `.rspec` file with `--require spec_helper`:
+
+```plain
+--require spec_helper
+--format documentation
+--warnings
+```
+
+### Minitest Integration
+
+In your `test/test_helper.rb` add the following before loading any other code:
+
+```ruby
+require 'covered/minitest'
+require 'minitest/autorun'
+```
+
+In your test files, e.g. `test/dummy_test.rb` add the following at the top:
+
+```ruby
+require_relative 'test_helper'
+```
+
+
+## Coverage Improvement
+
+The taxonomy of tests isn't really relevant for the purpose of improving the coverage and the safety of your codebase.
+
+You are going to think about tests by referring to the level of software processes that they test. When trying to improve coverage, you must first understand what the purpose of the on-going process is, with the scope of coverage in mind:
+	1. Verifying individual components - you are going to be writing Unit Tests.
+	2. Verifying interaction between multiple units - you are going to be writing Integration Tests.
+	3. Verifying end-to-end-workflows - you are going to be writing System Tests.

data/lib/covered/autostart.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023, by Samuel Williams.
+# Copyright, 2023-2025, by Samuel Williams.
 
-require_relative 'config'
+require_relative "config"
 
 module Coverage
 	module Autostart

data/lib/covered/brief_summary.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+require_relative "summary"
+
+module Covered
+	class BriefSummary < Summary
+		def call(wrapper, output = $stdout, before: 4, after: 4)
+			terminal = self.terminal(output)
+			
+			ordered = []
+			
+			statistics = self.each(wrapper) do |coverage|
+				ordered << coverage unless coverage.complete?
+			end
+			
+			terminal.puts
+			statistics.print(output)
+			
+			if ordered.any?
+				terminal.puts "", "Least Coverage:"
+				ordered.sort_by!(&:missing_count).reverse!
+				
+				ordered.first(5).each do |coverage|
+					path = wrapper.relative_path(coverage.path)
+					
+					terminal.write path, style: :brief_path
+					terminal.puts ": #{coverage.missing_count} lines not executed!"
+				end
+			end
+		end
+	end
+end

data/lib/covered/capture.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
-require_relative 'wrapper'
+require_relative "wrapper"
 
-require 'coverage'
+require "coverage"
 
 module Covered
 	class Capture < Wrapper

data/lib/covered/config.rb

@@ -1,16 +1,16 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 
-require_relative 'policy'
+require_relative "policy"
 
 module Covered
 	class Config
 		PATH = "config/covered.rb"
 		
 		def self.root
-			ENV['COVERED_ROOT'] || Dir.pwd
+			ENV["COVERED_ROOT"] || Dir.pwd
 		end
 		
 		def self.path(root)
@@ -22,7 +22,7 @@ module Covered
 		end
 		
 		def self.reports
-			ENV['COVERAGE']
+			ENV["COVERAGE"]
 		end
 		
 		def self.load(root: self.root, reports: self.reports)
@@ -94,7 +94,7 @@ module Covered
 		# Which paths to ignore when computing coverage for a given project.
 		# @returns [Array(String)] An array of relative paths to ignore.
 		def ignore_paths
-			['test/', 'fixtures/', 'spec/', 'vendor/', 'config/']
+			["test/", "fixtures/", "spec/", "vendor/", "config/"]
 		end
 		
 		# Which paths to include when computing coverage for a given project.
@@ -127,23 +127,23 @@ module Covered
 		
 		protected
 		
-		REQUIRE_COVERED_AUTOSTART = '-rcovered/autostart'
+		REQUIRE_COVERED_AUTOSTART = "-rcovered/autostart"
 		
 		def autostart!
-			if rubyopt = ENV['RUBYOPT'] and !rubyopt.empty?
-				rubyopt = [rubyopt.strip, REQUIRE_COVERED_AUTOSTART].join(' ')
+			if rubyopt = ENV["RUBYOPT"] and !rubyopt.empty?
+				rubyopt = [rubyopt.strip, REQUIRE_COVERED_AUTOSTART].join(" ")
 			else
 				rubyopt = REQUIRE_COVERED_AUTOSTART
 			end
 			
-			ENV['RUBYOPT'] = rubyopt
+			ENV["RUBYOPT"] = rubyopt
 			
-			unless ENV['COVERED_ROOT']
-				ENV['COVERED_ROOT'] = @root
+			unless ENV["COVERED_ROOT"]
+				ENV["COVERED_ROOT"] = @root
 			end
 			
 			# Don't report coverage in child processes:
-			ENV.delete('COVERAGE')
+			ENV.delete("COVERAGE")
 		end
 	end
 end

data/lib/covered/coverage.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
-require_relative 'source'
+require_relative "source"
 
 module Covered
 	module Ratio

data/lib/covered/files.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
-require_relative 'coverage'
-require_relative 'wrapper'
+require_relative "coverage"
+require_relative "wrapper"
 
-require 'set'
+require "set"
 
 module Covered
 	class Files < Base

data/lib/covered/forks.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2023, by Samuel Williams.
+# Copyright, 2023-2025, by Samuel Williams.
 
-require_relative 'wrapper'
+require_relative "wrapper"
 
 module Covered
 	class Forks < Wrapper

data/lib/covered/markdown_summary.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2021-2023, by Samuel Williams.
+# Copyright, 2021-2025, by Samuel Williams.
 
-require_relative 'statistics'
-require_relative 'wrapper'
+require_relative "statistics"
+require_relative "wrapper"
 
-require 'console/output'
+require "console/output"
 
 module Covered
 	class MarkdownSummary
@@ -56,7 +56,7 @@ module Covered
 		
 		# A coverage array gives, for each line, the number of line execution by the interpreter. A nil value means coverage is finishd for this line (lines like else and end).
 		def call(wrapper, output = $stdout)
-			output.puts '# Coverage Report'
+			output.puts "# Coverage Report"
 			output.puts
 			
 			ordered = []

data/lib/covered/minitest.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 # Copyright, 2022, by Adam Daniels.
 
-require_relative 'config'
+require_relative "config"
 
-require 'minitest'
+require "minitest"
 
 $covered = Covered::Config.load
 

data/lib/covered/partial_summary.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+# Released under the MIT License.
+# Copyright, 2025, by Samuel Williams.
+
+require_relative "summary"
+
+module Covered
+	class PartialSummary < Summary
+		def print_coverage(terminal, coverage, before: 4, after: 4)
+			return if coverage.zero?
+			
+			line_offset = 1
+			counts = coverage.counts
+			last_line = nil
+			
+			coverage.read do |file|
+				print_line_header(terminal)
+				
+				file.each_line do |line|
+					range = Range.new([line_offset - before, 0].max, line_offset+after)
+					
+					if counts[range]&.include?(0)
+						count = counts[line_offset]
+						
+						if last_line and last_line != line_offset-1
+							terminal.puts ":".rjust(16)
+						end
+						
+						print_annotations(terminal, coverage, line, line_offset)
+						print_line(terminal, line, line_offset, count)
+						
+						last_line = line_offset
+					end
+					
+					line_offset += 1
+				end
+			end
+		end
+		
+		def call(wrapper, output = $stdout, **options)
+			terminal = self.terminal(output)
+			complete_files = []
+			
+			statistics = self.each(wrapper) do |coverage|
+				path = wrapper.relative_path(coverage.path)
+				terminal.puts ""
+				terminal.puts path, style: :path
+				
+				begin
+					print_coverage(terminal, coverage, **options)
+				rescue => error
+					print_error(terminal, error)
+				end
+				
+				coverage.print(output)
+			end
+			
+			# Collect files with 100% coverage that were not shown
+			wrapper.each do |coverage|
+				if coverage.ratio >= 1.0
+					complete_files << wrapper.relative_path(coverage.path)
+				end
+			end
+			
+			terminal.puts
+			statistics.print(output)
+			
+			# Show information about files with 100% coverage
+			if complete_files.any?
+				terminal.puts ""
+				if complete_files.size == 1
+					terminal.puts "1 file has 100% coverage and is not shown above:"
+				else
+					terminal.puts "#{complete_files.size} files have 100% coverage and are not shown above:"
+				end
+				
+				complete_files.sort.each do |path|
+					terminal.write "  - ", style: :covered_prefix
+					terminal.puts path, style: :brief_path
+				end
+			end
+		end
+	end
+end

data/lib/covered/persist.rb

@@ -1,13 +1,13 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 # Copyright, 2023, by Stephen Ierodiaconou.
 
-require_relative 'wrapper'
+require_relative "wrapper"
 
-require 'msgpack'
-require 'time'
+require "msgpack"
+require "time"
 
 module Covered
 	class Persist < Wrapper

data/lib/covered/policy.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
 require_relative "summary"
 require_relative "files"
@@ -93,7 +93,7 @@ module Covered
 			private
 			
 			def snake_case(string)
-				return string.gsub(/::/, '/').
+				return string.gsub(/::/, "/").
 					gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
 					gsub(/([a-z\d])([A-Z])/,'\1_\2').
 					tr("-", "_").
@@ -103,7 +103,7 @@ module Covered
 		
 		def reports!(reports)
 			if reports.is_a?(String)
-				names = reports.split(',')
+				names = reports.split(",")
 				
 				names.each do |name|
 					begin

data/lib/covered/rspec.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
-require_relative 'config'
-require 'rspec/core/formatters'
+require_relative "config"
+require "rspec/core/formatters"
 
 $covered = Covered::Config.load
 
@@ -30,7 +30,7 @@ end
 
 if $covered.record?
 	RSpec::Core::Configuration.prepend(Covered::RSpec::Policy)
-
+	
 	RSpec.configure do |config|
 		config.after(:suite) do
 			$covered.finish

data/lib/covered/statistics.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
-require_relative 'wrapper'
-require_relative 'coverage'
+require_relative "wrapper"
+require_relative "coverage"
 
 module Covered
 	class CoverageError < StandardError

data/lib/covered/summary.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
-require_relative 'statistics'
-require_relative 'wrapper'
+require_relative "statistics"
+require_relative "wrapper"
 
 module Covered
 	class Summary
@@ -13,7 +13,7 @@ module Covered
 		end
 		
 		def terminal(output)
-			require 'console/terminal'
+			require "console/terminal"
 			
 			Console::Terminal.for(output).tap do |terminal|
 				terminal[:path] ||= terminal.style(nil, nil, :bold, :underline)
@@ -136,66 +136,6 @@ module Covered
 		end
 	end
 	
-	class BriefSummary < Summary
-		def call(wrapper, output = $stdout, before: 4, after: 4)
-			terminal = self.terminal(output)
-			
-			ordered = []
-			
-			statistics = self.each(wrapper) do |coverage|
-				ordered << coverage unless coverage.complete?
-			end
-			
-			terminal.puts
-			statistics.print(output)
-			
-			if ordered.any?
-				terminal.puts "", "Least Coverage:"
-				ordered.sort_by!(&:missing_count).reverse!
-				
-				ordered.first(5).each do |coverage|
-					path = wrapper.relative_path(coverage.path)
-					
-					terminal.write path, style: :brief_path
-					terminal.puts ": #{coverage.missing_count} lines not executed!"
-				end
-			end
-		end
-	end
-	
-	class PartialSummary < Summary
-		def print_coverage(terminal, coverage, before: 4, after: 4)
-			return if coverage.zero?
-			
-			line_offset = 1
-			counts = coverage.counts
-			last_line = nil
-			
-			coverage.read do |file|
-				print_line_header(terminal)
-				
-				file.each_line do |line|
-					range = Range.new([line_offset - before, 0].max, line_offset+after)
-					
-					if counts[range]&.include?(0)
-						count = counts[line_offset]
-						
-						if last_line and last_line != line_offset-1
-							terminal.puts ":".rjust(16)
-						end
-						
-						print_annotations(terminal, coverage, line, line_offset)
-						print_line(terminal, line, line_offset, count)
-						
-						last_line = line_offset
-					end
-					
-					line_offset += 1
-				end
-			end
-		end
-	end
-	
 	class Quiet
 		def call(wrapper, output = $stdout)
 			# Silent.

data/lib/covered/sus.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2025, by Samuel Williams.
 
 module Covered
 	module Sus
@@ -9,8 +9,8 @@ module Covered
 			super
 			
 			# Defer loading the coverage configuration unless we are actually running with coverage startd to avoid performance cost/overhead.
-			if ENV['COVERAGE']
-				require_relative 'config'
+			if ENV["COVERAGE"]
+				require_relative "config"
 				
 				@covered = Covered::Config.load(root: self.root)
 				if @covered.record?

data/lib/covered/version.rb

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2023, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
 module Covered
-	VERSION = "0.26.0"
+	VERSION = "0.28.0"
 end

data/lib/covered.rb

@@ -1,7 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2018-2022, by Samuel Williams.
+# Copyright, 2018-2025, by Samuel Williams.
 
 require_relative "covered/version"
 require_relative "covered/policy"
+
+require_relative "covered/brief_summary"
+require_relative "covered/partial_summary"

data/license.md

@@ -1,12 +1,13 @@
 # MIT License
 
-Copyright, 2018-2024, by Samuel Williams.  
+Copyright, 2018-2025, by Samuel Williams.  
 Copyright, 2018, by Shannon Skipper.  
 Copyright, 2019, by Cyril Roelandt.  
 Copyright, 2022, by Adam Daniels.  
 Copyright, 2022, by Felix Yan.  
 Copyright, 2023, by Stephen Ierodiaconou.  
 Copyright, 2023, by Michael Adams.  
+Copyright, 2025, by Aron Latis.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -11,7 +11,7 @@ into Ruby.
     platforms.
   - Supports coverage of views - templates compiled to Ruby code can be tracked for coverage reporting.
 
-[![Development Status](https://github.com/ioquatix/covered/workflows/Test/badge.svg)](https://github.com/ioquatix/covered/actions?workflow=Test)
+[![Development Status](https://github.com/socketry/covered/workflows/Test/badge.svg)](https://github.com/socketry/covered/actions?workflow=Test)
 
 ## Motivation
 
@@ -24,17 +24,29 @@ After this concept prooved useful, [it was integrated directly into Ruby](https:
 
 ## Usage
 
-Please see the [project documentation](https://ioquatix.github.io/covered/) for more details.
+Please see the [project documentation](https://socketry.github.io/covered/) for more details.
 
-  - [Getting Started](https://ioquatix.github.io/covered/guides/getting-started/index) - This guide explains how to get started with `covered` and integrate it with your test suite.
+  - [Getting Started](https://socketry.github.io/covered/guides/getting-started/index) - This guide explains how to get started with `covered` and integrate it with your test suite.
 
-  - [Configuration](https://ioquatix.github.io/covered/guides/configuration/index) - This guide will help you to configure covered for your project's specific requirements.
+  - [Configuration](https://socketry.github.io/covered/guides/configuration/index) - This guide will help you to configure covered for your project's specific requirements.
+
+## Releases
+
+Please see the [project releases](https://socketry.github.io/covered/releases/index) for all releases.
+
+### v0.28.0
+
+  - List files that have 100% coverage in `PartialSummary` output.
+
+### v0.27.0
+
+  - Drop development dependeny on `trenni` and add dependeny on `xrb`.
 
 ## See Also
 
   - [simplecov](https://github.com/colszowka/simplecov) – one of the original coverage implementations for Ruby, uses
     the built-in `coverage` library.
-  - [sus](https://github.com/ioquatix/sus) - a test framework which uses `covered` to generate coverage reports.
+  - [sus](https://github.com/socketry/sus) - a test framework which uses `covered` to generate coverage reports.
 
 ## Contributing
 
@@ -48,8 +60,8 @@ We welcome contributions to this project.
 
 ### Developer Certificate of Origin
 
-This project uses the [Developer Certificate of Origin](https://developercertificate.org/). All contributors to this project must agree to this document to have their contributions accepted.
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
 
-### Contributor Covenant
+### Community Guidelines
 
-This project is governed by the [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

data/releases.md

@@ -0,0 +1,9 @@
+# Releases
+
+## v0.28.0
+
+  - List files that have 100% coverage in `PartialSummary` output.
+
+## v0.27.0
+
+  - Drop development dependeny on `trenni` and add dependeny on `xrb`.

metadata

@@ -1,17 +1,17 @@
 --- !ruby/object:Gem::Specification
 name: covered
 version: !ruby/object:Gem::Version
-  version: 0.26.0
+  version: 0.28.0
 platform: ruby
 authors:
 - Samuel Williams
 - Adam Daniels
+- Aron Latis
 - Cyril Roelandt
 - Felix Yan
 - Michael Adams
 - Shannon Skipper
 - Stephen Ierodiaconou
-autorequire:
 bindir: bin
 cert_chain:
 - |
@@ -43,7 +43,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-07-11 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: console
@@ -73,8 +73,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.0'
-description:
-email:
 executables: []
 extensions: []
 extra_rdoc_files: []
@@ -82,8 +80,13 @@ files:
 - bake/covered/debug.rb
 - bake/covered/policy.rb
 - bake/covered/validate.rb
+- context/configuration.md
+- context/getting-started.md
+- context/index.yaml
+- context/usage.md
 - lib/covered.rb
 - lib/covered/autostart.rb
+- lib/covered/brief_summary.rb
 - lib/covered/capture.rb
 - lib/covered/config.rb
 - lib/covered/coverage.rb
@@ -91,6 +94,7 @@ files:
 - lib/covered/forks.rb
 - lib/covered/markdown_summary.rb
 - lib/covered/minitest.rb
+- lib/covered/partial_summary.rb
 - lib/covered/persist.rb
 - lib/covered/policy.rb
 - lib/covered/rspec.rb
@@ -102,14 +106,14 @@ files:
 - lib/covered/wrapper.rb
 - license.md
 - readme.md
-homepage: https://github.com/ioquatix/covered
+- releases.md
+homepage: https://github.com/socketry/covered
 licenses:
 - MIT
 metadata:
-  documentation_uri: https://ioquatix.github.io/covered/
+  documentation_uri: https://socketry.github.io/covered/
   funding_uri: https://github.com/sponsors/ioquatix/
-  source_code_uri: https://github.com/ioquatix/covered.git
-post_install_message:
+  source_code_uri: https://github.com/socketry/covered.git
 rdoc_options: []
 require_paths:
 - lib
@@ -117,15 +121,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.1'
+      version: '3.2'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.11
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: A modern approach to code coverage.
 test_files: []