mutant 0.9.10 → 0.10.0

data/docs/nomenclature.md

@@ -1,82 +0,0 @@
-Nomenclature
-============
-
-The following explains several nouns you may experience in mutant's documentation.
-It's a good idea to familiarize yourself before moving on.
-
-## AST
-
-Acronym for [Abstract Syntax Tree](https://en.wikipedia.org/wiki/Abstract_syntax_tree)
-and the level of abstraction mutant operates on.
-
-## Subject
-
-An addressable piece of code to be targeted for mutation testing.
-
-Mutant currently supports the following subjects:
-
-* Instance methods
-* Singleton (class) methods
-
-Other subjects (constants, class bodies for DSLs, ...) are possible but aren't
-implemented in the OSS version.
-
-## Mutation operator
-
-A transformation applied to the AST of a subject. Mutant knows the following high level operator
-classes:
-
-* Semantic Reduction
-* Orthogonal Replacement
-* [Noop](#neutral-noop-tests)
-
-An exhaustive list can be found in the [mutant-meta](https://github.com/mbj/mutant/tree/master/meta)
-subdirectory of the source.
-
-## Mutation
-
-The result of applying a mutation operator to the AST of a subject. A mutation represents a
-hypothesis that ideally gets falsified by the tests.
-
-## Insertion
-
-The process of inserting a mutation into the runtime environment.
-Mutant currently supports insertion via dynamically created monkeypatches.
-
-Other insertion strategies (such as "boot time") are possible but aren't implemented
-in the OSS version.
-
-## Isolation
-
-The attempt to isolate the (side) effects of killing a mutation via an integration
-to prevent a mutation leaking into adjacent concurrent, or future mutations.
-
-Examples of sources for leaks are
-
-* Global variable writes
-* Thread local writes
-* DB State
-* File system
-
-Natively, mutant offers fork isolation. This works for any state within the executing
-Ruby process. For all state reachable via IO, it's the test author's responsibility to
-provide proper isolation.
-
-## Integration
-
-The method used to determine if a specific inserted mutation is covered by tests.
-
-Currently mutant supports integrations for:
-
-* [mutant-rspec](/docs/mutant-rspec.md) for [rspec](https://rspec.info)
-* [mutant-minitest](/docs/mutant-minitest.md) for [minitest](https://github.com/seattlerb/minitest)
-
-## Report
-
-Mutant currently provides two different reporters:
-
-* Progress (printed during mutation testing).
-* Summary (printed at the end of a finished analysis run)
-
-A reporter producing a machine readable report does not exist in the OSS version
-at the time of writing this documentation.

data/docs/reading-reports.md

@@ -1,74 +0,0 @@
-Reading Reports
-===============
-
-Mutation output is grouped by selection groups. Each group contains three sections:
-
-1. An identifier for the current group.
-
-   **Format**:
-
-   ```text
-   [SUBJECT EXPRESSION]:[SOURCE LOCATION]:[LINENO]
-   ```
-
-   **Example**:
-
-   ```text
-   Book#add_page:Book#add_page:/home/dev/mutant-examples/lib/book.rb:18
-   ```
-
-2. A list of specs that mutant ran to try to kill mutations for the current group.
-
-   **Format**:
-
-   ```text
-   - [INTEGRATION]:0:[SPEC LOCATION]:[SPEC DESCRIPTION]
-   - [INTEGRATION]:1:[SPEC LOCATION]:[SPEC DESCRIPTION]
-   ```
-
-   **Example**:
-
-   ```text
-   - rspec:0:./spec/unit/book_spec.rb:9/Book#add_page should return self
-   - rspec:1:./spec/unit/book_spec.rb:13/Book#add_page should add page to book
-   ```
-
-3. A list of unkilled mutations diffed against the original unparsed source
-
-   **Format**:
-
-   ```text
-   [MUTATION TYPE]:[SUBJECT EXPRESSION]:[SOURCE LOCATION]:[SOURCE LINENO]:[IDENTIFIER]
-   [DIFF]
-   -----------------------
-   ```
-
-   - `[MUTATION TYPE]` will be one of the following:
-      - `evil` - a mutation of your source was not killed by your tests
-      - `neutral` your original source was injected and one or more tests failed
-   - `[IDENTIFIER]` - Unique identifier for this mutation
-
-   **Example**:
-
-   ```diff
-   evil:Book#add_page:Book#add_page:/home/dev/mutant-examples/lib/book.rb:18:01f69
-   @@ -1,6 +1,6 @@
-    def add_page(page)
-   -  @pages << page
-   +  @pages
-      @index[page.number] = page
-      self
-    end
-   -----------------------
-   evil:Book#add_page:Book#add_page:/home/dev/mutant-examples/lib/book.rb:18:b1ff2
-   @@ -1,6 +1,6 @@
-    def add_page(page)
-   -  @pages << page
-   +  self
-      @index[page.number] = page
-      self
-    end
-   -----------------------
-   ```
-
-At this time no machine readable output exists in the opensourced versions of mutant.

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

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-module Mutant
-  class Mutator
-    class Node
-
-      # Dsym mutator
-      class Dsym < Generic
-
-        handle(:dsym)
-
-      private
-
-        def dispatch
-          super()
-          emit_singletons
-        end
-
-      end # Dsym
-    end # Node
-  end # Mutator
-end # Mutant

data/meta/and.rb

@@ -1,13 +0,0 @@
-# frozen_string_literal: true
-
-Mutant::Meta::Example.add :and do
-  source 'true and false'
-
-  singleton_mutations
-  mutation 'true'
-  mutation 'false'
-  mutation 'true or false'
-  mutation 'false and false'
-  mutation 'true and true'
-  mutation '!true and false'
-end

data/meta/and_asgn.rb

@@ -1,14 +0,0 @@
-# frozen_string_literal: true
-
-Mutant::Meta::Example.add :and_asgn do
-  source 'a &&= 1'
-
-  singleton_mutations
-
-  mutation 'a__mutant__ &&= 1'
-  mutation 'a &&= nil'
-  mutation 'a &&= 0'
-  mutation 'a &&= -1'
-  mutation 'a &&= 2'
-  mutation 'a &&= self'
-end

data/meta/array.rb

@@ -1,27 +0,0 @@
-# frozen_string_literal: true
-
-Mutant::Meta::Example.add :array do
-  source '[true]'
-
-  singleton_mutations
-  mutation 'true'
-  mutation '[false]'
-  mutation '[]'
-end
-
-Mutant::Meta::Example.add :array do
-  source '[true, false]'
-
-  singleton_mutations
-
-  # Mutation of each element in array
-  mutation '[false, false]'
-  mutation '[true, true]'
-
-  # Remove each element of array once
-  mutation '[true]'
-  mutation '[false]'
-
-  # Empty array
-  mutation '[]'
-end

data/meta/begin.rb

@@ -1,20 +0,0 @@
-# frozen_string_literal: true
-
-Mutant::Meta::Example.add :begin do
-
-  source 'true; false'
-  # Mutation of each statement in block
-  mutation 'true; true'
-  mutation 'false; false'
-
-  # Delete each statement
-  mutation 'true'
-  mutation 'false'
-end
-
-Mutant::Meta::Example.add :begin do
-
-  source s(:begin, s(:true))
-  # Mutation of each statement in block
-  mutation s(:begin, s(:false))
-end

data/meta/block.rb

@@ -1,199 +0,0 @@
-# frozen_string_literal: true
-
-Mutant::Meta::Example.add :block do
-  source 'foo { a; b }'
-
-  singleton_mutations
-  mutation 'foo { a }'
-  mutation 'foo { b }'
-  mutation 'foo {}'
-  mutation 'foo { raise }'
-  mutation 'foo { a; nil }'
-  mutation 'foo { a; self }'
-  mutation 'foo { nil; b }'
-  mutation 'foo { self; b }'
-  mutation 'foo'
-  mutation 'a; b'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { |a, b| }'
-
-  singleton_mutations
-  mutation 'foo'
-  mutation 'foo { |a, b| raise }'
-  mutation 'foo { |a, _b| }'
-  mutation 'foo { |_a, b| }'
-  mutation 'foo { |a, | }'
-  mutation 'foo { |b, | }'
-  mutation 'foo { || }'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { |(a, b), c| }'
-
-  singleton_mutations
-  mutation 'foo { || }'
-  mutation 'foo { |a, b, c| }'
-  mutation 'foo { |(a, b), c| raise }'
-  mutation 'foo { |(a), c| }'
-  mutation 'foo { |(b), c| }'
-  mutation 'foo { |c, | }'
-  mutation 'foo { |(_a, b), c| }'
-  mutation 'foo { |(a, _b), c| }'
-  mutation 'foo { |(a, b), _c| }'
-  mutation 'foo'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo(a, b) {}'
-
-  singleton_mutations
-  mutation 'foo(a, nil) {}'
-  mutation 'foo(nil, b) {}'
-  mutation 'foo(self, b) {}'
-  mutation 'foo(a, self) {}'
-  mutation 'foo(a, b)'
-  mutation 'foo(a, b) { raise }'
-  mutation 'foo(a) {}'
-  mutation 'foo(b) {}'
-  mutation 'foo {}'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { |_a| }'
-
-  singleton_mutations
-  mutation 'foo { || }'
-  mutation 'foo { |_a| raise }'
-  mutation 'foo'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { |a| }'
-
-  singleton_mutations
-  mutation 'foo { || }'
-  mutation 'foo { |a| raise }'
-  mutation 'foo { |_a| }'
-  mutation 'foo'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { |a| }'
-
-  singleton_mutations
-  mutation 'foo { || }'
-  mutation 'foo { |a| raise }'
-  mutation 'foo { |_a| }'
-  mutation 'foo'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { bar(nil) }'
-
-  singleton_mutations
-  mutation 'foo'
-  mutation 'foo { bar }'
-  mutation 'foo { nil }'
-  mutation 'foo {}'
-  mutation 'foo { self }'
-  mutation 'foo { raise }'
-  mutation 'foo.bar(nil)'
-  mutation 'bar(nil)'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { self << true }'
-
-  singleton_mutations
-  mutation 'foo { self << false }'
-  mutation 'foo { nil << true }'
-  mutation 'foo { nil }'
-  mutation 'foo { self }'
-  mutation 'foo { true }'
-  mutation 'self << true'
-  mutation 'foo << true'
-  mutation 'foo { raise }'
-  mutation 'foo { }'
-  mutation 'foo'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { next if true }'
-
-  singleton_mutations
-  mutation 'foo'
-  mutation 'foo { }'
-  mutation 'foo { self }'
-  mutation 'foo { nil }'
-  mutation 'foo { raise }'
-  mutation 'foo { self if true }'
-  mutation 'foo { nil if true }'
-  mutation 'foo { break if true }'
-  mutation 'foo { next if !true }'
-  mutation 'foo { next if false }'
-  mutation 'foo { next }'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { next }'
-
-  singleton_mutations
-  mutation 'foo { nil }'
-  mutation 'foo { raise }'
-  mutation 'foo { self }'
-  mutation 'foo { break }'
-  mutation 'foo { }'
-  mutation 'foo'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { break if true }'
-
-  singleton_mutations
-  mutation 'foo'
-  mutation 'foo { }'
-  mutation 'foo { self }'
-  mutation 'foo { nil }'
-  mutation 'foo { raise }'
-  mutation 'foo { self if true }'
-  mutation 'foo { nil if true }'
-  mutation 'foo { break if !true }'
-  mutation 'foo { break if false }'
-  mutation 'foo { break }'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo { break }'
-
-  singleton_mutations
-  mutation 'foo { nil }'
-  mutation 'foo { raise }'
-  mutation 'foo { self }'
-  mutation 'foo { }'
-  mutation 'foo'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo(&:bar).baz {}'
-
-  singleton_mutations
-
-  mutation 'foo(&:bar).baz { raise }'
-  mutation 'foo.baz { }'
-  mutation 'foo(&:bar).baz'
-  mutation 'self.baz {}'
-end
-
-Mutant::Meta::Example.add :block do
-  source 'foo(nil, &:bar).baz {}'
-
-  singleton_mutations
-  mutation 'foo(nil, &:bar).baz { raise }'
-  mutation 'foo(&:bar).baz { }'
-  mutation 'foo(nil).baz { }'
-  mutation 'foo.baz { }'
-  mutation 'self.baz { }'
-  mutation 'foo(nil, &:bar).baz'
-end