mutant 0.3.0.beta17 → 0.3.0.beta18

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 9b2d8df94331d0e76fd290e715676db4d384ef29
-  data.tar.gz: 9f41938800fd53b682f575d423b794927646f639
+  metadata.gz: 89bc8e83f49c94e59ba0950d67bced72a35bb072
+  data.tar.gz: aa8fe5e09af20fdc68063ec8647c1188bfe27fe4
 SHA512:
-  metadata.gz: 32830c2c2236599808a8def433256a5b4ce1413eb3e379332c362a32c2e7b0604d99c2fff8c0f10e5dd339ef151c2d7fb855b2c9bf2b854977f95c579343be21
-  data.tar.gz: 05c78b1df03d6f0e9ab92aec42225777b00c0a9d017f616aa32dea5e1277793bdea151c03b395d51205003c015f69ecfb1ffca02a1f263a1fba4a85cbec140a4
+  metadata.gz: ae3957cab51a09be0c87e94e5372ecb7ee67b7c73debba0e75e5003990ebe7c39ded769a402c03f3d9162deeb24cccbb4237f95d88168e6edb104936aabe216a
+  data.tar.gz: 8afc1deb30fccd538d3f4d67d14ebf6afb6895cef7a013aa582fc10a9d111f7531665c2c461e6997315dfaf225091eeb19e44376f72de757e908841990d354de

data/.rspec

@@ -1 +1,3 @@
 --color
+--format progress
+--order random

data/README.md

