mutant 0.8.24 → 0.9.0

data/docs/mutant-minitest.md

@@ -63,7 +63,7 @@ bundle exec mutant --include lib --require auom --use minitest -- 'AUOM*'
 This prints a report like:
 
 ```sh
-Mutant configuration:
+Mutant environment:
 Matcher:         #<Mutant::Matcher::Config match_expressions: [AUOM*]>
 Integration:     Mutant::Integration::Minitest
 Jobs:            8

data/docs/mutant-rspec.md

@@ -17,11 +17,7 @@ To add mutant to your rspec code base you need to:
    gem 'mutant-rspec'
    ```
 
-2. Run mutant against the rspec integration
-
-   ```sh
-   bundle exec mutant --include lib --require 'your_library.rb' --use rspec -- 'YourLibrary*'
-   ```
+2. Run mutant against the rspec integration via the `--use rspec` flag.
 
 ## Run through example
 
@@ -41,7 +37,7 @@ bundle exec mutant --include lib --require auom --use rspec -- 'AUOM*'
 This prints a report like:
 
 ```sh
-Mutant configuration:
+Mutant environment:
 Matcher:         #<Mutant::Matcher::Config match_expressions: [AUOM*]>
 Integration:     Mutant::Integration::Rspec
 Jobs:            8
@@ -129,24 +125,6 @@ description prefixes in `Foo::Bar#baz`, `Foo::Bar` and `Foo`. The order is
 important, so if mutant finds example groups in the current prefix level,
 these example groups *must* kill the mutation.
 
-Rails
--------
-
-To mutation test Rails models with rspec, comment out `require 'rspec/autorun'`
-from your `spec_helper.rb` file. Having done so you should be able to use
-commands like the following:
-
 ```sh
 RAILS_ENV=test bundle exec mutant -r ./config/environment --use rspec User
 ```
-
-Passing in RSpec Options
-------------------------
-
-**NOTE: Experimental**
-
-You can control some aspects of RSpec using the `SPEC_OPTS` environment variable as usual. If you want mutant to only pay attention to specs in a certain directory, you can run
-
-```sh
-SPEC_OPTS="--pattern spec/subdir_only/**/*_spec.rb" bundle exec mutant --use rspec SomeClass
-```

data/lib/mutant.rb

@@ -7,19 +7,22 @@ require 'concord'
 require 'diff/lcs'
 require 'diff/lcs/hunk'
 require 'digest/sha1'
-require 'etc'
 require 'equalizer'
+require 'etc'
 require 'ice_nine'
-require 'morpher'
+require 'json'
 require 'open3'
 require 'optparse'
 require 'parser'
 require 'parser/current'
 require 'pathname'
-require 'regexp_parser'
 require 'set'
+require 'singleton'
 require 'stringio'
 require 'unparser'
+require 'yaml'
+
+gem 'mutant-license'
 
 # This setting is done to make errors within the parallel
 # reporter / execution visible in the main thread.
@@ -33,18 +36,12 @@ module Mutant
   EMPTY_ARRAY    = [].freeze
   EMPTY_HASH     = {}.freeze
   SCOPE_OPERATOR = '::'
-
-  # Test if CI is detected via environment
-  #
-  # @return [Boolean]
-  def self.ci?
-    ENV.key?('CI')
-  end
 end # Mutant
 
+require 'mutant/base'
+require 'mutant/bootstrap'
 require 'mutant/version'
 require 'mutant/env'
-require 'mutant/env/bootstrap'
 require 'mutant/util'
 require 'mutant/registry'
 require 'mutant/ast'
@@ -53,36 +50,20 @@ require 'mutant/ast/types'
 require 'mutant/ast/nodes'
 require 'mutant/ast/named_children'
 require 'mutant/ast/node_predicates'
-require 'mutant/ast/regexp'
-require 'mutant/ast/regexp/transformer'
-require 'mutant/ast/regexp/transformer/direct'
-require 'mutant/ast/regexp/transformer/named_group'
-require 'mutant/ast/regexp/transformer/options_group'
-require 'mutant/ast/regexp/transformer/quantifier'
-require 'mutant/ast/regexp/transformer/recursive'
-require 'mutant/ast/regexp/transformer/root'
-require 'mutant/ast/regexp/transformer/text'
 require 'mutant/ast/meta'
 require 'mutant/ast/meta/send'
 require 'mutant/ast/meta/const'
 require 'mutant/ast/meta/symbol'
 require 'mutant/ast/meta/optarg'
 require 'mutant/ast/meta/resbody'
