evilution 1.4.0 → 1.5.0

data/lib/evilution/runner/subject_pipeline.rb

@@ -7,16 +7,20 @@ require_relative "../diagnostic"
 require_relative "../git/changed_files"
 
 class Evilution::Runner::SubjectPipeline
-  def initialize(config, parser:)
+  autoload :Target, File.expand_path("subject_pipeline/target", __dir__)
+
+  def initialize(config, parser:, registry: Evilution::Mutator::Registry.for_profile(config.profile))
     @config = config
     @parser = parser
+    @registry = registry
+    @target = Target.parse(config.target)
   end
 
   def call
     subjects = parse_subjects
     @subjects_by_file = subjects.group_by(&:file_path)
-    subjects = filter_by_descendants(subjects) if descendants_target?
-    subjects = filter_by_target(subjects) if method_target?
+    subjects = filter_by_descendants(subjects) if target.descendants?
+    subjects = filter_by_target(subjects) if target.method?
     subjects = filter_by_line_ranges(subjects) if config.line_ranges?
     subjects
   end
@@ -30,7 +34,7 @@ class Evilution::Runner::SubjectPipeline
   # generated for, per file -- known only once #call's subjects are planned.
   #
   # A line range is checked as given; a whole file only when it has no
-  # subjects at all -- every class with an `include` or a constant would
+  # subjects at all -- every class with an `include` or a DSL call would
   # otherwise warn.
   def report_uncovered_code(mutated_lines = {})
     by_file = @subjects_by_file || {}
@@ -49,10 +53,13 @@ class Evilution::Runner::SubjectPipeline
 
   private
 
-  attr_reader :config, :parser
+  attr_reader :config, :parser, :registry, :target
 
+  # The parser finds every subject there is; those of a kind no operator of
+  # this run mutates are left out, so that they neither count as covering
+  # their lines nor show up with nothing generated for them.
   def parse_subjects
-    target_files.flat_map { |file| parser.call(file) }
+    target_files.flat_map { |file| parser.call(file) }.select { |subject| registry.accepts?(subject) }
   end
 
   def uncovered_entry(file, file_subjects, mutated_lines)
@@ -71,24 +78,12 @@ class Evilution::Runner::SubjectPipeline
   def warn_uncovered(entry)
     Evilution::Diagnostic.warn(
       "[evilution] #{entry[:file]}:#{entry[:lines].join(", ")} holds code outside every subject " \
-      "(class-body code such as DSL calls and constants is not mutated); no mutations target those lines."
+      "(class-body code such as DSL calls is not mutated); no mutations target those lines."
     )
   end
 
-  def source_glob_target?
-    config.target&.start_with?("source:")
-  end
-
-  def descendants_target?
-    config.target&.start_with?("descendants:")
-  end
-
-  def method_target?
-    config.target? && !source_glob_target? && !descendants_target?
-  end
-
   def resolve_source_glob
-    pattern = config.target.delete_prefix("source:")
+    pattern = target.value
     files = Dir.glob(pattern)
     raise Evilution::Error, "no files found matching '#{pattern}'" if files.empty?
 
@@ -96,10 +91,9 @@ class Evilution::Runner::SubjectPipeline
   end
 
   def filter_by_descendants(subjects)
-    base_name = config.target.delete_prefix("descendants:")
     inheritance = Evilution::AST::InheritanceScanner.call(target_files)
