mutant 0.10.34 → 0.11.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ccd2a5c4c1c3ddf3b7eea82c613a144594609387a414cac729b75c4645295f47
-  data.tar.gz: e173ad25eb08658a040a7ca7cb6dca36a1d8bc9f01137e63fed081069b3ab9cb
+  metadata.gz: b75a7265756d1903cb93a5937959a7fca2a38d157eedf9287d1004b7bd5a05a4
+  data.tar.gz: 96c7945d43c9ba8dd5c9ef362b4bccc5a536eddf91526a9cb1bce4333df542cc
 SHA512:
-  metadata.gz: bdebc9987d92b122b409715cc7933dc86952ae6dc58ed8f9a5525bcbfe8dc0aae93cf773622eced59643d27d4311df1f94f9c41a1abd1adc93e4a6b65771118d
-  data.tar.gz: 9e7d2dde25b8e532301475e8b7bc970626db00d36ce0abd5e4082aa2b39599a86372b4de93e5d61470f974f90539cf5445d51e242bcfbfec600ad8a5fca2b5aa
+  metadata.gz: 53bf6c9d0de1fb8305fa7e7fce7e2072e381c6a088b0f6e08049222f46de4f908466d498c104f72fd19ddcf1cd7fa2f1cbc2beff099bd5529e880b3bf6a4c2ae
+  data.tar.gz: 3cc43c8eefce22bceb8465c4b475d4e0cc5b1e2c01a29997713e137605483d33ff792e368a37afd66316113f0495ae2ac265ec22af638cb112785da95f2261f9

data/lib/mutant/bootstrap.rb

@@ -71,6 +71,10 @@ module Mutant
 
       hooks.run(:env_infection_pre, env)
 
+      config.environment_variables.each do |key, value|
+        world.environment_variables[key] = value
+      end
+
       config.includes.each(&world.load_path.public_method(:<<))
       config.requires.each(&world.kernel.public_method(:require))
 

data/lib/mutant/cli/command/environment/irb.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Mutant
+  module CLI
+    class Command
+      class Environment
+        class IRB < self
+          NAME              = 'irb'
+          SHORT_DESCRIPTION = 'Run irb with mutant environment loaded'
+          SUBCOMMANDS       = EMPTY_ARRAY
+
+        private
+
+          def action
+            bootstrap.fmap { TOPLEVEL_BINDING.irb }
+          end
+        end # IRB
+      end # Environment
+    end # Command
+  end # CLI
+end # Mutant

data/lib/mutant/cli/command/environment.rb

@@ -62,6 +62,7 @@ module Mutant
           set(matcher: @config.matcher.add(attribute, value))
         end
 
+        # rubocop:disable Metrics/MethodLength
         def add_environment_options(parser)
           parser.separator('Environment:')
           parser.on('--zombie', 'Run mutant zombified') do
@@ -73,7 +74,14 @@ module Mutant
           parser.on('-r', '--require NAME', 'Require file with NAME') do |name|
             add(:requires, name)
           end
+          parser.on('--env KEY=VALUE', 'Set environment variable') do |value|
+            match = ENV_VARIABLE_KEY_VALUE_REGEXP.match(value) || fail("Invalid env variable: #{value.inspect}")
+            set(
+              environment_variables: @config.environment_variables.merge(match[:key] => match[:value])
+            )
+          end
         end
+        # rubocop:enable Metrics/MethodLength
 
         def add_integration_options(parser)
           parser.separator('Integration:')

data/lib/mutant/cli/command/root.rb

@@ -4,7 +4,7 @@ module Mutant
   module CLI
     class Command
       class Environment < self
-        SUBCOMMANDS = [Environment::Subject, Environment::Show, Environment::Test].freeze
+        SUBCOMMANDS = [Environment::Subject, Environment::Show, Environment::IRB, Environment::Test].freeze
       end # Environment
 
       class Root < self

data/lib/mutant/config.rb

@@ -5,9 +5,12 @@ module Mutant
   #
   # Does not reference any "external" volatile state. The configuration applied
   # to current environment is being represented by the Mutant::Env object.
