mutest-rspec 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d815353a912cc998ffe6a9cb7bb3bf1f5a2e4634
+  data.tar.gz: 6130aab82b5a76037ef4a5b33129dac098cfecd1
+SHA512:
+  metadata.gz: 63cd6c629d0ccdd37c48f44f626b8a2f7d3860c5a755f4152e4cdf2568d65b557b4288fe33de165f2358600f53b079164135ed228c3449c61b553862d2aaf59f
+  data.tar.gz: 3c23b9ed824243424b466c7758ffeed4ae52ef42c99e904974b8b12e8ab2b0a0e1d0ae0ea3775f7cca9d6089dc1ef4d314e1ce7b1761f13d482cc1ca605b74a8

data/LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2012-2017 Markus Schirp
+Copyright (c) 2017 John Backus
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/lib/mutest/integration/rspec.rb

@@ -0,0 +1,149 @@
+require 'rspec/core'
+
+module Mutest
+  class Integration
+    # Rspec integration
+    #
+    # This looks so complicated, because rspec:
+    #
+    # * Keeps its state global in RSpec.world and lots of other places
+    # * There is no API to "just run a subset of examples", the examples
+    #   need to be selected in-place via mutating the `RSpec.filtered_examples`
+    #   data structure
+    # * Does not maintain a unique identification for an example,
+    #   aside the instances of `RSpec::Core::Example` objects itself.
+    #   For that reason identifying examples by:
+    #   * full description
+    #   * location
+    #   Is NOT enough. It would not be unique. So we add an "example index"
+    #   for unique reference.
+    #
+    # :reek:TooManyConstants
+    class Rspec < self
+      ALL_EXPRESSION       = Expression::Namespace::Recursive.new(scope_name: nil)
+      EXPRESSION_CANDIDATE = /\A([^ ]+)(?: )?/
+      LOCATION_DELIMITER   = ':'.freeze
+      EXIT_SUCCESS         = 0
+      CLI_OPTIONS          = IceNine.deep_freeze(%w[spec --fail-fast])
+      TEST_ID_FORMAT       = 'rspec:%<index>d:%<location>s/%<description>s'.freeze
+
+      private_constant(*constants(false))
+
+      # Initialize rspec integration
+      #
+      # @return [undefined]
+      def initialize(*)
+        super
+        @output = StringIO.new
+        @runner = RSpec::Core::Runner.new(RSpec::Core::ConfigurationOptions.new(CLI_OPTIONS))
+        @world  = RSpec.world
+      end
+
+      # Setup rspec integration
+      #
+      # @return [self]
+      def setup
+        @runner.setup($stderr, @output)
+        self
+      end
+      memoize :setup
+
+      # Run a collection of tests
+      #
+      # @param [Enumerable<Mutest::Test>] tests
+      #
+      # @return [Result::Test]
+      #
+      # rubocop:disable MethodLength
+      def call(tests)
+        examples = tests.map(&all_tests_index.method(:fetch))
+        filter_examples(&examples.method(:include?))
+        start = Time.now
+        passed = @runner.run_specs(@world.ordered_example_groups).equal?(EXIT_SUCCESS)
+        @output.rewind
+        Result::Test.new(
+          output:  @output.read,
+          passed:  passed,
+          runtime: Time.now - start,
+          tests:   tests
+        )
+      end
+
+      # Available tests
+      #
+      # @return [Enumerable<Test>]
+      def all_tests
+        all_tests_index.keys
+      end
+      memoize :all_tests
+
+      private
+
+      # Index of available tests
+      #
+      # @return [Hash<Test, RSpec::Core::Example]
+      def all_tests_index
+        all_examples.each_with_index.each_with_object({}) do |(example, example_index), index|
+          index[parse_example(example, example_index)] = example
+        end
+      end
+      memoize :all_tests_index
+
+      # Parse example into test
+      #
+      # @param [RSpec::Core::Example] example
+      # @param [Fixnum] index
+      #
+      # @return [Test]
+      def parse_example(example, index)
+        metadata = example.metadata
+
+        id = format(
+          TEST_ID_FORMAT,
+          index:       index,
+          location:    metadata.fetch(:location),
+          description: metadata.fetch(:full_description)
+        )
+
+        Test.new(
+          expression: parse_expression(metadata),
+          id:         id
+        )
+      end
+
+      # Parse metadata into expression
+      #
+      # @param [RSpec::Core::Example::MetaData] metadata
+      #
+      # @return [Expression]
+      def parse_expression(metadata)
+        if metadata.key?(:mutest_expression)
+          expression_parser.(metadata.fetch(:mutest_expression))
+        else
+          match = EXPRESSION_CANDIDATE.match(metadata.fetch(:full_description))
+          expression_parser.try_parse(match.captures.first) || ALL_EXPRESSION
+        end
+      end
+
+      # Available rspec examples
+      #
+      # @return [Array<String, RSpec::Core::Example]
+      def all_examples
+        @world.example_groups.flat_map(&:descendants).flat_map(&:examples).select do |example|
+          example.metadata.fetch(:mutest, true)
+        end
+      end
+
+      # Filter examples
+      #
+      # @param [#call] predicate
+      #
+      # @return [undefined]
+      def filter_examples(&predicate)
+        @world.filtered_examples.each_value do |examples|
+          examples.keep_if(&predicate)
+        end
+      end
+    end # Rspec
+  end # Integration
+end # Mutest

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: mutest-rspec
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Daniel Gollahon
+- John Backus
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-01-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mutest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.2
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.4.0
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: 3.6.0
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.5
+description: Rspec integration for mutest
+email:
+- johncbackus@gmail.com
+- daniel.gollahon@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE
+files:
+- LICENSE
+- lib/mutest/integration/rspec.rb
+homepage: https://github.com/backus/mutest
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: Rspec integration for mutest
+test_files: []