-    class_names = resolve_descendant_set(base_name, inheritance)
-    raise Evilution::Error, "no classes found matching '#{config.target}'" if class_names.empty?
+    class_names = resolve_descendant_set(target.value, inheritance)
+    raise Evilution::Error, "no classes found matching '#{target}'" if class_names.empty?
 
     subjects.select { |s| class_names.include?(s.name.split(/[#.]/).first) }
   end
@@ -125,14 +119,14 @@ class Evilution::Runner::SubjectPipeline
   end
 
   def filter_by_target(subjects)
-    matched = subjects.select(&target_matcher)
+    matched = subjects.select { |subject| target.selects?(subject) }
     raise Evilution::Error, build_no_match_error if matched.empty?
 
     matched
   end
 
   def resolve_target_files
-    return resolve_source_glob if source_glob_target?
+    return resolve_source_glob if target.source_glob?
     return config.target_files unless config.target_files.empty?
 
     @used_git_fallback = true
@@ -140,38 +134,13 @@ class Evilution::Runner::SubjectPipeline
   end
 
   def build_no_match_error
-    base = "no subject matched '#{config.target}'"
+    base = "no subject matched '#{target}'"
     return base unless @used_git_fallback
 
     "#{base}; scanned git-changed files only. Pass file paths or " \
       "--target source:<glob> to scan the full codebase."
   end
 
-  def target_matcher
-    target = config.target
-    return wildcard_matcher(target.chomp("*")) if target.end_with?("*")
-    return prefix_matcher(target) if target.end_with?("#", ".")
-    return exact_matcher(target) if target.include?("#") || target.include?(".")
-
-    class_matcher(target)
-  end
-
-  def wildcard_matcher(prefix)
-    ->(s) { s.name.split(/[#.]/).first.start_with?(prefix) }
-  end
-
-  def prefix_matcher(prefix)
-    ->(s) { s.name.start_with?(prefix) }
-  end
-
-  def exact_matcher(target)
-    ->(s) { s.name == target }
-  end
-
-  def class_matcher(target)
-    ->(s) { s.name == target || s.name.start_with?("#{target}#") || s.name.start_with?("#{target}.") }
-  end
-
   def filter_by_line_ranges(subjects)
     subjects.select do |subject|
       range = config.line_ranges[subject.file_path]

data/lib/evilution/runner.rb

@@ -71,7 +71,7 @@ class Evilution::Runner
   attr_reader :parser, :registry, :cache, :on_result, :hooks
 
   def subject_pipeline
-    @subject_pipeline ||= Evilution::Runner::SubjectPipeline.new(config, parser: parser)
+    @subject_pipeline ||= Evilution::Runner::SubjectPipeline.new(config, parser: parser, registry: registry)
   end
 
   def mutation_planner

data/lib/evilution/subject.rb

@@ -5,16 +5,33 @@
 # constant outside any method, such as `Point = Data.define(:x, :y)`. A :scope
 # or :aasm subject is the body of a callable handed to a class-body
 # declaration.
+#
+# A :constant_write subject is any other assignment to a constant, the whole
+# of it: `LIMIT = 10`. Applying a mutation re-evaluates the file, which
+# assigns the constant again, and evaluating the original after the tests
+# puts it back. What read the constant while the file first loaded is
+# not run again -- a class-body call (`validates length: { maximum: LIMIT }`)
+# or a constant computed from it in another file keeps the old value -- so
+# only code that reads the constant when called sees the mutant.
+#
+# A subject written in a concern's `included` or `prepended` block is marked
+# `concern_hook`: the block runs in each class that takes the concern, so a
+# mutation of it has to be run again on the classes that took it already.
 class Evilution::Subject
   attr_reader :name, :file_path, :line_number, :source, :node, :kind
 
-  def initialize(name:, file_path:, line_number:, source:, node:, kind: :method)
+  def initialize(name:, file_path:, line_number:, source:, node:, kind: :method, concern_hook: false)
     @name = name
     @file_path = file_path
     @line_number = line_number
     @source = source
     @node = node
     @kind = kind
+    @concern_hook = concern_hook
+  end
+
+  def concern_hook?
+    @concern_hook
   end
 
   def release_node!

data/lib/evilution/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Evilution
-  VERSION = "1.4.0"
+  VERSION = "1.5.0"
 end

data/lib/evilution.rb

@@ -27,6 +27,8 @@ require_relative "evilution/mutator/operator/comparison_replacement"
 require_relative "evilution/mutator/operator/boolean_literal_replacement"
 require_relative "evilution/mutator/operator/integer_literal"
 require_relative "evilution/mutator/operator/float_literal"
+require_relative "evilution/mutator/operator/complex_literal"
+require_relative "evilution/mutator/operator/rational_literal"
 require_relative "evilution/mutator/operator/nil_replacement"
 require_relative "evilution/mutator/operator/boolean_operator_replacement"
 require_relative "evilution/mutator/operator/boolean_operand_promotion"
@@ -65,6 +67,7 @@ require_relative "evilution/mutator/operator/argument_order_permutation"
 require_relative "evilution/mutator/operator/keyword_value_swap"
 require_relative "evilution/mutator/operator/comparison_operand_swap"
 require_relative "evilution/mutator/operator/integer_division_to_fdiv"
+require_relative "evilution/mutator/operator/round_half_mode_swap"
 require_relative "evilution/mutator/operator/off_by_one_boundary"
 require_relative "evilution/mutator/operator/format_specifier_swap"
 require_relative "evilution/mutator/operator/exception_swallow"
@@ -81,6 +84,23 @@ require_relative "evilution/mutator/operator/rescue_handler_promotion"
 require_relative "evilution/mutator/operator/rescue_handler_concatenation"
 require_relative "evilution/mutator/operator/rescue_else_concatenation"
 require_relative "evilution/mutator/operator/return_keyword_removal"
+require_relative "evilution/mutator/operator/memoization_break"
+require_relative "evilution/mutator/operator/short_circuit_to_eager"
+require_relative "evilution/mutator/operator/freeze_removal"
+require_relative "evilution/mutator/operator/rescue_class_widening"
+require_relative "evilution/mutator/operator/visibility_removal"
+require_relative "evilution/mutator/operator/attr_accessor_swap"
+require_relative "evilution/mutator/operator/sleep_to_zero"
+require_relative "evilution/mutator/operator/index_receiver_to_self"
+require_relative "evilution/mutator/operator/index_to_key_predicate"
+require_relative "evilution/mutator/operator/index_range_to_drop"
+require_relative "evilution/mutator/operator/index_write_to_value"
+require_relative "evilution/mutator/operator/constant_read_to_nil"
+require_relative "evilution/mutator/operator/constant_namespace_strip"
+require_relative "evilution/mutator/operator/constant_write_to_nil"
+require_relative "evilution/mutator/operator/variable_read_to_nil"
+require_relative "evilution/mutator/operator/operator_write_receiver_promotion"
+require_relative "evilution/mutator/operator/safe_navigation_insertion"
 require_relative "evilution/mutator/operator/arithmetic_replacement"
 require_relative "evilution/mutator/operator/string_literal"
 require_relative "evilution/mutator/operator/array_literal"
@@ -233,6 +253,48 @@ module Evilution
     @in_isolated_worker = previous
   end
 
+  # Marks the stretch in which the tests run against a mutation whose source has
+  # already loaded. A fork child that dies in it reports the death as the
+  # mutation's doing; one that dies earlier cannot say so.
+  #
+  # The child asks at exit, and by then the block is over in one of two ways.
+  # A stack overflow that exhausts the machine stack before the VM's own makes
+  # Ruby run neither `rescue` nor `ensure`, so the mark is still set. Which of
+  # the two stacks gives out first depends on the stack limit of the process,
+  # not on the Ruby version. Otherwise the exception unwinds through here, the
+  # mark is cleared, and the exception itself is kept to be recognised by.
+  def self.while_running_tests
+    previous = @running_tests
+    @running_tests = true
+    @tests_left_by = nil
+    yield
+  rescue Exception => e # rubocop:disable Lint/RescueException -- recorded and re-raised, never handled
+    @tests_left_by = e
+    raise
+  ensure
+    @running_tests = previous
+  end
+
+  def self.running_tests?
+    @running_tests == true
+  end
+
+  # Whether a process dying on `error` is dying of its test run.
+  def self.died_running_tests?(error)
+    running_tests? || @tests_left_by.equal?(error)
+  end
+
+  # Set by fork isolation in the child it forks for one mutation. Such a
+  # process applies its mutation, runs the tests and ends, so work that only
+  # serves a later mutation in the same process can be left out of it.
+  def self.single_mutation_process!
+    @single_mutation_process = true
+  end
+
+  def self.single_mutation_process?
+    @single_mutation_process == true
+  end
+
   # Base directory for resolving project-relative paths. An isolated worker
   # has chdir'd into a per-mutation sandbox (EV-wqxu / GH #1278), so callers
   # in that context must anchor against PROJECT_ROOT rather than Dir.pwd —

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: evilution
 version: !ruby/object:Gem::Version
-  version: 1.4.0
+  version: 1.5.0
 platform: ruby
 authors:
 - Denis Kiselev
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-08 00:00:00.000000000 Z
+date: 2026-10-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs
@@ -142,12 +142,14 @@ files:
 - lib/evilution/ast.rb
 - lib/evilution/ast/aasm_declaration.rb
 - lib/evilution/ast/callback_declaration.rb
+- lib/evilution/ast/class_body.rb
 - lib/evilution/ast/constant_names.rb
 - lib/evilution/ast/heredoc_span.rb
 - lib/evilution/ast/included_block.rb
 - lib/evilution/ast/inheritance_scanner.rb
 - lib/evilution/ast/literal_callable.rb
 - lib/evilution/ast/local_reads.rb
+- lib/evilution/ast/never_nil.rb
 - lib/evilution/ast/parser.rb
 - lib/evilution/ast/pattern.rb
 - lib/evilution/ast/pattern/filter.rb
@@ -155,9 +157,11 @@ files:
 - lib/evilution/ast/pattern/method_name.rb
 - lib/evilution/ast/pattern/parser.rb
 - lib/evilution/ast/regexp_pattern.rb
+- lib/evilution/ast/round_half_mode.rb
 - lib/evilution/ast/scope_declaration.rb
 - lib/evilution/ast/sorbet_sig_detector.rb
 - lib/evilution/ast/source_surgeon.rb
+- lib/evilution/ast/syntax_check.rb
 - lib/evilution/ast/uncovered_code.rb
 - lib/evilution/ast/value_object_definition.rb
 - lib/evilution/baseline.rb
@@ -282,9 +286,11 @@ files:
 - lib/evilution/integration/loading/concern_state_cleaner.rb
 - lib/evilution/integration/loading/constant_pinner.rb
 - lib/evilution/integration/loading/mutation_applier.rb
+- lib/evilution/integration/loading/own_methods.rb
 - lib/evilution/integration/loading/redefinition_recovery.rb
 - lib/evilution/integration/loading/reeval_warning_filter.rb
 - lib/evilution/integration/loading/source_evaluator.rb
+- lib/evilution/integration/loading/superseded_modules.rb
 - lib/evilution/integration/loading/syntax_validator.rb
 - lib/evilution/integration/loading/test_class_cache.rb
 - lib/evilution/integration/loading/test_load_path.rb
@@ -353,6 +359,7 @@ files:
 - lib/evilution/mutation.rb
 - lib/evilution/mutator.rb
 - lib/evilution/mutator/base.rb
+- lib/evilution/mutator/constant_value_subjects.rb
 - lib/evilution/mutator/operator.rb
 - lib/evilution/mutator/operator/alias_removal.rb
 - lib/evilution/mutator/operator/argument_list_removal.rb
@@ -364,6 +371,7 @@ files:
 - lib/evilution/mutator/operator/arithmetic_replacement.rb
 - lib/evilution/mutator/operator/array_coercion_to_literal.rb
 - lib/evilution/mutator/operator/array_literal.rb
+- lib/evilution/mutator/operator/attr_accessor_swap.rb
 - lib/evilution/mutator/operator/attribute_write_to_read.rb
 - lib/evilution/mutator/operator/bang_method.rb
 - lib/evilution/mutator/operator/begin_unwrap.rb
@@ -392,11 +400,15 @@ files:
 - lib/evilution/mutator/operator/collection_return.rb
 - lib/evilution/mutator/operator/comparison_operand_swap.rb
 - lib/evilution/mutator/operator/comparison_replacement.rb
+- lib/evilution/mutator/operator/complex_literal.rb
 - lib/evilution/mutator/operator/compound_assignment.rb
 - lib/evilution/mutator/operator/conditional_branch.rb
 - lib/evilution/mutator/operator/conditional_flip.rb
 - lib/evilution/mutator/operator/conditional_negation.rb
 - lib/evilution/mutator/operator/const_get_to_constant_path.rb
+- lib/evilution/mutator/operator/constant_namespace_strip.rb
+- lib/evilution/mutator/operator/constant_read_to_nil.rb
+- lib/evilution/mutator/operator/constant_write_to_nil.rb
 - lib/evilution/mutator/operator/data_struct_member.rb
 - lib/evilution/mutator/operator/defined_check.rb
 - lib/evilution/mutator/operator/dig_to_fetch_chain.rb
@@ -410,13 +422,18 @@ files:
 - lib/evilution/mutator/operator/format_specifier_swap.rb
 - lib/evilution/mutator/operator/forwarded_argument_drop.rb
 - lib/evilution/mutator/operator/forwarding_super_to_explicit.rb
+- lib/evilution/mutator/operator/freeze_removal.rb
 - lib/evilution/mutator/operator/global_variable_write.rb
 - lib/evilution/mutator/operator/hash_literal.rb
 - lib/evilution/mutator/operator/if_branch_swap.rb
 - lib/evilution/mutator/operator/index_assignment_removal.rb
+- lib/evilution/mutator/operator/index_range_to_drop.rb
+- lib/evilution/mutator/operator/index_receiver_to_self.rb
 - lib/evilution/mutator/operator/index_to_at.rb
 - lib/evilution/mutator/operator/index_to_dig.rb
 - lib/evilution/mutator/operator/index_to_fetch.rb
+- lib/evilution/mutator/operator/index_to_key_predicate.rb
+- lib/evilution/mutator/operator/index_write_to_value.rb
 - lib/evilution/mutator/operator/inequality_to_negated_identity.rb
 - lib/evilution/mutator/operator/inline_rescue.rb
 - lib/evilution/mutator/operator/instance_variable_write.rb
@@ -430,6 +447,7 @@ files:
 - lib/evilution/mutator/operator/local_variable_assignment.rb
 - lib/evilution/mutator/operator/loop_body_to_raise.rb
 - lib/evilution/mutator/operator/loop_flip.rb
+- lib/evilution/mutator/operator/memoization_break.rb
 - lib/evilution/mutator/operator/method_body_replacement.rb
 - lib/evilution/mutator/operator/method_body_to_raise.rb
 - lib/evilution/mutator/operator/method_body_to_super.rb
@@ -442,6 +460,7 @@ files:
 - lib/evilution/mutator/operator/no_matching_pattern_else.rb
 - lib/evilution/mutator/operator/numbered_parameter_swap.rb
 - lib/evilution/mutator/operator/off_by_one_boundary.rb
+- lib/evilution/mutator/operator/operator_write_receiver_promotion.rb
 - lib/evilution/mutator/operator/optional_default_injection.rb
 - lib/evilution/mutator/operator/optional_parameter_to_required.rb
 - lib/evilution/mutator/operator/pattern_matching_alternative.rb
@@ -454,6 +473,7 @@ files:
 - lib/evilution/mutator/operator/predicate_to_nil.rb
 - lib/evilution/mutator/operator/proc_to_lambda.rb
 - lib/evilution/mutator/operator/range_replacement.rb
+- lib/evilution/mutator/operator/rational_literal.rb
 - lib/evilution/mutator/operator/receiver_constructor_swap.rb
 - lib/evilution/mutator/operator/receiver_replacement.rb
 - lib/evilution/mutator/operator/redo_statement.rb
@@ -470,6 +490,7 @@ files:
 - lib/evilution/mutator/operator/regexp_option_removal.rb
 - lib/evilution/mutator/operator/regexp_quantifier_minimum_swap.rb
 - lib/evilution/mutator/operator/rescue_body_replacement.rb
+- lib/evilution/mutator/operator/rescue_class_widening.rb
 - lib/evilution/mutator/operator/rescue_else_concatenation.rb
 - lib/evilution/mutator/operator/rescue_handler_concatenation.rb
 - lib/evilution/mutator/operator/rescue_handler_promotion.rb
@@ -478,9 +499,13 @@ files:
 - lib/evilution/mutator/operator/return_keyword_removal.rb
 - lib/evilution/mutator/operator/return_value_removal.rb
 - lib/evilution/mutator/operator/rightward_assignment.rb
+- lib/evilution/mutator/operator/round_half_mode_swap.rb
+- lib/evilution/mutator/operator/safe_navigation_insertion.rb
 - lib/evilution/mutator/operator/safe_navigation_removal.rb
 - lib/evilution/mutator/operator/scalar_return.rb
 - lib/evilution/mutator/operator/send_mutation.rb
+- lib/evilution/mutator/operator/short_circuit_to_eager.rb
+- lib/evilution/mutator/operator/sleep_to_zero.rb
 - lib/evilution/mutator/operator/splat_operator.rb
 - lib/evilution/mutator/operator/statement_deletion.rb
 - lib/evilution/mutator/operator/statement_reorder.rb
@@ -491,9 +516,12 @@ files:
 - lib/evilution/mutator/operator/symbol_to_proc_replacement.rb
 - lib/evilution/mutator/operator/to_i_to_integer.rb
 - lib/evilution/mutator/operator/typed_default_return.rb
+- lib/evilution/mutator/operator/variable_read_to_nil.rb
+- lib/evilution/mutator/operator/visibility_removal.rb
 - lib/evilution/mutator/operator/yield_statement.rb
 - lib/evilution/mutator/operator/zsuper_removal.rb
 - lib/evilution/mutator/primitives.rb
+- lib/evilution/mutator/receiver_positions.rb
 - lib/evilution/mutator/registry.rb
 - lib/evilution/mutator/rescue_handlers.rb
 - lib/evilution/parallel.rb
@@ -504,6 +532,7 @@ files:
 - lib/evilution/parallel/work_queue/collection_state.rb
 - lib/evilution/parallel/work_queue/dispatcher.rb
 - lib/evilution/parallel/work_queue/dispatcher/deadline_tracker.rb
+- lib/evilution/parallel/work_queue/dispatcher/reply.rb
 - lib/evilution/parallel/work_queue/validators.rb
 - lib/evilution/parallel/work_queue/validators/optional_positive_int.rb
 - lib/evilution/parallel/work_queue/validators/optional_positive_number.rb
@@ -628,6 +657,7 @@ files:
 - lib/evilution/runner/mutation_planner.rb
 - lib/evilution/runner/report_publisher.rb
 - lib/evilution/runner/subject_pipeline.rb
+- lib/evilution/runner/subject_pipeline/target.rb
 - lib/evilution/runner/target_spec_audit.rb
 - lib/evilution/session.rb
 - lib/evilution/session/diff.rb