mutant 0.9.4 → 0.9.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5194ccc2d7c83d425c53dc7339242277010dcac6715248380417f936d88f7eda
-  data.tar.gz: ba35d0efea5be46b335947acd7452d72df6917deba2e6ccad96d8e0b60bdb2e4
+  metadata.gz: e6e6e125d0e2736934ed481945e35eada9a1b8fffaf05641a5410a2ed25b9b20
+  data.tar.gz: 13e2b48cbc500aab1ef792ccbaff86de593337f7213bdcf7d0d81afa21e7a641
 SHA512:
-  metadata.gz: a63b99d244b957e3b3664243ed8a37704b2bdc596be0020de7f5665351958d941ec1be81584af798f7c0b63011d5cd689b4d3b77686469d869670592bffdecf4
-  data.tar.gz: 76c702695a6e04f874a73952fb153065bb0f76ebd098b50b6bb6e7b670568ca842aa78b70c71abb8728248eacf0e28ef123c02eab4c443d4a896fe3939ff453b
+  metadata.gz: 7a3bfbaffad39ee2bc7cf41a07c19031704c26c7d05ba9b3f07d59d3b82965311c0822aec10ab359570fc8c3d3235f36d461fbe39cddb6349997b2b8bd0fa5d3
+  data.tar.gz: a1caa7e5f3318001137239c613ddd50bdeabe981fa132f4e9e5a383019a24a53075da121b290e98dcb61c93a1900f79f8e1207ce7ac282d049b2af0351b26e64

data/.github/workflows/ci.yml

@@ -0,0 +1,121 @@
+name: CI
+
+on: push
+
+jobs:
+  base:
+    name: Base steps
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Check Whitespace
+      run: git diff --check -- HEAD~1
+  ruby-spec:
+    name: Unit Specs
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 5
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['2.6', '2.7']
+        os: [ubuntu-latest]
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - run: |
+        gem install bundler
+        bundle install
+    - run: bundle exec rspec spec/unit
+  ruby-mutant:
+    name: Mutation coverage
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 30
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['2.6', '2.7']
+        os: [ubuntu-latest]
+    steps:
+    - uses: actions/checkout@v2
+      with:
+        fetch-depth: 0
+    - uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - run: |
+        gem install bundler
+        bundle install
+    - run: ./mutant.sh
+  ruby-integration-minitest:
+    name: Integration Minitest
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 5
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['2.6', '2.7']
+        os: [ubuntu-latest]
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - run: gem list
+    - run: |
+        gem install bundler
+        bundle install
+    - run: bundle exec rspec spec/integration -e minitest
+  ruby-integration-rspec:
+    name: Integration RSpec
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 10
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['2.6', '2.7']
+        os: [ubuntu-latest]
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - run: |
+        gem install bundler
+        bundle install
+    - run: bundle exec rspec spec/integration -e rspec
+  ruby-integration-generation:
+    name: Integration Mutation Generation
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 5
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['2.6', '2.7']
+        os: [ubuntu-latest]
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - run: |
+        gem install bundler
+        bundle install
+    - run: bundle exec rspec spec/integration -e generation
+  ruby-rubocop:
+    name: Rubocop
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 5
+    strategy:
+      fail-fast: false
+      matrix:
+        ruby: ['2.7']
+        os: [ubuntu-latest]
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.ruby }}
+    - run: bundle install
+    - run: bundle exec rake metrics:rubocop

data/Changelog.md

