mutest 0.0.6 → 0.0.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 97bf6ecfd043bbfd31dd3e8e2e5263261f0362f8
-  data.tar.gz: 20eb837b1320b00cbaf394420b9cdb507fd8c06e
+  metadata.gz: accfe303b872672222caff0f1e8d6cf233120f48
+  data.tar.gz: a176ed5591646234e393215b9b2619c7bcc80661
 SHA512:
-  metadata.gz: dbaf4594dfd3e4f6a5ed819475e0932794930084c46dab08e04471d1d88e0bcd3980a6ac1555c78d52455f34ac24cfd96961c4713d149380b3d1dab45a2ce79d
-  data.tar.gz: 539337ea6d7cc082aeb3e9ee19e86afc9a26a6f2885e900d40ed3d0919800a071f16297ef8005d0374e4fce78156db060eaf5d4ee9606f9619e0c3ac83238724
+  metadata.gz: 229ddfaa29a990aeff3ad104a02fbcad1bad7bde6e52dfb66839bd65bc77d412349edc3158eaeb20b2f14aa186e61247045d417273cf4d674014d94078884469
+  data.tar.gz: 34f0cb733d977de967f79d106f2aa1ea19cca7d6038ace1ab5d23501331c0d1a2e00935ef825c2e7f759e2cecb0822d86697cd30ba4e361191e3a68ba60c4c72

data/.buildkite/hooks/pre-command

@@ -1,3 +1,3 @@
 #!/bin/bash
 
-docker pull backus/mutest
+docker pull backus/ruby-matrix

data/.buildkite/pipeline.yml

@@ -1,51 +1,38 @@
 steps:
-  - command: "build/run 2.3.1 'rake metrics:coverage'"
+  - command: "build/run 2.3.3 'rspec spec/unit'"
     label: ":rspec: RSpec"
     agents:
       - queue=elastic
+    env:
+      COVERAGE: 'true'
 
   - name: ':rspec: Corpus tests (rubyspec)'
-    command: build/run 2.3.1 'rspec --tag corpus:rubyspec'
+    command: build/run 2.3.3 'rspec --tag corpus:rubyspec'
     agents:
       - queue=elastic
 
   - name: ':rspec: Corpus tests (regexp_parser)'
-    command: build/run 2.3.1 'rspec --tag corpus:regexp_parser'
+    command: build/run 2.3.3 'rspec --tag corpus:regexp_parser'
     agents:
       - queue=elastic
 
   - name: ':rspec: Corpus tests (axiom)'
-    command: build/run 2.3.1 'rspec --tag corpus:axiom'
+    command: build/run 2.3.3 'rspec --tag corpus:axiom'
     agents:
       - queue=elastic
 
   - name: ':rspec: Integration tests'
-    command: build/run 2.3.1 'rspec --exclude-pattern "**/corpus_spec.rb" --format documentation spec/integration'
+    command: build/run 2.3.3 'rspec --exclude-pattern "**/corpus_spec.rb" --format documentation spec/integration'
     agents:
       - queue=elastic
 
   - name: ':skull: Mutest'
-    command: build/run 2.3.1 'rake metrics:mutant'
+    command: build/run 2.3.3 'rake metrics:mutest'
     timeout_in_minutes: 10
     agents:
       - queue=elastic
 
   - name: ':rubocop: Rubocop'
-    command: build/run 2.3.1 'rake metrics:rubocop'
-    agents:
-      - queue=elastic
-
-  - name: ':japanese_ogre: Flay'
-    command: build/run 2.3.1 'rake metrics:flay'
-    agents:
-      - queue=elastic
-
-  - name: ':imp: Flog'
-    command: build/run 2.3.1 'rake metrics:flog'
-    agents:
-      - queue=elastic
-
-  - name: ':hankey: Reek'
-    command: build/run 2.3.1 'rake metrics:reek'
+    command: build/run 2.3.3 'rubocop --config config/rubocop.yml'
     agents:
       - queue=elastic