-require 'mutant/ast/meta/restarg'
-require 'mutant/actor'
-require 'mutant/actor/receiver'
-require 'mutant/actor/sender'
-require 'mutant/actor/mailbox'
-require 'mutant/actor/env'
 require 'mutant/parser'
 require 'mutant/isolation'
 require 'mutant/isolation/none'
 require 'mutant/isolation/fork'
 require 'mutant/parallel'
-require 'mutant/parallel/master'
-require 'mutant/parallel/worker'
+require 'mutant/parallel/driver'
 require 'mutant/parallel/source'
-require 'mutant/warning_filter'
+require 'mutant/parallel/worker'
 require 'mutant/require_highjack'
 require 'mutant/mutation'
 require 'mutant/mutator'
@@ -91,13 +72,6 @@ require 'mutant/mutator/util/array'
 require 'mutant/mutator/util/symbol'
 require 'mutant/mutator/node'
 require 'mutant/mutator/node/generic'
-require 'mutant/mutator/node/regexp'
-require 'mutant/mutator/node/regexp/alternation_meta'
-require 'mutant/mutator/node/regexp/capture_group'
-require 'mutant/mutator/node/regexp/character_type'
-require 'mutant/mutator/node/regexp/end_of_line_anchor'
-require 'mutant/mutator/node/regexp/end_of_string_or_before_end_of_line_anchor'
-require 'mutant/mutator/node/regexp/greedy_zero_or_more'
 require 'mutant/mutator/node/literal'
 require 'mutant/mutator/node/literal/boolean'
 require 'mutant/mutator/node/literal/range'
@@ -161,7 +135,6 @@ require 'mutant/subject/method/instance'
 require 'mutant/subject/method/singleton'
 require 'mutant/matcher'
 require 'mutant/matcher/config'
-require 'mutant/matcher/compiler'
 require 'mutant/matcher/chain'
 require 'mutant/matcher/method'
 require 'mutant/matcher/method/singleton'
@@ -179,9 +152,12 @@ require 'mutant/expression/methods'
 require 'mutant/expression/namespace'
 require 'mutant/test'
 require 'mutant/timer'
+require 'mutant/transform'
 require 'mutant/integration'
+require 'mutant/integration/null'
 require 'mutant/selector'
 require 'mutant/selector/expression'
+require 'mutant/selector/null'
 require 'mutant/config'
 require 'mutant/cli'
 require 'mutant/color'
@@ -195,22 +171,49 @@ require 'mutant/reporter/sequence'
 require 'mutant/reporter/cli'
 require 'mutant/reporter/cli/printer'
 require 'mutant/reporter/cli/printer/config'
+require 'mutant/reporter/cli/printer/env'
 require 'mutant/reporter/cli/printer/env_progress'
 require 'mutant/reporter/cli/printer/env_result'
 require 'mutant/reporter/cli/printer/isolation_result'
 require 'mutant/reporter/cli/printer/mutation_progress_result'
 require 'mutant/reporter/cli/printer/mutation_result'
-require 'mutant/reporter/cli/printer/status'
 require 'mutant/reporter/cli/printer/status_progressive'
 require 'mutant/reporter/cli/printer/subject_progress'
 require 'mutant/reporter/cli/printer/subject_result'
 require 'mutant/reporter/cli/printer/test_result'
-require 'mutant/reporter/cli/tput'
 require 'mutant/reporter/cli/format'
 require 'mutant/repository'
+require 'mutant/repository/diff'
+require 'mutant/repository/diff/ranges'
+require 'mutant/variable'
+require 'mutant/warnings'
 require 'mutant/zombifier'
+require 'mutant/range'
+require 'mutant/license'
+require 'mutant/license/subscription'
+require 'mutant/license/subscription/opensource'
+require 'mutant/license/subscription/commercial'
 
 module Mutant
+  WORLD = World.new(
+    condition_variable: ConditionVariable,
+    gem:                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,
+    warnings:           Warnings.new(Warning)
+  )
+
   # Reopen class to initialize constant to avoid dep circle
   class Config
     DEFAULT = new(
@@ -222,23 +225,12 @@ module Mutant
       ]),
       fail_fast:         false,
       includes:          EMPTY_ARRAY,
-      integration:       Integration::Null,
-      isolation:         Mutant::Isolation::Fork.new(
-        devnull: ->(&block) { File.open(File::NULL, File::WRONLY, &block) },
-        stdout:  $stdout,
-        stderr:  $stderr,
-        io:      IO,
-        marshal: Marshal,
-        process: Process
-      ),
+      integration:       'null',
+      isolation:         Mutant::Isolation::Fork.new(WORLD),
       jobs:              Etc.nprocessors,
-      kernel:            Kernel,
-      load_path:         $LOAD_PATH,
       matcher:           Matcher::Config::DEFAULT,