+  #
+  # rubocop:disable Metrics/ClassLength
   class Config
     include Adamantium, Anima.new(
       :coverage_criteria,
+      :environment_variables,
       :expression_parser,
       :fail_fast,
       :hooks,
@@ -48,16 +51,17 @@ module Mutant
     # rubocop:disable Metrics/MethodLength
     def merge(other)
       other.with(
-        coverage_criteria: coverage_criteria.merge(other.coverage_criteria),
-        fail_fast:         fail_fast || other.fail_fast,
-        hooks:             hooks + other.hooks,
-        includes:          includes + other.includes,
-        integration:       other.integration || integration,
-        jobs:              other.jobs || jobs,
-        matcher:           matcher.merge(other.matcher),
-        mutation_timeout:  other.mutation_timeout || mutation_timeout,
-        requires:          requires + other.requires,
-        zombie:            zombie || other.zombie
+        coverage_criteria:     coverage_criteria.merge(other.coverage_criteria),
+        environment_variables: environment_variables.merge(other.environment_variables),
+        fail_fast:             fail_fast || other.fail_fast,
+        hooks:                 hooks + other.hooks,
+        includes:              includes + other.includes,
+        integration:           other.integration || integration,
+        jobs:                  other.jobs || jobs,
+        matcher:               matcher.merge(other.matcher),
+        mutation_timeout:      other.mutation_timeout || mutation_timeout,
+        requires:              requires + other.requires,
+        zombie:                zombie || other.zombie
       )
     end
     # rubocop:enable Metrics/AbcSize
@@ -117,6 +121,24 @@ module Mutant
       )
     )
 