@@ -5,11 +5,13 @@ mutant
 [![Dependency Status](https://gemnasium.com/mbj/mutant.png)](https://gemnasium.com/mbj/mutant)
 [![Code Climate](https://codeclimate.com/github/mbj/mutant.png)](https://codeclimate.com/github/mbj/mutant)
 
-Mutant is a mutation testing tool for ruby. It aims to be better than existing mutation testers.
+Mutant is a mutation testing tool for ruby.
 
 The idea is that if code can be changed and your tests do not notice, either that code isn't being covered
 or it does not have a speced side effect.
 
+A more readable introduction can be found under: http://solnic.eu/2013/01/23/mutation-testing-with-mutant.html
+
 Mutant supports MRI and RBX 1.9 and 2.0, while support for jruby is planned. It should also work under
 any ruby engine that supports POSIX-fork(2) semantics.
 
@@ -45,9 +47,39 @@ Install the gem `mutant` via your preferred method.
 The 0.2 series is stable but has outdated dependencies. The 0.3 series is in beta phase currently.
 
 ```ruby
-gem install mutant -v0.3.0.beta8
+gem install mutant --pre
 ```
 
+Mutations
+---------
+
+Mutant supports a very wide range of mutation operators. Listing them all in detail would blow this document up.
+
+It is planned to parse a list of mutation operators from the source. In the meantime please refer to the
+[code](https://github.com/mbj/mutant/tree/master/lib/mutant/mutator/node) each subclass of `Mutant::Mutator::Node` 
+emits around 3-6 mutations.
+
+Currently mutant covers the majority of ruby's complex nodes that often occur in method bodies.
+
+A some stats from the [axiom](https://github.com/dkubb/axiom) library:
+
+```
+Subjects:  417       # Amount of subjects being mutated (currently only methods)
+Mutations: 5442      # Amount of mutations mutant generated (~13 mutations per method)
+Kills:     5385      # Amount of successfully killed mutations
+Runtime:   1898.11s  # Total runtime
+Killtime:  1884.17s  # Time spend killing mutations
+Overhead:  0.73%
+Coverage:  98.95%    # Coverage score
+Alive:     57        # Amount of alive mutations.
+```
+
+
+Nodes still missing a dedicated mutator are handled via the 
+[Generic](https://github.com/mbj/mutant/blob/master/lib/mutant/mutator/node/generic.rb) mutator.
+The goal is to remove this mutator and have dedicated mutator for every type of node and removing
+the Generic handler altogether.
+
 Examples
 --------
 

data/config/flay.yml

@@ -1,3 +1,3 @@
 ---
 threshold: 16
-total_score: 704
+total_score: 719

data/config/reek.yml

@@ -47,6 +47,7 @@ NestedIterators:
   exclude:
   - Mutant#self.singleton_subclass_instance
   - Mutant::Mutator::Util::Array::Element#dispatch
+  - Mutant::Reporter::CLI::Printer::Config::Runner#generic_stats
   - Mutant::CLI#parse
   max_allowed_nesting: 1
   ignore_iterators: []

data/lib/mutant/matcher/namespace.rb

@@ -52,24 +52,6 @@ module Mutant
         end
       end
 
-      # Test for bogus class
-      #
-      # FIXME: Remove this hack once bogus is fixed!
-      #
-      # @param [Object] object
-      #
-      # @return [true]
-      #   if is a bogous class
-      #
-      # @return [false]
-      #   otherwise
-      #
-      # @api private
-      #
-      def self.bogous?(object)
-        defined?(Bogus::Fake) && object == Bogus::Fake
-      end
-
       # Yield scope if name matches pattern
       #
       # @param [Module,Class] scope
@@ -79,11 +61,10 @@ module Mutant
       # @api private
       #
       def emit_scope(scope)
-        return if self.class.bogous?(scope)
         name = scope.name
-        # FIXME Fix nokogiri!
+        # FIXME Fix nokogiri to return a string here
         return unless name.kind_of?(String)
-        if pattern =~ scope.name
+        if pattern =~ name
           yield scope
         end
       end

data/lib/mutant/mutator/node/generic.rb

@@ -34,7 +34,7 @@ module Mutant
           end
         end
 
-      end # Noop
+      end # Generic
     end # Node
   end # Mutator
 end # Mutant

data/lib/mutant/reporter/cli/printer/config.rb

@@ -45,6 +45,7 @@ module Mutant
               info   'Overhead:  %0.2f%%', overhead
               status 'Coverage:  %0.2f%%', coverage
               status 'Alive:     %s',      amount_alive
+              print_generic_stats
               self
             end
 
@@ -60,6 +61,81 @@ module Mutant
               object.subjects
             end
 
+            # Walker for all ast nodes
+            class Walker
+
+              # Run walkter
+              #
+              # @param [Parser::AST::Node] root
+              #
+              # @return [self]
+              #
+              # @api private
+              #
+              def self.run(root, &block)
+                new(root, block)
+                self
+              end
+
+              private_class_method :new
+
+              # Initialize and run walker
+              #
+              # @param [Parser::AST::Node] root
+              # @param [#call(node)] block
+              #
+              # @return [undefined]
+              #
+              # @api private
+              #
+              def initialize(root, block)
+                @root, @block = root, block
+                dispatch(root)
+              end
+
+            private
+
+              # Perform dispatch
+              #
+              # @return [undefined]
+              #
+              # @api private
+              #
+              def dispatch(node)
+                @block.call(node)
+                node.children.grep(Parser::AST::Node).each(&method(:dispatch))
+              end
+            end
+
+            # Print generic stats
+            #
+            # @return [undefined]
+            #
+            # @api private
+            #
+            def print_generic_stats
+              stats = generic_stats.to_a.sort_by(&:last)
+              info('Nodes handled by genric mutator (type:occurances):')
+              stats.reverse_each do |type, amount|
+                info('%-10s: %d', type, amount)
+              end
+            end
+
+            # Return stats for nodes handled by generic mutator
+            #
+            # @return [Hash<Symbo, Fixnum>]
+            #
+            # @api private
+            #
+            def generic_stats
+              object.subjects.each_with_object(Hash.new(0)) do |runner, stats|
+                Walker.run(runner.subject.node) do |node|
+                  next unless Mutator::Registry.lookup(node) == Mutator::Node::Generic
+                  stats[node.type] += 1
+                end
+              end
+            end
+
             # Return amount of subjects
             #
             # @return [Fixnum]

data/lib/mutant/reporter/cli/printer/subject.rb

@@ -20,7 +20,7 @@ module Mutant
             info('%s', object.identification)
           end
 
-          # Prunter for subject runners
+          # Printer for subject runners
           class Runner < self
 
             handle(Mutant::Runner::Subject)

data/mutant.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |gem|
   gem.name        = 'mutant'
-  gem.version     = '0.3.0.beta17'
+  gem.version     = '0.3.0.beta18'
   gem.authors     = [ 'Markus Schirp' ]
   gem.email       = [ 'mbj@schirp-dso.com' ]
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: mutant
 version: !ruby/object:Gem::Version
-  version: 0.3.0.beta17
+  version: 0.3.0.beta18
 platform: ruby
 authors:
 - Markus Schirp
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-16 00:00:00.000000000 Z
+date: 2013-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parser