simplecov 1.2.0 → 1.3.0

data/lib/simplecov/static_coverage_extractor/condition_folding.rb

@@ -8,14 +8,9 @@ module SimpleCov
     # must not synthesize one either: the arm would be a phantom no loaded run
     # can hit, the same unmergeable-tuple failure as #1226 / #1233.
     module ConditionFolding
-      # CRuby 3.4 rebuilt the fold on the Prism compiler, and the parse.y fold it
-      # replaced differed in three observable ways: `__FILE__` folded on
-      # 3.2/3.3; parentheses were transparent for every literal on 3.2; and on
-      # 3.2 the dead arm's branch table entries survive the fold while its
-      # `def`s still never register.
+      # CRuby 3.4 rebuilt the fold on the Prism compiler, and the parse.y fold
+      # it replaced still differs on 3.3, where `__FILE__` folds.
       FOLDS_SOURCE_FILE = Gem::Version.new(RUBY_VERSION) < Gem::Version.new("3.4")
-      PARENS_ALWAYS_TRANSPARENT = Gem::Version.new(RUBY_VERSION) < Gem::Version.new("3.3")
-      DEAD_ARM_BRANCHES_SURVIVE = PARENS_ALWAYS_TRANSPARENT
       # Container literals in discarded position are eliminated from 3.3 on, but
       # 3.3's compile.c elides a container whose contents are merely
       # effect-free (`[x]`), while the Prism compiler demands fully static
@@ -42,8 +37,7 @@ module SimpleCov
 
       # CRuby folds `if nil`, `if "x"`, and `if -> {}` but keeps a real branch
       # for `if (nil)`, `if ("x")`, and `if (-> {})`, while every other literal
-      # folds parenthesized or not. Consulted only when parentheses are not
-      # always transparent.
+      # folds parenthesized or not.
       PAREN_OPAQUE_TYPES = [
         ::Prism::NilNode, ::Prism::StringNode, ::Prism::LambdaNode, ::Prism::SourceFileNode
       ].freeze
@@ -58,42 +52,18 @@ module SimpleCov
         ::Prism::SourceLineNode, ::Prism::SourceFileNode, ::Prism::SourceEncodingNode, ::Prism::RegularExpressionNode
       ].freeze
 
-      # `self` is eliminated by every supported compiler; local/ivar/defined?
-      # elimination arrived with the Prism-era compilers. Anything that can
-      # raise or run hooks is never eliminated and keeps the branch real.
-      PRISM_ERA_ELIMINABLE_READS = [
-        ::Prism::LocalVariableReadNode, ::Prism::InstanceVariableReadNode, ::Prism::DefinedNode
-      ].freeze
-
-      # simplecov:disable branch — which arm runs is fixed by the running Ruby's version
+      # Non-literal reads that are also eliminated when discarded. Anything that
+      # can raise or run hooks is never eliminated and keeps the branch real.
       ELIMINABLE_READ_TYPES = [
-        ::Prism::SelfNode,
-        *(PRISM_ERA_ELIMINABLE_READS unless PARENS_ALWAYS_TRANSPARENT)
+        ::Prism::SelfNode, ::Prism::LocalVariableReadNode,
+        ::Prism::InstanceVariableReadNode, ::Prism::DefinedNode
       ].freeze
-      # simplecov:enable branch
 
       private
 
-      # On 3.2 the dead arm's branch table entries survive the fold (parse.y
-      # instrumented branches before eliminating dead code) while its methods
-      # never register, so the dead arm is visited with method collection
-      # suppressed.
+      # `visit` is nil-safe, so a missing arm just visits nothing.
       def visit_folded_arms(verdict, truthy_arm, falsy_arm)
-        live, dead = verdict.equal?(:truthy) ? [truthy_arm, falsy_arm] : [falsy_arm, truthy_arm]
-        visit(live)
-        visit_dead_arm(dead) if DEAD_ARM_BRANCHES_SURVIVE
-      end
-
-      def visit_dead_arm(arm)
-        # Save/restore rather than set/clear: a fold nested inside this dead arm
-        # re-enters here and must not clear suppression for the rest of it.
-        previous = @suppress_methods
-        begin
-          @suppress_methods = true
-          visit(arm)
-        ensure
-          @suppress_methods = previous
-        end
+        visit(verdict.equal?(:truthy) ? truthy_arm : falsy_arm)
       end
 
       # `:truthy` or `:falsy` when the compiler folds, nil when it doesn't. The
@@ -115,8 +85,6 @@ module SimpleCov
       def foldable?(node, unwrapped)
         return false unless STATIC_CONDITION_TYPES.any? { |type| unwrapped.instance_of?(type) }
 