+    # Parse a hash of environment variables
+    #
+    # @param [Hash<Object,Object>]
+    #
+    # @return [Either<String,Hash<String,String>]
+    #
+    def self.parse_environment_variables(hash)
+      invalid = hash.keys.reject { |key| key.instance_of?(String) }
+      return Either::Left.new("Non string keys: #{invalid}") if invalid.any?
+
+      invalid = hash.keys.grep_v(ENV_VARIABLE_KEY_REGEXP)
+      return Either::Left.new("Invalid keys: #{invalid}") if invalid.any?
+
+      invalid = hash.values.reject { |value| value.instance_of?(String) }
+      return Either::Left.new("Non string values: #{invalid}") if invalid.any?
+
+      Either::Right.new(hash)
+    end
     TRANSFORM = Transform::Sequence.new(
       [
         Transform::Exception.new(SystemCallError, :read.to_proc),
@@ -124,14 +146,23 @@ module Mutant
         Transform::Hash.new(
           optional: [
             Transform::Hash::Key.new('coverage_criteria', ->(value) { CoverageCriteria::TRANSFORM.call(value) }),
-            Transform::Hash::Key.new('fail_fast',         Transform::BOOLEAN),
-            Transform::Hash::Key.new('hooks',             PATHNAME_ARRAY),
-            Transform::Hash::Key.new('includes',          Transform::STRING_ARRAY),
-            Transform::Hash::Key.new('integration',       Transform::STRING),
-            Transform::Hash::Key.new('jobs',              Transform::INTEGER),
-            Transform::Hash::Key.new('matcher',           Matcher::Config::LOADER),
-            Transform::Hash::Key.new('mutation_timeout',  Transform::FLOAT),
-            Transform::Hash::Key.new('requires',          Transform::STRING_ARRAY)
+            Transform::Hash::Key.new(
+              'environment_variables',
+              Transform::Sequence.new(
+                [
+                  Transform::Primitive.new(Hash),
+                  Transform::Block.capture(:environment_variables, &method(:parse_environment_variables))
+                ]
+              )
+            ),
+            Transform::Hash::Key.new('fail_fast',             Transform::BOOLEAN),
+            Transform::Hash::Key.new('hooks',                 PATHNAME_ARRAY),
+            Transform::Hash::Key.new('includes',              Transform::STRING_ARRAY),
+            Transform::Hash::Key.new('integration',           Transform::STRING),
+            Transform::Hash::Key.new('jobs',                  Transform::INTEGER),
+            Transform::Hash::Key.new('matcher',               Matcher::Config::LOADER),
+            Transform::Hash::Key.new('mutation_timeout',      Transform::FLOAT),
+            Transform::Hash::Key.new('requires',              Transform::STRING_ARRAY)
           ],
           required: []
         ),
@@ -141,4 +172,5 @@ module Mutant
 
     private_constant(:TRANSFORM)
   end # Config
+  # rubocop:enable Metrics/ClassLength
 end # Mutant

data/lib/mutant/expression/descendants.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Mutant
+  class Expression
+    class Descendants < self
+      include Anima.new(:const_name)
+
+      REGEXP = /\Adescendants:(?<const_name>.+)\z/.freeze
+
+      def syntax
+        "descendants:#{const_name}"
+      end
+
+      def matcher
+        Matcher::Descendants.new(const_name: const_name)
+      end
+    end # Descendants
+  end # Expression
+end # Mutant

data/lib/mutant/matcher/chain.rb

@@ -14,7 +14,7 @@ module Mutant
       def call(env)
         matchers.flat_map do |matcher|
           matcher.call(env)
-        end
+        end.uniq
       end
 
     end # Chain

data/lib/mutant/matcher/descendants.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Mutant
+  class Matcher
+    # Matcher for all descendants by constant name
+    class Descendants < self
+      include Anima.new(:const_name)
+
+      def call(env)
+        const = env.world.try_const_get(const_name) or return EMPTY_ARRAY
+
+        Chain.new(
+          matched_scopes(env, const).map { |scope| Scope.new(scope.raw) }
+        ).call(env)
+      end
+
+    private
+
+      def matched_scopes(env, const)
+        env.matchable_scopes.select do |scope|
+          scope.raw.equal?(const) || const > scope.raw
+        end
+      end
+    end # Descendant
+  end # Matcher
+end # Mutant

data/lib/mutant/matcher/method.rb

@@ -82,7 +82,17 @@ module Mutant
         end
 
         def source_location
-          target_method.source_location
+          signature = sorbet_signature
+
+          if signature
+            signature.method.source_location
+          else
+            target_method.source_location
+          end
+        end
+
+        def sorbet_signature
+          T::Private::Methods.signature_for_method(target_method)
         end
 
         def subject

data/lib/mutant/matcher/methods.rb

@@ -21,7 +21,7 @@ module Mutant
       # @return [Enumerable<Subject>]
       def call(env)
         Chain.new(
-          methods.map { |method| matcher.new(scope, method) }
+          methods(env).map { |method| matcher.new(scope, method) }
         ).call(env)
       end
 
@@ -31,17 +31,16 @@ module Mutant
         self.class::MATCHER
       end
 
-      def methods
+      def methods(env)
         candidate_names.each_with_object([]) do |name, methods|
-          method = access(name)
-          methods << method if method.owner.equal?(candidate_scope)
+          method = access(env, name)
+          methods << method if method&.owner.equal?(candidate_scope)
         end
       end
-      memoize :methods
 
       def candidate_names
         CANDIDATE_NAMES
-          .map(&candidate_scope.public_method(:public_send))
+          .map { |name| candidate_scope.public_send(name, false) }
           .reduce(:+)
           .sort
       end
@@ -55,7 +54,7 @@ module Mutant
 
       private
 
-        def access(method_name)
+        def access(_env, method_name)
           scope.method(method_name)
         end
 
@@ -71,7 +70,7 @@ module Mutant
 
       private
 
-        def access(method_name)
+        def access(_env, method_name)
           scope.method(method_name)
         end
 
@@ -84,11 +83,33 @@ module Mutant
       class Instance < self
         MATCHER = Matcher::Method::Instance
 
+        MESSAGE = <<~'MESSAGE'
+          Caught an exception while accessing a method with
+          #instance_method that is part of #{public,privat,protected}_instance_methods.
+
+          This is a bug in your ruby implementation its stdlib, libaries our your code.
+
+          Mutant will ignore this method:
+
+          Object:    %<scope>s
+          Method:    %<method_name>s
+          Exception: %<exception>s
+
+          See: https://github.com/mbj/mutant/issues/1273
+        MESSAGE
+
       private
 
-        def access(method_name)
+        # rubocop:disable Lint/RescueException
+        def access(env, method_name)
           scope.instance_method(method_name)
+        rescue Exception => exception
+          env.warn(
+            MESSAGE % { scope: scope, method_name: method_name, exception: exception }
+          )
+          nil
         end
+        # rubocop:enable Lint/RescueException
 
         def candidate_scope
           scope

data/lib/mutant/version.rb

@@ -2,5 +2,5 @@
 
 module Mutant
   # Current mutant version
-  VERSION = '0.10.34'
+  VERSION = '0.11.2'
 end # Mutant

data/lib/mutant/world.rb

@@ -5,6 +5,7 @@ module Mutant
   class World
     include Adamantium, Anima.new(
       :condition_variable,
+      :environment_variables,
       :gem,
       :gem_method,
       :io,
@@ -49,6 +50,19 @@ module Mutant
       end
     end
 
+    # Try const get
+    #
+    # @param [String]
+    #
+    # @return [Class|Module|nil]
+    #
+    # rubocop:disable Lint/SuppressedException
+    def try_const_get(name)
+      kernel.const_get(name)
+    rescue NameError
+    end
+    # rubocop:enable Lint/SuppressedException
+
     # Deadline
     #
     # @param [Float, nil] allowed_time

data/lib/mutant.rb

@@ -4,6 +4,7 @@ require 'diff/lcs'
 require 'diff/lcs/hunk'
 require 'digest/sha1'
 require 'etc'
+require 'irb'
 require 'json'
 require 'open3'
 require 'optparse'
@@ -13,6 +14,7 @@ require 'pathname'
 require 'regexp_parser'
 require 'set'
 require 'singleton'
+require 'sorbet-runtime'
 require 'stringio'
 require 'unparser'
 require 'yaml'
@@ -36,6 +38,11 @@ module Mutant
   EMPTY_ARRAY    = [].freeze
   EMPTY_HASH     = {}.freeze
   SCOPE_OPERATOR = '::'
+
+  env_key = /[a-zA-Z_\d]+/
+
+  ENV_VARIABLE_KEY_VALUE_REGEXP = /\A(?<key>#{env_key}+)=(?<value>.*)\z/.freeze
+  ENV_VARIABLE_KEY_REGEXP       = /\A#{env_key}\z/.freeze
 end # Mutant
 
 require 'mutant/procto'
@@ -162,23 +169,25 @@ require 'mutant/subject/method/instance'
 require 'mutant/subject/method/singleton'
 require 'mutant/subject/method/metaclass'
 require 'mutant/matcher'
-require 'mutant/matcher/config'
 require 'mutant/matcher/chain'
+require 'mutant/matcher/config'
+require 'mutant/matcher/descendants'
+require 'mutant/matcher/filter'
 require 'mutant/matcher/method'
-require 'mutant/matcher/method/singleton'
-require 'mutant/matcher/method/metaclass'
 require 'mutant/matcher/method/instance'
+require 'mutant/matcher/method/metaclass'
+require 'mutant/matcher/method/singleton'
 require 'mutant/matcher/methods'
 require 'mutant/matcher/namespace'
-require 'mutant/matcher/scope'
-require 'mutant/matcher/filter'
 require 'mutant/matcher/null'
+require 'mutant/matcher/scope'
 require 'mutant/matcher/static'
 require 'mutant/expression'
-require 'mutant/expression/parser'
+require 'mutant/expression/descendants'
 require 'mutant/expression/method'
 require 'mutant/expression/methods'
 require 'mutant/expression/namespace'
+require 'mutant/expression/parser'
 require 'mutant/test'
 require 'mutant/timer'
 require 'mutant/integration'
@@ -194,6 +203,7 @@ require 'mutant/cli'
 require 'mutant/cli/command'
 require 'mutant/cli/command/subscription'
 require 'mutant/cli/command/environment'
+require 'mutant/cli/command/environment/irb'
 require 'mutant/cli/command/environment/run'
 require 'mutant/cli/command/environment/show'
 require 'mutant/cli/command/environment/subject'
@@ -231,46 +241,49 @@ require 'mutant/license/subscription/commercial'
 
 module Mutant
   WORLD = World.new(
-    condition_variable: ConditionVariable,
-    gem:                Gem,
-    gem_method:         method(:gem),
-    io:                 IO,
-    json:               JSON,
-    kernel:             Kernel,
-    load_path:          $LOAD_PATH,
-    marshal:            Marshal,
-    mutex:              Mutex,
-    object_space:       ObjectSpace,
-    open3:              Open3,
-    pathname:           Pathname,
-    process:            Process,
-    stderr:             $stderr,
-    stdout:             $stdout,
-    thread:             Thread,
-    timer:              Timer.new(Process)
+    condition_variable:    ConditionVariable,
+    environment_variables: ENV,
+    gem:                   Gem,
+    gem_method:            method(:gem),
+    io:                    IO,
+    json:                  JSON,
+    kernel:                Kernel,
+    load_path:             $LOAD_PATH,
+    marshal:               Marshal,
+    mutex:                 Mutex,
+    object_space:          ObjectSpace,
+    open3:                 Open3,
+    pathname:              Pathname,
+    process:               Process,
+    stderr:                $stderr,
+    stdout:                $stdout,
+    thread:                Thread,
+    timer:                 Timer.new(Process)
   )
 
   # Reopen class to initialize constant to avoid dep circle
   class Config
     DEFAULT = new(
-      coverage_criteria: Config::CoverageCriteria::EMPTY,
-      expression_parser: Expression::Parser.new([
+      coverage_criteria:     Config::CoverageCriteria::EMPTY,
+      expression_parser:     Expression::Parser.new([
+        Expression::Descendants,
         Expression::Method,
         Expression::Methods,
         Expression::Namespace::Exact,
         Expression::Namespace::Recursive
       ]),
-      fail_fast:         false,
-      hooks:             EMPTY_ARRAY,
-      includes:          EMPTY_ARRAY,
-      integration:       nil,
-      isolation:         Mutant::Isolation::Fork.new(WORLD),
-      jobs:              nil,
-      matcher:           Matcher::Config::DEFAULT,
-      mutation_timeout:  nil,
-      reporter:          Reporter::CLI.build(WORLD.stdout),
-      requires:          EMPTY_ARRAY,
-      zombie:            false
+      fail_fast:             false,
+      environment_variables: EMPTY_HASH,
+      hooks:                 EMPTY_ARRAY,
+      includes:              EMPTY_ARRAY,
+      integration:           nil,
+      isolation:             Mutant::Isolation::Fork.new(WORLD),
+      jobs:                  nil,
+      matcher:               Matcher::Config::DEFAULT,
+      mutation_timeout:      nil,
+      reporter:              Reporter::CLI.build(WORLD.stdout),
+      requires:              EMPTY_ARRAY,
+      zombie:                false
     )
   end # Config
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mutant
 version: !ruby/object:Gem::Version
-  version: 0.10.34
+  version: 0.11.2
 platform: ruby
 authors:
 - Markus Schirp
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-08-30 00:00:00.000000000 Z
+date: 2021-11-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: diff-lcs
@@ -58,20 +58,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 2.0.3
+- !ruby/object:Gem::Dependency
+  name: sorbet-runtime
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: unparser
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.6.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 0.6.2
 - !ruby/object:Gem::Dependency
   name: parallel
   requirement: !ruby/object:Gem::Requirement
@@ -180,6 +194,7 @@ files:
 - lib/mutant/cli.rb
 - lib/mutant/cli/command.rb
 - lib/mutant/cli/command/environment.rb
+- lib/mutant/cli/command/environment/irb.rb
 - lib/mutant/cli/command/environment/run.rb
 - lib/mutant/cli/command/environment/show.rb
 - lib/mutant/cli/command/environment/subject.rb
@@ -192,6 +207,7 @@ files:
 - lib/mutant/context.rb
 - lib/mutant/env.rb
 - lib/mutant/expression.rb
+- lib/mutant/expression/descendants.rb
 - lib/mutant/expression/method.rb
 - lib/mutant/expression/methods.rb
 - lib/mutant/expression/namespace.rb
@@ -211,6 +227,7 @@ files:
 - lib/mutant/matcher.rb
 - lib/mutant/matcher/chain.rb
 - lib/mutant/matcher/config.rb
+- lib/mutant/matcher/descendants.rb
 - lib/mutant/matcher/filter.rb
 - lib/mutant/matcher/method.rb
 - lib/mutant/matcher/method/instance.rb
@@ -360,7 +377,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="