data/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "build"]
+	path = build
+	url = https://github.com/backus/buildkite-ruby-matrix.git

data/CHANGELOG.md

@@ -6,6 +6,18 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
 ## [Master (Unreleased)]
 
+## [0.0.7] - 2017-06-18
+
+### Added
+
+- String literal mutations (`'foo'` -> `'foo__mutest__'`) [[#58](https://github.com/backus/mutest/pull/58/files) ([@dgollahon][])]
+- Selector mutations for `[public_]method` methods (`foo.method(:to_s)` -> `foo.method(:to_str)`) [[#56](https://github.com/backus/mutest/pull/56/files) ([@dgollahon][])]
+- Block-pass symbol#to_proc mutations (`foo(&:to_s)` -> `foo(&:to_str)`) [[#55](https://github.com/backus/mutest/pull/55/files) ([@dgollahon][])]
+- Block-pass mutations (`foo(&method(:bar))` -> `foo(&public_method(:bar))`) [[#54](https://github.com/backus/mutest/pull/54/files) ([@dgollahon][])]
+
+### Removed
+- Boolean to `nil` mutations (`true` -> `nil`; `false` -> `nil`) [[#42](https://github.com/backus/mutest/pull/42/files) ([@dgollahon][])]
+
 ## [0.0.6] - 2017-03-04
 
 ### Fixed
@@ -55,7 +67,8 @@ First proper RubyGems release
 
 <!-- Version diffs -->
 
-[Master (Unreleased)]: https://github.com/backus/mutest/compare/v0.0.6...HEAD
+[Master (Unreleased)]: https://github.com/backus/mutest/compare/v0.0.7...HEAD
+[0.0.7]: https://github.com/backus/mutest/compare/v0.0.6...v0.0.7
 [0.0.6]: https://github.com/backus/mutest/compare/v0.0.5...v0.0.6
 [0.0.5]: https://github.com/backus/mutest/compare/v0.0.4...v0.0.5
 [0.0.4]: https://github.com/backus/mutest/compare/v0.0.3...v0.0.4

data/Gemfile

@@ -4,10 +4,15 @@ gemspec name: 'mutest'
 
 eval_gemfile File.expand_path('../Gemfile.shared', __FILE__)
 
-gem 'mutant', git: 'https://github.com/mbj/mutant.git'
+gem 'pry',              '~> 0.10'
+gem 'pry-byebug',       '~> 3.4'
+gem 'rake',             '~> 12'
+gem 'rspec',            '~> 3.6'
+gem 'rspec-its',        '~> 1.2.0'
+gem 'rubocop',          '~> 0.47.1'
+gem 'rubocop-devtools', git: 'https://github.com/backus/rubocop-devtools.git'
+gem 'rubocop-rspec',    '~> 1.10.0'
+gem 'simplecov',        '~> 0.13.0'
 
-group :development do
-  gem 'pry',        '~> 0.10'
-  gem 'pry-byebug', '~> 3.4'
-  gem 'rubocop-devtools', git: 'https://github.com/backus/rubocop-devtools.git'
-end
+# Lock to 1.10 in tests until https://git.io/vHjug is released
+gem 'parallel', '= 1.10.0'

data/Gemfile.lock

@@ -8,34 +8,10 @@ GIT
       concord (~> 0.1.5)
       ice_nine (~> 0.11.1)
 
-GIT
-  remote: https://github.com/mbj/mutant.git
-  revision: 24f6d42fa2b3d30fbf206169d08383972c803242
-  specs:
-    mutant (0.8.12)
-      abstract_type (~> 0.0.7)
-      adamantium (~> 0.2.0)
-      anima (~> 0.3.0)
-      ast (~> 2.2)
-      concord (~> 0.1.5)
-      diff-lcs (~> 1.2)
-      equalizer (~> 0.0.9)
-      ice_nine (~> 0.11.1)
-      memoizable (~> 0.4.2)
-      morpher (~> 0.2.6)
-      parallel (~> 1.3)
-      parser (~> 2.3.1, >= 2.3.1.4)
-      procto (~> 0.0.2)
-      regexp_parser (~> 0.4.1)
-      unparser (~> 0.2.5)
-    mutant-rspec (0.8.12)
-      mutant (~> 0.8.12)
-      rspec-core (>= 3.4.0, < 3.6.0)
-
 PATH
   remote: .
   specs:
-    mutest (0.0.3)
+    mutest (0.0.7)
       abstract_type (~> 0.0.7)
       adamantium (~> 0.2.0)
       anima (~> 0.3.0)
@@ -64,54 +40,16 @@ GEM
       adamantium (~> 0.2)
       equalizer (~> 0.0.11)
     ast (2.3.0)
-    axiom-types (0.1.1)
-      descendants_tracker (~> 0.0.4)
-      ice_nine (~> 0.11.0)
-      thread_safe (~> 0.3, >= 0.3.1)
     byebug (9.0.6)
-    codeclimate-engine-rb (0.4.0)
-      virtus (~> 1.0)
     coderay (1.1.1)
-    coercible (1.0.0)
-      descendants_tracker (~> 0.0.1)
     concord (0.1.5)
       adamantium (~> 0.2.0)
       equalizer (~> 0.0.9)
-    descendants_tracker (0.0.4)
-      thread_safe (~> 0.3, >= 0.3.1)
-    devtools (0.1.16)
-      adamantium (~> 0.2.0)
-      anima (~> 0.3.0)
-      concord (~> 0.1.5)
-      flay (~> 2.8.1)
-      flog (~> 4.4.0)
-      mutant (~> 0.8.11)
-      mutant-rspec (~> 0.8.11)
-      procto (~> 0.0.3)
-      rake (~> 11.3.0)
-      reek (~> 4.5.0)
-      rspec (~> 3.5.0)
-      rspec-core (~> 3.5.4)
-      rspec-its (~> 1.2.0)
-      rubocop (~> 0.47.0)
-      simplecov (~> 0.12.0)
-      yard (~> 0.9.1)
-      yardstick (~> 0.9.9)
     diff-lcs (1.2.5)
     docile (1.1.5)
     equalizer (0.0.11)
-    erubis (2.7.0)
-    flay (2.8.1)
-      erubis (~> 2.7.0)
-      path_expander (~> 1.0)
-      ruby_parser (~> 3.0)
-      sexp_processor (~> 4.0)
-    flog (4.4.1)
-      path_expander (~> 1.0)
-      ruby_parser (~> 3.1, > 3.1.0)
-      sexp_processor (~> 4.4)
     ice_nine (0.11.2)
-    json (2.0.3)
+    json (2.1.0)
     memoizable (0.4.2)
       thread_safe (~> 0.3, >= 0.3.1)
     method_source (0.8.2)
@@ -127,7 +65,6 @@ GEM
     parallel (1.10.0)
     parser (2.3.3.1)
       ast (~> 2.2)
-    path_expander (1.0.1)
     powerpack (0.1.1)
     procto (0.0.3)
     pry (0.10.4)
@@ -137,29 +74,26 @@ GEM
     pry-byebug (3.4.2)
       byebug (~> 9.0)
       pry (~> 0.10)
-    rainbow (2.2.1)
-    rake (11.3.0)
-    reek (4.5.4)
-      codeclimate-engine-rb (~> 0.4.0)
-      parser (~> 2.3.1, >= 2.3.1.2)
-      rainbow (~> 2.0)
-    regexp_parser (0.4.2)
-    rspec (3.5.0)
-      rspec-core (~> 3.5.0)
-      rspec-expectations (~> 3.5.0)
-      rspec-mocks (~> 3.5.0)
-    rspec-core (3.5.4)
-      rspec-support (~> 3.5.0)
-    rspec-expectations (3.5.0)
+    rainbow (2.2.2)
+      rake
+    rake (12.0.0)
+    regexp_parser (0.4.3)
+    rspec (3.6.0)
+      rspec-core (~> 3.6.0)
+      rspec-expectations (~> 3.6.0)
+      rspec-mocks (~> 3.6.0)
+    rspec-core (3.6.0)
+      rspec-support (~> 3.6.0)
+    rspec-expectations (3.6.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.5.0)
+      rspec-support (~> 3.6.0)
     rspec-its (1.2.0)
       rspec-core (>= 3.0.0)
       rspec-expectations (>= 3.0.0)
-    rspec-mocks (3.5.0)
+    rspec-mocks (3.6.0)
       diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.5.0)
-    rspec-support (3.5.0)
+      rspec-support (~> 3.6.0)
+    rspec-support (3.6.0)
     rubocop (0.47.1)
       parser (>= 2.3.3.1, < 3.0)
       powerpack (~> 0.1)
@@ -169,17 +103,14 @@ GEM
     rubocop-rspec (1.10.0)
       rubocop (>= 0.42.0)
     ruby-progressbar (1.8.1)
-    ruby_parser (3.8.4)
-      sexp_processor (~> 4.1)
-    sexp_processor (4.7.0)
-    simplecov (0.12.0)
+    simplecov (0.13.0)
       docile (~> 1.1.0)
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
-    simplecov-html (0.10.0)
+    simplecov-html (0.10.1)
     slop (3.6.0)
     thread_safe (0.3.5)
-    unicode-display_width (1.1.3)
+    unicode-display_width (1.2.1)
     unparser (0.2.5)
       abstract_type (~> 0.0.7)
       adamantium (~> 0.2.0)
@@ -188,27 +119,22 @@ GEM
       equalizer (~> 0.0.9)
       parser (~> 2.3.0)
       procto (~> 0.0.2)
-    virtus (1.0.5)
-      axiom-types (~> 0.1)
-      coercible (~> 1.0)
-      descendants_tracker (~> 0.0, >= 0.0.3)
-      equalizer (~> 0.0, >= 0.0.9)
-    yard (0.9.8)
-    yardstick (0.9.9)
-      yard (~> 0.8, >= 0.8.7.2)
 
 PLATFORMS
   ruby
 
 DEPENDENCIES
-  bundler (~> 1.10)
-  devtools (~> 0.1.16)
-  mutant!
   mutest!
+  parallel (= 1.10.0)
   pry (~> 0.10)
   pry-byebug (~> 3.4)
+  rake (~> 12)
+  rspec (~> 3.6)
+  rspec-its (~> 1.2.0)
+  rubocop (~> 0.47.1)
   rubocop-devtools!
   rubocop-rspec (~> 1.10.0)
+  simplecov (~> 0.13.0)
 
 BUNDLED WITH
-   1.14.3
+   1.15.1

data/README.md

@@ -1,7 +1,47 @@
 mutest
 ======
+[![Build status](https://badge.buildkite.com/8b58446082c5724c4e37e7fa4a4e0d5ee04b936b95a744c3cf.svg?branch=master&style=flat-square)](https://buildkite.com/rubocop-rspec/mutest)
 
-This is a fork of a popular open source mutation testing tool for Ruby. Not ready for prime time!
+`mutest` is a mutation testing tool for ruby designed to help audit the thoroughness of your test suite and encourage you to write more robust code.
+
+## How it works
+
+`mutest` parses your ruby code, inserts modifications, and then runs your test suite. If your test suite still _passes_ after `mutest` has mutated your code, you have an _alive_ mutation--meaning your tests do not thoroughly cover the modified part of your code. If your tests _fail_ after the code has been modified, the mutation is _killed_. This means that your test suite was able to detect the semantic change and provide adequate coverage of that condition.
+
+For full examples and a more detailed explanation of the technique, check out this [blog post](https://blog.blockscore.com/how-to-write-better-code-using-mutation-testing/).
+
+## Installation
+
+`mutest` is currently only compatible with `rspec`. To install the `rspec` integration, run:
+
+```shell
+$ gem install mutest-rspec
+```
+
+or add
+
+```ruby
+gem 'mutest-rspec'
+```
+
+to your Gemfile.
+
+## Usage
+
+###### Run `mutest` on the entire MyProject namespace
+`mutest --include lib --require my_project --use rspec 'MyProject*'`
+
+###### Run `mutest` on a specific class
+`mutest --include lib --require my_project --use rspec 'MyProject::Foo'`
+
+###### Run `mutest` on a specific class method
+`mutest --include lib --require my_project --use rspec 'MyProject::Foo.bar'`
+
+###### Run `mutest` on a specific instance method
+`mutest --include lib --require my_project --use rspec 'MyProject::Foo#bar'`
+
+###### Run `mutest` on only the changes inside the MyProject namespace since a git revision
+`mutest --include lib --require my_project --use rspec --since HEAD~1 'MyProject*'`
 
 ## Changes
 
@@ -9,4 +49,4 @@ For updates to the project, check out the [CHANGELOG](CHANGELOG.md)!
 
 ## Credit
 
-* Markus Schirp did an amazing job on [mutant](mbj/mutant) which this fork is based on.
+* Markus Schirp did an amazing job on [mutant](https://github.com/mbj/mutant) which this fork is based on.

data/Rakefile

@@ -1,12 +1,6 @@
-require 'devtools'
-
-Devtools.init_rake_tasks
-
-Rake.application.load_imports
-
-task('metrics:mutant').clear
+desc 'Run mutest on itself'
 namespace :metrics do
-  task mutant: :coverage do
+  task :mutest do
     arguments = %w[
       bundle exec mutest
       --include lib

data/circle.yml

@@ -4,4 +4,7 @@ machine:
     version: '2.3.3'
 test:
   override:
-    - bundle exec rake ci
+    - bundle exec rubocop --config config/rubocop.yml
+    - COVERAGE=true bundle exec rspec spec/unit
+    - bundle exec rspec spec/integration
+    - bundle exec rake metrics:mutest

data/lib/mutest.rb

@@ -123,7 +123,7 @@ require 'mutest/mutator/node/named_value/constant_assignment'
 require 'mutest/mutator/node/named_value/variable_assignment'
 require 'mutest/mutator/node/next'
 require 'mutest/mutator/node/break'
-require 'mutest/mutator/node/noop'
+require 'mutest/mutator/node/block_pass'
 require 'mutest/mutator/node/or_asgn'
 require 'mutest/mutator/node/and_asgn'
 require 'mutest/mutator/node/defined'

data/lib/mutest/ast/meta/send.rb

@@ -12,6 +12,7 @@ module Mutest
 
         INDEX_ASSIGNMENT_SELECTOR            = :[]=
         ATTRIBUTE_ASSIGNMENT_SELECTOR_SUFFIX = '='.freeze
+        METHOD_METHOD_SELECTORS              = %i[method public_method].freeze
 
         # Arguments of mutated node
         #
@@ -65,6 +66,11 @@ module Mutest
           Const.new(receiver).possible_top_level?
         end
 
+        # Test if this is a selector that returns a method object
+        def method_object_selector?
+          METHOD_METHOD_SELECTORS.include?(selector)
+        end
+
         private
 
         # Test if node is `proc { ... }`

data/lib/mutest/ast/named_children.rb

@@ -20,7 +20,7 @@ module Mutest
 
         # Mutated nodes children
         #
-        # @return [Array<Parser::AST::Node]
+        # @return [Array<Parser::AST::Node>]
         def children
           node.children
         end