-        return true if PARENS_ALWAYS_TRANSPARENT
-
         unwrapped.equal?(node) || PAREN_OPAQUE_TYPES.none? { |type| unwrapped.instance_of?(type) }
       end
 
@@ -151,7 +119,6 @@ module SimpleCov
 
       def static_container_literal?(node)
         return true if STATIC_LITERAL_LEAF_TYPES.any? { |type| node.instance_of?(type) }
-        return false if PARENS_ALWAYS_TRANSPARENT
 
         static_container?(node)
       end

data/lib/simplecov/static_coverage_extractor/method_collector.rb

@@ -17,12 +17,8 @@ module SimpleCov
 
       # `def name(...)` and `def self.name(...)` both produce DefNode. The class
       # context is the surrounding lexical class or module, or `Object` at the top
-      # level, matching `Coverage`'s convention. Suppression covers 3.2's folded
-      # dead arms, where nested branches stay instrumented but a `def` never
-      # registers.
+      # level, matching `Coverage`'s convention.
       def visit_def_node(node)
-        return super if @suppress_methods
-
         class_name = @class_stack.last || "Object"
         key = [class_name, node.name, node.start_line, node.start_column, node.end_line, node.end_column]
         @methods[key] = 0

data/lib/simplecov/static_coverage_extractor/visitor.rb

@@ -12,7 +12,7 @@ module SimpleCov
     # Ruby's `Coverage` reports. Tuple ids are sequential across the file like
     # `Coverage`'s, but the numbering order can differ. That's fine: the
     # combiners intern on source span and the report output drops ids, so
-    # nothing downstream compares them. Only defined when Prism is loadable.
+    # nothing downstream compares them.
     class Visitor < Prism::Visitor
       include MethodCollector
       include LocationConventions
@@ -31,7 +31,6 @@ module SimpleCov
         @next_id = 0
         @class_stack = []
         @value_positions = nil
-        @suppress_methods = false
       end
 
       # On legacy Rubies the location of an empty branch arm depends on whether
@@ -48,11 +47,9 @@ module SimpleCov
       # Coverage synthesizes a `:else` arm attributed to the whole condition's
       # range, and so do we.
       #
-      # A folded condition emits no tuple, and on modern Rubies only its live
-      # arm is descended into: the compiler eliminates the dead arm's entire
-      # subtree, so a branch or method nested there would be a phantom no
-      # loaded run can produce. On 3.2 the dead arm is visited too, branches
-      # only.
+      # A folded condition emits no tuple, and only its live arm is descended
+      # into: the compiler eliminates the dead arm's entire subtree, so a branch
+      # or method nested there would be a phantom no loaded run can produce.
       def visit_if_node(node)
         verdict = folded_condition(node.predicate)
         return visit_folded_arms(verdict, node.statements, PrismCompat.subsequent(node)) if verdict

data/lib/simplecov/static_coverage_extractor.rb

@@ -1,12 +1,6 @@
 # frozen_string_literal: true
 
-begin
-  require "prism"
-rescue LoadError
-  # Prism isn't available on this Ruby (older than 3.3 without the gem).
-  # `StaticCoverageExtractor.available?` will return false and callers fall
-  # back to the previous "empty hashes" behavior.
-end
+require "prism"
 
 module SimpleCov
   # Static enumeration of the branches and methods Ruby's `Coverage` library
@@ -23,17 +17,11 @@ module SimpleCov
   module StaticCoverageExtractor
     extend self
 
-    def available?
-      defined?(Prism) ? true : false
-    end
-
     # Parse `source` and return `{"branches" => {...}, "methods" => {...}}`
     # matching the shape `Coverage.result[path]` produces. Returns nil on parse
-    # failure or when Prism isn't available, which callers treat as "couldn't
-    # extract, fall back to empty hashes".
+    # failure, which callers treat as "couldn't extract, fall back to empty
+    # hashes".
     def call(source)
-      return nil unless available?
-
       result = Prism.parse(source)
       return nil if result.failure?
 
@@ -61,8 +49,8 @@ module SimpleCov
     # Coincidental line-sharing between a real branch and an eval-generated one
     # keeps both, an acceptable false-negative for an opt-in filter.
     #
-    # Returns nil when Prism is unavailable or parsing fails, signaling callers
-    # to keep every Coverage entry.
+    # Returns nil when parsing fails, signaling callers to keep every Coverage
+    # entry.
     def real_source_positions(source)
       extracted = call(source)
       return nil unless extracted
@@ -87,8 +75,4 @@ module SimpleCov
   end
 end
 
-# simplecov:disable branch
-# The `else` arm (Prism missing) is unreachable on engines where the dogfood
-# report runs; the Visitor class only matters when Prism is loadable.
-require_relative "static_coverage_extractor/visitor" if SimpleCov::StaticCoverageExtractor.available?
-# simplecov:enable branch
+require_relative "static_coverage_extractor/visitor"