-      open3:             Open3,
-      pathname:          Pathname,
+      reporter:          Reporter::CLI.build(WORLD.stdout),
       requires:          EMPTY_ARRAY,
-      reporter:          Reporter::CLI.build($stdout),
       zombie:            false
     )
   end # Config

data/lib/mutant/ast/nodes.rb

@@ -3,8 +3,6 @@
 module Mutant
   module AST
     # Singleton nodes
-    #
-    # :reek:TooManyConstants
     module Nodes
       extend Sexp
 

data/lib/mutant/ast/types.rb

@@ -3,9 +3,6 @@
 module Mutant
   module AST
     # Groups of node types
-    #
-    # :reek:TooManyConstants
-    # rubocop:disable Metrics/ModuleLength
     module Types
       ASSIGNABLE_VARIABLES = Set.new(%i[ivasgn lvasgn cvasgn gvasgn]).freeze
 
@@ -66,119 +63,6 @@ module Mutant
       #
       BLACKLIST = Set.new(%i[not]).freeze
 
-      # Nodes generated by regular expression body parsing
-      REGEXP = Set.new(%i[
-        regexp_alnum_posixclass
-        regexp_alpha_posixclass
-        regexp_alpha_property
-        regexp_alternation_escape
-        regexp_alternation_meta
-        regexp_arabic_property
-        regexp_ascii_posixclass
-        regexp_atomic_group
-        regexp_backslash_escape
-        regexp_backspace_escape
-        regexp_bell_escape
-        regexp_blank_posixclass
-        regexp_bol_anchor
-        regexp_bol_escape
-        regexp_bos_anchor
-        regexp_capture_group
-        regexp_carriage_escape
-        regexp_character_set
-        regexp_cntrl_posixclass
-        regexp_codepoint_escape
-        regexp_codepoint_list_escape
-        regexp_comment_free_space
-        regexp_comment_group
-        regexp_condition_conditional
-        regexp_control_escape
-        regexp_digit_posixclass
-        regexp_digit_type
-        regexp_dot_escape
-        regexp_dot_meta
-        regexp_eol_anchor
-        regexp_eol_escape
-        regexp_eos_anchor
-        regexp_eos_ob_eol_anchor
-        regexp_escape_escape
-        regexp_form_feed_escape
-        regexp_graph_posixclass
-        regexp_greedy_interval
-        regexp_greedy_one_or_more
-        regexp_greedy_zero_or_more
-        regexp_greedy_zero_or_one
-        regexp_group_close_escape
-        regexp_group_open_escape
-        regexp_han_property
-        regexp_hangul_property
-        regexp_hex_escape
-        regexp_hex_type
-        regexp_hiragana_property
-        regexp_intersection_set
-        regexp_interval_close_escape
-        regexp_interval_open_escape
-        regexp_katakana_property
-        regexp_letter_property
-        regexp_linebreak_type
-        regexp_literal_escape
-        regexp_literal_literal
-        regexp_lookahead_assertion
-        regexp_lookbehind_assertion
-        regexp_lower_posixclass
-        regexp_mark_keep
-        regexp_match_start_anchor
-        regexp_meta_sequence_escape
-        regexp_name_call_backref
-        regexp_named_group
-        regexp_newline_escape
-        regexp_nlookahead_assertion
-        regexp_nlookbehind_assertion
-        regexp_nondigit_type
-        regexp_nonhex_type
-        regexp_nonspace_type
-        regexp_nonword_boundary_anchor
-        regexp_nonword_type
-        regexp_number_backref
-        regexp_octal_escape
-        regexp_one_or_more_escape
-        regexp_open_conditional
-        regexp_options_group
-        regexp_options_switch_group
-        regexp_passive_group
-        regexp_possessive_interval
-        regexp_possessive_one_or_more
-        regexp_possessive_zero_or_more
-        regexp_possessive_zero_or_one
-        regexp_print_nonposixclass
-        regexp_print_nonproperty
-        regexp_print_posixclass
-        regexp_print_posixclass
-        regexp_print_property
-        regexp_punct_posixclass
-        regexp_range_set
-        regexp_reluctant_interval
-        regexp_reluctant_one_or_more
-        regexp_reluctant_zero_or_more
-        regexp_root_expression
-        regexp_sequence_expression
-        regexp_set_close_escape
-        regexp_set_open_escape
-        regexp_space_posixclass
-        regexp_space_type
-        regexp_tab_escape
-        regexp_upper_posixclass
-        regexp_vertical_tab_escape
-        regexp_whitespace_free_space
-        regexp_word_boundary_anchor
-        regexp_word_posixclass
-        regexp_word_type
-        regexp_xdigit_posixclass
-        regexp_xgrapheme_type
-        regexp_zero_or_more_escape
-        regexp_zero_or_one_escape
-      ]).freeze
-
       # Nodes that are NOT generated by parser but used by mutant / unparser.
       GENERATED = Set.new(%i[empty]).freeze
 