@@ -1,3 +1,29 @@
+# v0.9.9 2020-09-25
+
++ Add support for mutating methods inside eigenclasses `class <<`. [#1009](https://github.com/mbj/mutant/pull/1009)
+- Remove `<` -> `<=` and `>` -> `>=` mutations as non canonical. [#1020](https://github.com/mbj/mutant/pull/1020)
+- Remove `true` -> `nil` and `false` -> `nil` mutations as non canonical. [#1018](https://github.com/mbj/mutant/pull/1018)
+
+# v0.9.8 2020-08-02
+
+* Change to generic catch all node mutator. This allows better cross parser version compatibility.
+
+# v0.9.7 2020-07-22
+
+* Bump parser dependency to 2.7.1, note this still does not support Ruby 2.7 syntax.
+  But it supports running bundling with that parser version.
+* Nail diff-lcs to 1.3 till output difference for 1.4 can be addressed.
+
+# v0.9.6 2020-04-20
+
+* Dependencies upgrade, should not change user facing semantics.
+* Bump license nudge to 40s
+
+# v0.9.5 2020-02-02
+
+* Change to 2.7 parser series.
+  This does not drop support for < 2.7 but enables to in the future add full Ruby 2.7 support.
+
 # v0.9.4 2020-01-03
 
 * Bump unparser dependency

data/Gemfile

@@ -5,18 +5,3 @@ source 'https://rubygems.org'
 gemspec name: 'mutant'
 
 eval_gemfile File.expand_path('Gemfile.shared', __dir__)
-
-gem 'unparser', git: 'https://github.com/mbj/unparser.git'
-
-gem(
-  'devtools',
-  git: 'https://github.com/mbj/devtools.git',
-  ref: '26ba0a1053e6cf7b79fc72d513a73457f9a38ead'
-)
-
-# Mutant itself uses an opensource license key.
-# Scoped to https://github.com/mbj/mutant it'll
-# not be useful elsewhere.
-source 'https://oss:Px2ENN7S91OmWaD5G7MIQJi1dmtmYrEh@gem.mutant.dev' do
-  gem 'mutant-license'
-end

data/Gemfile.lock

@@ -1,56 +1,21 @@
-GIT
-  remote: https://github.com/mbj/devtools.git
-  revision: 26ba0a1053e6cf7b79fc72d513a73457f9a38ead
-  ref: 26ba0a1053e6cf7b79fc72d513a73457f9a38ead
-  specs:
-    devtools (0.1.23)
-      abstract_type (~> 0.0.7)
-      adamantium (~> 0.2.0)
-      anima (~> 0.3.0)
-      concord (~> 0.1.5)
-      flay (~> 2.12.0)
-      flog (~> 4.6.2)
-      procto (~> 0.0.3)
-      rake (~> 12.3.0)
-      reek (~> 5.3.0)
-      rspec (~> 3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-its (~> 1.2.0)
-      rubocop (~> 0.61.1)
-      simplecov (~> 0.16.1)
-      yard (~> 0.9.16)
-      yardstick (~> 0.9.9)
-
-GIT
-  remote: https://github.com/mbj/unparser.git
-  revision: 157a5b3b43e9f1d540da74b1751dc2b6f7601c3b
-  specs:
-    unparser (0.4.6)
-      abstract_type (~> 0.0.7)
-      adamantium (~> 0.2.0)
-      concord (~> 0.1.5)
-      diff-lcs (~> 1.3)
-      equalizer (~> 0.0.9)
-      parser (~> 2.6.5)
-      procto (~> 0.0.2)
-
 PATH
   remote: .
   specs:
-    mutant (0.9.4)
+    mutant (0.9.8)
       abstract_type (~> 0.0.7)
       adamantium (~> 0.2.0)
       anima (~> 0.3.1)
       ast (~> 2.2)
       concord (~> 0.1.5)
-      diff-lcs (~> 1.3)
+      diff-lcs (= 1.3)
       equalizer (~> 0.0.9)
       ice_nine (~> 0.11.1)
       memoizable (~> 0.4.2)
       mprelude (~> 0.1.0)
-      parser (~> 2.6.5)
+      parser (~> 2.7.1)
       procto (~> 0.0.2)
       unparser (~> 0.4.6)
+      variable (~> 0.0.1)
 
 GEM
   remote: https://rubygems.org/
@@ -64,7 +29,7 @@ GEM
       abstract_type (~> 0.0.7)
       adamantium (~> 0.2)
       equalizer (~> 0.0.11)
-    ast (2.4.0)
+    ast (2.4.1)
     axiom-types (0.1.1)
       descendants_tracker (~> 0.0.4)
       ice_nine (~> 0.11.0)
@@ -78,6 +43,23 @@ GEM
       equalizer (~> 0.0.9)
     descendants_tracker (0.0.4)
       thread_safe (~> 0.3, >= 0.3.1)
+    devtools (0.1.26)
+      abstract_type (~> 0.0.7)
+      adamantium (~> 0.2.0)
+      anima (~> 0.3.0)
+      concord (~> 0.1.5)
+      flay (~> 2.12.0)
+      flog (~> 4.6.2)
+      procto (~> 0.0.3)
+      rake (~> 12.3.0)
+      reek (~> 5.6.0)
+      rspec (~> 3.8.0)
+      rspec-core (~> 3.8.0)
+      rspec-its (~> 1.2.0)
+      rubocop (~> 0.79.0)
+      simplecov (~> 0.16.1)
+      yard (~> 0.9.16)
+      yardstick (~> 0.9.9)
     diff-lcs (1.3)
     docile (1.3.2)
     equalizer (0.0.11)
@@ -93,7 +75,7 @@ GEM
       sexp_processor (~> 4.8)
     ice_nine (0.11.2)
     jaro_winkler (1.5.4)
-    json (2.3.0)
+    json (2.3.1)
     kwalify (0.7.2)
     memoizable (0.4.2)
       thread_safe (~> 0.3, >= 0.3.1)
@@ -105,19 +87,18 @@ GEM
       ice_nine (~> 0.11.1)
       procto (~> 0.0.2)
     mutant-license (0.1.0)
-    parallel (1.19.1)
-    parser (2.6.5.0)
-      ast (~> 2.4.0)
+    parallel (1.19.2)
+    parser (2.7.1.4)
+      ast (~> 2.4.1)
     path_expander (1.1.0)
-    powerpack (0.1.2)
     procto (0.0.3)
     psych (3.1.0)
     rainbow (3.0.0)
     rake (12.3.3)
-    reek (5.3.2)
+    reek (5.6.0)
       codeclimate-engine-rb (~> 0.4.0)
       kwalify (~> 0.7.0)
-      parser (>= 2.5.0.0, < 2.7, != 2.5.1.1)
+      parser (>= 2.5.0.0, < 2.8, != 2.5.1.1)
       psych (~> 3.1.0)
       rainbow (>= 2.0, < 4.0)
     rspec (3.8.0)
@@ -136,31 +117,40 @@ GEM
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.8.0)
     rspec-support (3.8.3)
-    rubocop (0.61.1)
+    rubocop (0.79.0)
       jaro_winkler (~> 1.5.1)
       parallel (~> 1.10)
-      parser (>= 2.5, != 2.5.1.1)
-      powerpack (~> 0.1)
+      parser (>= 2.7.0.1)
       rainbow (>= 2.2.2, < 4.0)
       ruby-progressbar (~> 1.7)
-      unicode-display_width (~> 1.4.0)
+      unicode-display_width (>= 1.4.0, < 1.7)
     ruby-progressbar (1.10.1)
-    ruby_parser (3.14.1)
+    ruby_parser (3.14.2)
       sexp_processor (~> 4.9)
-    sexp_processor (4.13.0)
+    sexp_processor (4.15.0)
     simplecov (0.16.1)
       docile (~> 1.1)
       json (>= 1.8, < 3)
       simplecov-html (~> 0.10.0)
     simplecov-html (0.10.2)
     thread_safe (0.3.6)
-    unicode-display_width (1.4.1)
+    unicode-display_width (1.6.1)
+    unparser (0.4.7)
+      abstract_type (~> 0.0.7)
+      adamantium (~> 0.2.0)
+      concord (~> 0.1.5)
+      diff-lcs (~> 1.3)
+      equalizer (~> 0.0.9)
+      parser (>= 2.6.5)
+      procto (~> 0.0.2)
+    variable (0.0.1)
+      equalizer (~> 0.0.11)
     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.22)
+    yard (0.9.25)
     yardstick (0.9.9)
       yard (~> 0.8, >= 0.8.7.2)
 
@@ -168,11 +158,10 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  devtools!
+  devtools (~> 0.1.25)
   mutant!
   mutant-license!
   parallel (~> 1.3)
-  unparser!
 
 BUNDLED WITH
-   1.17.3
+   2.1.2

data/Gemfile.shared

@@ -1,3 +1,10 @@
+# Mutant itself uses an opensource license key.
+# Scoped to https://github.com/mbj/mutant it'll
+# not be useful elsewhere.
+source 'https://oss:Px2ENN7S91OmWaD5G7MIQJi1dmtmYrEh@gem.mutant.dev' do
+  gem 'mutant-license'
+end
+
 # Place for shared git sources, used for developing updates to depedencies 
 # where the git sources (without this file) need to be consistently edited 
 # into multiple Gemfiles.

data/LICENSE

@@ -116,7 +116,7 @@ the net income of Schirp DSO LTD).
 
 6. Support, Maintenance and Services. Subject to the terms and conditions of
 this Agreement, as set forth in your invoice, and as set forth on the Mutant
-support page (https://github.com/mbj/mutant/wiki/Commercial-Support),
+support page (https://github.com/mbj/mutant/blob/master/docs/commercial-support.md)
 support and maintenance services may be included with the purchase of your
 license subscription.
 

data/README.md

@@ -1,40 +1,59 @@
 mutant
 ======
 
-[![Build Status](https://circleci.com/gh/mbj/mutant.svg?style=shield&circle-token=1afd77e8f0f9d0a11fd8f15f5d7b10270f4665e2)](https://circleci.com/gh/mbj/mutant/tree/master)
+![Build Status](https://github.com/mbj/mutant/workflows/CI/badge.svg)
 [![Gem Version](https://img.shields.io/gem/v/mutant.svg)](https://rubygems.org/gems/mutant)
 [![Slack Status](https://mutation-testing-slack.herokuapp.com/badge.svg)](https://mutation-testing.slack.com/messages/mutant)
 
 ## What is Mutant?
 
-Mutant is a mutation testing tool for Ruby. Mutation testing is a technique to verify semantic coverage of your code.
+An automated code review tool, with a side effect of producing semantic code coverage
+metrics.
 
-## Why do I want it?
+Think of mutant as an expert developer that simplifies your code while making sure that all tests pass.
 
-Mutant adds to your toolbox: Detection of uncovered semantics in your code.
-Coverage becomes a meaningful metric!
+That developer never has a bad day and is always ready to jump on your PR.
 
-On each detection of uncovered semantics you have the opportunity to:
+Each reported simplification signifies either:
 
-* Delete dead code, as you do not want the extra semantics not specified by the tests
-* Add (or improve a test) to cover the unwanted semantics.
-* Learn something new about the semantics of Ruby and your direct and indirect dependencies.
+A) A piece of code that does more than the tests ask for.
+   You can probably use the simplified version of the code. OR:
 
-## How Do I use it?
+B) If you have a reason to not take the simplified version as it violates a requirement:
+   There was no test that proves the extra requirement. Likely you are missing an
+   important test for that requirement.
 
-* Start with reading the [nomenclature](/docs/nomenclature.md) documentation.
+On extensive mutant use A) happens more often than B), which leads to overall less code enter
+your repository at higher confidence for both the author and the reviewer.
+
+BTW: Mutant is a mutation testing tool, which is a form of code coverage.
+But each reported uncovered mutation is actually a call to action, just like a flag in a code review
+would be.
+
+## Getting started:
+
+* Start with reading the [nomenclature](/docs/nomenclature.md). No way around that one, sorry.
 * Then select and setup your [integration](/docs/nomenclature.md#integration), also make sure
   you can reproduce the examples in the integration specific documentation.
-* Identify your preferred mutation testing strategy. It is recommended to start at the commit level,
-  to test only the code you had been touching. See the [incremental](#only-mutating-changed-code)
-  mutation testing documentation.
+* Use mutant during code reviews and on CI in [incremental](/docs/incremental.md) mode.
+* Do not merge code with new alive mutations. If you really must bypass:
+  Add the subjects with open problems to the ignored subjects.
+
+## Ruby Versions
+
+Mutant currently only works on cRuby/MRI. Starting with version 2.5.x. It supports all syntax features up to and
+including Ruby 2.6.
+
+Support for 2.7 syntax features is pending, see unparser issue: https://github.com/mbj/unparser/issues/129.
+
+Mutant will work under Ruby 2.7 just fine, unless a 2.7 syntax feature is used. This will be resolved shortly.
 
 ## Licensing
 
 Mutant was recently transitioned commercial software, with a free usage plan for opensource projects.
 
 Commercial projects have to acquire a license per developer, with unlimited repositories
-per developer.
+per developer. CI usage for licensed developers is included.
 
 Opensource projects have to acquire their free license per repository.
 
@@ -56,22 +75,52 @@ The mutant license gem contains metadata that allows mutant to verify licensed u
 For commercial licenses mutant checks the git commit author or the configured git email
 to be in the set of licensed developers.
 
-For opensource licenses mutant checks the git remotes against the license whitelist.
+For opensource licenses mutant checks the git remotes against the licensed git repositories.
 This allows the project maintainer to sign up and not bother collaborators with the details.
 
-There are, apart from initial license gem installation, no remote interactions for
+There are, apart from initial license gem installation, no remote interaction for
 license validation.
 
-To inquire for license please contact [Markus Schirp](mailto:mbj@schirp-dso.com?subject=Mutant%20License).
+### Getting an Opensource license
+
+As stated above: Opensource projects of any kind are free to use mutant.
+
+Just mail [me](mailto:mbj@schirp-dso.com?subject=Mutant%20Opensource%20License): Please
+include:
+
+* Just the git remote URL of your repository. Repository can be anywhere, must not be on Github, just has to be public.
+
+I do not need any more details.
+
+### Getting a commercial license
+
+Mutant offers a per developer subscription a monthly plan for 30$, or an annual plan for 300$.
+
+Above 10 developer licensees per customer I'm open to negotiate more discounts.
+
+Should you want to procure a commercial mutant license please [mail me](mailto:mbj@schirp-dso.com?subject=Mutant%20Commercial%20License).
+
+Please include the following information:
+
+* Your invoice address, including your Tax ID (For EU customers VAT-ID is mandatory)
+* Per licensed user the git author email address as returned by `git config user.email`
+
+Also feel free to ask any other question I forgot to proactively answer here.
+
+#### Payment methods
+
+* For monthly subscriptions: Exclusively CC.
+* For annual subscriptions: CC (worldwide) or ACH (US) / SEPA (EU) wire transfer.
 
-### Pricing
+#### Pricing Why?
 
-Only relevant for commercial use.
+The idea is to charge 1$ per developer per day. Mutant reduces the time spend on code reviews.
 
-Mutant offers a subscription model under a monthly plan.
-Yearly prepayments with discounts are available.
+This time saved should be worth way more than the 1$ per day.
 
-For higher volumes different arrangements can be negotiated.
+If you think this is not true for your code base, either my claims are wrong our your use of mutant is wrong.
+I'd be happy to hear about your case as I'm certainly willing to help you in using mutant right, and in case
+I'm wrong I'd be happy to improve mutant to the point I'm right again.
 
 ## Topics