data/lib/simplecov/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SimpleCov
-  VERSION = "1.2.0"
+  VERSION = "1.3.0"
 end

data/man/simplecov.1

@@ -1,4 +1,4 @@
-.TH SIMPLECOV 1 "2026-08-24" "simplecov 1.2.0" "User Commands"
+.TH SIMPLECOV 1 "2026-09-12" "simplecov 1.3.0" "User Commands"
 .SH NAME
 simplecov \- coverage reports and questions from the terminal
 .SH SYNOPSIS
@@ -168,8 +168,9 @@ line, branch, or method (default: line)
 .B \-\-missing
 Append the missed line ranges to each row
 .TP
-.B \-\-annotate github
-Emit ::warning workflow commands instead of rows
+.B \-\-annotate KIND
+Emit CI annotations instead of rows: github, gitlab, rdjson, azure, teamcity,
+or buildkite
 .TP
 .B \-\-json
 Emit results as a JSON array (for CI)
@@ -252,6 +253,10 @@ Exit non\-zero when patch coverage on any measured criterion is below N%
 .B \-\-find\-renames
 Follow a renamed file instead of counting the moved file as all\-new
 .TP
+.B \-\-annotate KIND
+Emit CI annotations instead of rows: github, gitlab, rdjson, azure, teamcity,
+or buildkite
+.TP
 .B \-\-json
 Emit results as a JSON array (for CI)
 .SS ratchet

data/sig/simplecov.rbs

@@ -123,6 +123,8 @@ module SimpleCov
 
   def self.tracked_file_paths: () -> Array[String]
 
+  def self.warn_templates_tracked: (Array[String] templates) -> void
+
   def self.inject_unloaded_files: (Hash[String, untyped] result, Array[String] candidate_paths, ?synthesize: bool?, ?lines: bool?) -> [Hash[String, untyped], Set[String]]
 
   def self.collect_own_coverage: (standalone: bool) -> void
@@ -669,6 +671,7 @@ module SimpleCov
     def source_file_for: (String path) -> SourceFile?
     def coverage_for: (String path) -> Hash[criterion, CoverageStatistics]?
     def groups: () -> Hash[String, FileList]
+    def configured_group?: (String group_name) -> bool
     def format!: () -> untyped
     def created_at: () -> Time
     def command_name: () -> String
@@ -953,6 +956,8 @@ module SimpleCov
 
       def method_statistics: () -> Hash[criterion, CoverageStatistics]
 
+      def unaccounted?: (SourceFile source_file, String table) -> bool
+
       def coverage_statistics: (Array[Line | Branch | Method] covered, Array[Line | Branch | Method] missed, ?omitted: Integer, ?percent: Float?) -> CoverageStatistics
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: simplecov
 version: !ruby/object:Gem::Version
-  version: 1.2.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Erik Berlin
@@ -44,6 +44,7 @@ files:
 - lib/simplecov/cli/affected.rb
 - lib/simplecov/cli/affected/changed_files.rb
 - lib/simplecov/cli/affected/selection.rb
+- lib/simplecov/cli/annotations.rb
 - lib/simplecov/cli/badge.rb
 - lib/simplecov/cli/badge/svg.rb
 - lib/simplecov/cli/clean.rb
@@ -125,6 +126,11 @@ files:
 - lib/simplecov/defaults.rb
 - lib/simplecov/deprecation.rb
 - lib/simplecov/directive.rb
+- lib/simplecov/directive/erb.rb
+- lib/simplecov/directive/haml.rb
+- lib/simplecov/directive/indented_template.rb
+- lib/simplecov/directive/slim.rb
+- lib/simplecov/directive/template.rb
 - lib/simplecov/exit_codes.rb
 - lib/simplecov/exit_codes/baseline_check.rb
 - lib/simplecov/exit_codes/check.rb
@@ -233,9 +239,9 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/simplecov-ruby/simplecov/issues
   changelog_uri: https://github.com/simplecov-ruby/simplecov/blob/main/CHANGELOG.md
-  documentation_uri: https://www.rubydoc.info/gems/simplecov/1.2.0
+  documentation_uri: https://www.rubydoc.info/gems/simplecov/1.3.0
   mailing_list_uri: https://groups.google.com/forum/#!forum/simplecov
-  source_code_uri: https://github.com/simplecov-ruby/simplecov/tree/v1.2.0
+  source_code_uri: https://github.com/simplecov-ruby/simplecov/tree/v1.3.0
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths:
@@ -244,7 +250,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.2'
+      version: '3.3'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="