@@ -186,7 +70,7 @@ module Mutant
       MISSING = Set.new(%i[index indexasgn lambda procarg0]).freeze
 
       ALL = Set.new(
-        (Parser::Meta::NODE_TYPES + GENERATED + REGEXP + MISSING) - BLACKLIST
+        (Parser::Meta::NODE_TYPES + GENERATED + MISSING) - BLACKLIST
       ).freeze
     end # Types
   end # AST

data/lib/mutant/base.rb

@@ -0,0 +1,192 @@
+# frozen_string_literal: true
+
+module Mutant
+  module Functor
+    include AbstractType
+
+    abstract_method :fmap
+
+  private
+
+    # Raise error unless block is provided
+    #
+    # @raise [MissingBlockError]
+    #   if no block is given
+    #
+    # @return [self]
+    def require_block
+      fail LocalJumpError unless block_given?
+      self
+    end
+  end # Functor
+
+  class Maybe
+    include(
+      AbstractType,
+      Adamantium::Flat,
+      Functor
+    )
+
+    class Nothing < self
+      instance = new
+
+      define_method(:new) { instance }
+
+      # Evaluate functor block
+      #
+      # @return [Maybe::Nothing]
+      def fmap(&block)
+        require_block(&block)
+      end
+
+      # Evaluate applicative block
+      #
+      # @return [Maybe::Nothing]
+      def apply(&block)
+        require_block(&block)
+      end
+    end # Nothing
+
+    class Just < self
+      include Concord.new(:value)
+
+      # Evalute functor block
+      #
+      # @return [Maybe::Just<Object>]
+      def fmap
+        Just.new(yield(value))
+      end
+
+      # Evalute applicative block
+      #
+      # @return [Maybe]
+      def apply
+        yield(value)
+      end
+    end # Just
+  end # Maybe
+
+  class Either
+    include(
+      AbstractType,
+      Adamantium::Flat,
+      Concord.new(:value),
+      Functor
+    )
+
+    # Execute block and wrap error in left
+    #
+    # @param [Class:Exception] error
+    #
+    # @return [Either<Exception, Object>]
+    def self.wrap_error(error)
+      Right.new(yield)
+    rescue error => exception
+      Left.new(exception)
+    end
+
+    class Left < self
+      # Evaluate functor block
+      #
+      # @return [Either::Left<Object>]
+      def fmap(&block)
+        require_block(&block)
+      end
+
+      # Evaluate applicative block
+      #
+      # @return [Either::Left<Object>]
+      def apply(&block)
+        require_block(&block)
+      end
+
+      # Unwrap value from left
+      #
+      # @return [Object]
+      def from_left
+        value
+      end
+
+      # Unwrap value from right
+      #
+      # @return [Object]
+      #
+      # rubocop:disable Style/GuardClause
+      def from_right
+        if block_given?
+          yield(value)
+        else
+          fail "Expected right value, got #{inspect}"
+        end
+      end
+      # rubocop:enable Style/GuardClause
+
+      # Map over left value
+      #
+      # @return [Either::Right<Object>]
+      def lmap
+        Left.new(yield(value))
+      end
+
+      # Evaluate left side of branch
+      #
+      # @param [#call] left
+      # @param [#call] _right
+      def either(left, _right)
+        left.call(value)
+      end
+    end # Left
+
+    class Right < self
+      # Evaluate functor block
+      #
+      # @return [Either::Right<Object>]
+      def fmap
+        Right.new(yield(value))
+      end
+
+      # Evaluate applicative block
+      #
+      # @return [Either<Object>]
+      def apply
+        yield(value)
+      end
+
+      # Unwrap value from left
+      #
+      # @return [Object]
+      #
+      # rubocop:disable Style/GuardClause
+      def from_left
+        if block_given?
+          yield(value)
+        else
+          fail "Expected left value, got #{inspect}"
+        end
+      end
+      # rubocop:enable Style/GuardClause
+
+      # Unwrap value from right
+      #
+      # @return [Object]
+      def from_right
+        value
+      end
+
+      # Map over left value
+      #
+      # @return [Either::Right<Object>]
+      def lmap(&block)
+        require_block(&block)
+      end
+
+      # Evaluate right side of branch
+      #
+      # @param [#call] _left
+      # @param [#call] right
+      def either(_left, right)
+        right.call(value)
+      end
+    end # Right
+  end # Either
+end # Mutant