opal-rspec 0.4.3 → 0.5.0.beta1

data/rspec-core/lib/rspec/core/shared_example_group.rb

@@ -0,0 +1,182 @@
+module RSpec
+  module Core
+    # Shared example groups let you define common context and/or common
+    # examples that you wish to use in multiple example groups.
+    #
+    # When defined, the shared group block is stored for later evaluation.
+    # It can later be included in an example group either explicitly
+    # (using `include_examples`, `include_context` or `it_behaves_like`)
+    # or implicitly (via matching metadata).
+    #
+    # Named shared example groups are scoped based on where they are
+    # defined. Shared groups defined in an example group are available
+    # for inclusion in that example group or any child example groups,
+    # but not in any parent or sibling example groups. Shared example
+    # groups defined at the top level can be included from any example group.
+    module SharedExampleGroup
+      # @overload shared_examples(name, &block)
+      #   @param name [String, Symbol, Module] identifer to use when looking up this shared group
+      #   @param block The block to be eval'd
+      # @overload shared_examples(name, metadata, &block)
+      #   @param name [String, Symbol, Module] identifer to use when looking up this shared group
+      #   @param metadata [Array<Symbol>, Hash] metadata to attach to this group; any example group
+      #     with matching metadata will automatically include this shared example group.
+      #   @param block The block to be eval'd
+      # @overload shared_examples(metadata, &block)
+      #   @param metadata [Array<Symbol>, Hash] metadata to attach to this group; any example group
+      #     with matching metadata will automatically include this shared example group.
+      #   @param block The block to be eval'd
+      #
+      # Stores the block for later use. The block will be evaluated
+      # in the context of an example group via `include_examples`,
+      # `include_context`, or `it_behaves_like`.
+      #
+      # @example
+      #   shared_examples "auditable" do
+      #     it "stores an audit record on save!" do
+      #       expect { auditable.save! }.to change(Audit, :count).by(1)
+      #     end
+      #   end
+      #
+      #   describe Account do
+      #     it_behaves_like "auditable" do
+      #       let(:auditable) { Account.new }
+      #     end
+      #   end
+      #
+      # @see ExampleGroup.it_behaves_like
+      # @see ExampleGroup.include_examples
+      # @see ExampleGroup.include_context
+      def shared_examples(name, *args, &block)
+        top_level = self == ExampleGroup
+        if top_level && RSpec.thread_local_metadata[:in_example_group]
+          raise "Creating isolated shared examples from within a context is " \
+                "not allowed. Remove `RSpec.` prefix or move this to a " \
+                "top-level scope."
+        end
+
+        RSpec.world.shared_example_group_registry.add(self, name, *args, &block)
+      end
+      alias shared_context      shared_examples
+      alias shared_examples_for shared_examples
+
+      # @api private
+      #
+      # Shared examples top level DSL
+      module TopLevelDSL
+        # @private
+        def self.definitions
+          proc do
+            def shared_examples(name, *args, &block)
+              RSpec.world.shared_example_group_registry.add(:main, name, *args, &block)
+            end
+            alias shared_context      shared_examples
+            alias shared_examples_for shared_examples
+          end
+        end
+
+        # @private
+        def self.exposed_globally?
+          @exposed_globally ||= false
+        end
+
+        # @api private
+        #
+        # Adds the top level DSL methods to Module and the top level binding
+        def self.expose_globally!
+          return if exposed_globally?
+          Core::DSL.change_global_dsl(&definitions)
+          @exposed_globally = true
+        end
+
+        # @api private
+        #
+        # Removes the top level DSL methods to Module and the top level binding
+        def self.remove_globally!
+          return unless exposed_globally?
+
+          Core::DSL.change_global_dsl do
+            undef shared_examples
+            undef shared_context
+            undef shared_examples_for
+          end
+
+          @exposed_globally = false
+        end
+      end
+
+      # @private
+      class Registry
+        def add(context, name, *metadata_args, &block)
+          ensure_block_has_source_location(block) { CallerFilter.first_non_rspec_line }
+
+          if valid_name?(name)
+            warn_if_key_taken context, name, block
+            shared_example_groups[context][name] = block
+          else
+            metadata_args.unshift name
+          end
+
+          return if metadata_args.empty?
+
+          mod = Module.new
+          (class << mod; self; end).__send__(:define_method, :included) do |host|
+            host.class_exec(&block)
+          end
+          RSpec.configuration.include mod, *metadata_args
+        end
+
+        def find(lookup_contexts, name)
+          lookup_contexts.each do |context|
+            found = shared_example_groups[context][name]
+            return found if found
+          end
+
+          shared_example_groups[:main][name]
+        end
+
+      private
+
+        def shared_example_groups
+          @shared_example_groups ||= Hash.new { |hash, context| hash[context] = {} }
+        end
+
+        def valid_name?(candidate)
+          case candidate
+          when String, Symbol, Module then true
+          else false
+          end
+        end
+
+        def warn_if_key_taken(context, key, new_block)
+          existing_block = shared_example_groups[context][key]
+
+          return unless existing_block
+
+          RSpec.warn_with <<-WARNING.gsub(/^ +\|/, ''), :call_site => nil
+            |WARNING: Shared example group '#{key}' has been previously defined at:
+            |  #{formatted_location existing_block}
+            |...and you are now defining it at:
+            |  #{formatted_location new_block}
+            |The new definition will overwrite the original one.
+          WARNING
+        end
+
+        def formatted_location(block)
+          block.source_location.join ":"
+        end
+
+        if Proc.method_defined?(:source_location)
+          def ensure_block_has_source_location(_block); end
+        else # for 1.8.7
+          def ensure_block_has_source_location(block)
+            source_location = yield.split(':')
+            block.extend Module.new { define_method(:source_location) { source_location } }
+          end
+        end
+      end
+    end
+  end
+
+  instance_exec(&Core::SharedExampleGroup::TopLevelDSL.definitions)
+end

data/rspec-core/lib/rspec/core/test_unit_assertions_adapter.rb

@@ -0,0 +1,30 @@
+require 'test/unit/assertions'
+
+module RSpec
+  module Core
+    # @private
+    module TestUnitAssertionsAdapter
+      include ::Test::Unit::Assertions
+
+      # If using test/unit from Ruby core with Ruby 1.9+, it includes
+      # MiniTest::Assertions by default. Note the upcasing of 'Test'.
+      #
+      # If the test/unit gem is being loaded, it will not include any minitest
+      # assertions.
+      #
+      # Only if Minitest 5.x is included / loaded do we need to worry about
+      # adding a shim for the new updates. Thus instead of checking on the
+      # RUBY_VERSION we need to check ancestors.
+      begin
+        # MiniTest is 4.x
+        # Minitest is 5.x
+        if ancestors.include?(::Minitest::Assertions)
+          require 'rspec/core/minitest_assertions_adapter'
+          include ::RSpec::Core::MinitestAssertionsAdapter
+        end
+      rescue NameError
+        # No-op. Minitest 5.x was not loaded
+      end
+    end
+  end
+end

data/rspec-core/lib/rspec/core/version.rb

@@ -0,0 +1,9 @@
+module RSpec
+  module Core
+    # Version information for RSpec Core.
+    module Version
+      # Current version of RSpec Core, in semantic versioning format.
+      STRING = '3.1.7'
+    end
+  end
+end

data/rspec-core/lib/rspec/core/warnings.rb

@@ -0,0 +1,40 @@
+require "rspec/support/warnings"
+
+module RSpec
+  module Core
+    # @private
+    module Warnings
+      # @private
+      #
+      # Used internally to print deprecation warnings
+      def deprecate(deprecated, data={})
+        RSpec.configuration.reporter.deprecation(
+          {
+            :deprecated => deprecated,
+            :call_site => CallerFilter.first_non_rspec_line
+          }.merge(data)
+        )
+      end
+
+      # @private
+      #
+      # Used internally to print deprecation warnings
+      def warn_deprecation(message, opts={})
+        RSpec.configuration.reporter.deprecation opts.merge(:message => message)
+      end
+
+      # @private
+      def warn_with(message, options={})
+        if options[:use_spec_location_as_call_site]
+          message += "." unless message.end_with?(".")
+
+          if RSpec.current_example
+            message += " Warning generated from spec at `#{RSpec.current_example.location}`."
+          end
+        end
+
+        super(message, options)
+      end
+    end
+  end
+end

data/{vendor_lib → rspec-core/lib}/rspec/core/world.rb

@@ -1,71 +1,117 @@
+require 'rbconfig'
+
 module RSpec
   module Core
+    # @api private
+    #
+    # Internal container for global non-configuration data
     class World
-
       include RSpec::Core::Hooks
 
+      # @private
       attr_reader :example_groups, :filtered_examples
+
+      # Used internally to determine what to do when a SIGINT is received
       attr_accessor :wants_to_quit
 
       def initialize(configuration=RSpec.configuration)
         @configuration = configuration
         @example_groups = []
-        @filtered_examples = Hash.new { |hash,group|
+        @filtered_examples = Hash.new do |hash, group|
           hash[group] = begin
             examples = group.examples.dup
             examples = filter_manager.prune(examples)
             examples.uniq!
             examples
           end
-        }
+        end
+      end
+
+      # @private
+      # Used internally to clear remaining groups when fail_fast is set
+      def clear_remaining_example_groups
+        example_groups.clear
+      end
+
+      # @private
+      def windows_os?
+        RbConfig::CONFIG['host_os'] =~ /cygwin|mswin|mingw|bccwin|wince|emx/
       end
 
+      # @api private
+      #
+      # Apply ordering strategy from configuration to example groups
       def ordered_example_groups
         ordering_strategy = @configuration.ordering_registry.fetch(:global)
         ordering_strategy.order(@example_groups)
       end
 
+      # @api private
+      #
+      # Reset world to 'scratch' before running suite
       def reset
         example_groups.clear
-        SharedExampleGroup.registry.clear
+        @shared_example_group_registry = nil
       end
 
+      # @private
       def filter_manager
         @configuration.filter_manager
       end
 
+      # @api private
+      #
+      # Register an example group
       def register(example_group)
         example_groups << example_group
         example_group
       end
 
+      # @private
+      def shared_example_group_registry
+        @shared_example_group_registry ||= SharedExampleGroup::Registry.new
+      end
+
+      # @private
       def inclusion_filter
         @configuration.inclusion_filter
       end
 
+      # @private
       def exclusion_filter
         @configuration.exclusion_filter
       end
 
+      # @private
       def configure_group(group)
         @configuration.configure_group(group)
       end
 
-      def example_count
-        FlatMap.flat_map(example_groups) {|g| g.descendants}.
-          inject(0) {|sum, g| sum + g.filtered_examples.size}
+      # @api private
+      #
+      # Get count of examples to be run
+      def example_count(groups=example_groups)
+        FlatMap.flat_map(groups) { |g| g.descendants }.
+          inject(0) { |a, e| a + e.filtered_examples.size }
       end
 
+      # @api private
+      #
+      # Find line number of previous declaration
       def preceding_declaration_line(filter_line)
         declaration_line_numbers.sort.inject(nil) do |highest_prior_declaration_line, line|
           line <= filter_line ? line : highest_prior_declaration_line
         end
       end
 
+      # @private
       def reporter
         @configuration.reporter
       end
 
+      # @api private
+      #
+      # Notify reporter of filters
       def announce_filters
         filter_announcements = []
 
@@ -86,36 +132,43 @@ module RSpec
           inclusion_filter.clear
         end
 
-        if example_count.zero?
-          example_groups.clear
-          if filter_manager.empty?
-            reporter.message("No examples found.")
-          elsif exclusion_filter.empty_without_conditional_filters?
-            message = everything_filtered_message
-            if @configuration.run_all_when_everything_filtered?
-              message << "; ignoring #{inclusion_filter.description}"
-            end
-            reporter.message(message)
-          elsif inclusion_filter.empty?
-            reporter.message(everything_filtered_message)
+        return unless example_count.zero?
+
+        example_groups.clear
+        if filter_manager.empty?
+          reporter.message("No examples found.")
+        elsif exclusion_filter.empty?
+          message = everything_filtered_message
+          if @configuration.run_all_when_everything_filtered?
+            message << "; ignoring #{inclusion_filter.description}"
           end
+          reporter.message(message)
+        elsif inclusion_filter.empty?
+          reporter.message(everything_filtered_message)
         end
       end
 
+      # @private
       def everything_filtered_message
         "\nAll examples were filtered out"
       end
 
+      # @api private
+      #
+      # Add inclusion filters to announcement message
       def announce_inclusion_filter(announcements)
-        unless inclusion_filter.empty?
-          announcements << "include #{inclusion_filter.description}"
-        end
+        return if inclusion_filter.empty?
+
+        announcements << "include #{inclusion_filter.description}"
       end
 
+      # @api private
+      #
+      # Add exclusion filters to announcement message
       def announce_exclusion_filter(announcements)
-        unless exclusion_filter.empty_without_conditional_filters?
-          announcements << "exclude #{exclusion_filter.description}"
-        end
+        return if exclusion_filter.empty?
+
+        announcements << "exclude #{exclusion_filter.description}"
       end
 
     private
@@ -125,7 +178,6 @@ module RSpec
           lines + g.declaration_line_numbers
         end
       end
-
     end
   end
 end

data/{vendor_lib → rspec-core/lib}/rspec/core.rb

@@ -1,76 +1,53 @@
-require_rspec = if defined?(require_relative)
-  lambda do |path|
-    require_relative path
-  end
-else # for 1.8.7
-  lambda do |path|
-    require "rspec/#{path}"
-  end
-end
+# rubocop:disable Style/GlobalVars
+$_rspec_core_load_started_at = Time.now
+# rubocop:enable Style/GlobalVars
 
-require 'set'
-require 'time'
 require 'rbconfig'
 
-require_rspec['core/version']
-
-require 'rspec/support/caller_filter'
-require 'rspec/core/warnings'
-require 'rspec/support/warnings'
-
-require_rspec['core/flat_map']
-require_rspec['core/filter_manager']
-require_rspec['core/dsl']
-require_rspec['core/reporter']
-
-require_rspec['core/hooks']
-require_rspec['core/memoized_helpers']
-require_rspec['core/metadata']
-require_rspec['core/pending']
-require_rspec['core/formatters']
-require_rspec['core/ordering']
-
-require_rspec['core/world']
-require_rspec['core/configuration']
-require_rspec['core/option_parser']
-require_rspec['core/configuration_options']
-require_rspec['core/command_line']
-require_rspec['core/runner']
-require_rspec['core/example']
-require_rspec['core/shared_example_group/collection']
-require_rspec['core/shared_example_group']
-require_rspec['core/example_group']
-
+require "rspec/support"
+RSpec::Support.require_rspec_support "caller_filter"
+
+RSpec::Support.define_optimized_require_for_rspec(:core) { |f| require_relative f }
+
+%w[
+  version
+  warnings
+
+  flat_map
+  filter_manager
+  dsl
+  notifications
+  reporter
+
+  hooks
+  memoized_helpers
+  metadata
+  metadata_filter
+  pending
+  formatters
+  ordering
+
+  world
+  configuration
+  option_parser
+  configuration_options
+  runner
+  example
+  shared_example_group
+  example_group
+].each { |name| RSpec::Support.require_rspec_core name }
+
+# Namespace for all core RSpec code.
 module RSpec
   autoload :SharedContext, 'rspec/core/shared_context'
 
-  # @private
-  def self.wants_to_quit
-  # Used internally to determine what to do when a SIGINT is received
-    world.wants_to_quit
-  end
-
-  # @private
-  # Used internally to determine what to do when a SIGINT is received
-  def self.wants_to_quit=(maybe)
-    world.wants_to_quit=(maybe)
-  end
-
-  # @private
-  # Internal container for global non-configuration data
-  def self.world
-    @world ||= RSpec::Core::World.new
-  end
+  extend RSpec::Core::Warnings
 
-  # @private
-  # Used internally to set the global object
-  def self.world=(new_world)
-    @world = new_world
-  end
-
-  # @private
-  # Used internally to ensure examples get reloaded between multiple runs in
+  # Used to ensure examples get reloaded between multiple runs in
   # the same process.
+  #
+  # Users must invoke this if they want to have the configuration reset when
+  # they use runner multiple times within the same process.
   def self.reset
     @world = nil
     @configuration = nil
@@ -85,27 +62,11 @@ module RSpec
   # @see RSpec.configure
   # @see Core::Configuration
   def self.configuration
-    if block_given?
-      RSpec.warn_deprecation <<-WARNING
-
-*****************************************************************
-DEPRECATION WARNING
-
-* RSpec.configuration with a block is deprecated and has no effect.
-* please use RSpec.configure with a block instead.
-
-Called from #{CallerFilter.first_non_rspec_line}
-*****************************************************************
-
-WARNING
-    end
-    @configuration ||= RSpec::Core::Configuration.new
-  end
-
-  # @private
-  # Used internally to set the global object
-  def self.configuration=(new_configuration)
-    @configuration = new_configuration
+    @configuration ||= begin
+                         config = RSpec::Core::Configuration.new
+                         config.expose_dsl_globally = true
+                         config
+                       end
   end
 
   # Yields the global configuration to a block.
@@ -120,12 +81,6 @@ WARNING
     yield configuration if block_given?
   end
 
-  # @private
-  # Used internally to clear remaining groups when fail_fast is set
-  def self.clear_remaining_example_groups
-    world.example_groups.clear
-  end
-
   # The example being executed.
   #
   # The primary audience for this method is library authors who need access
@@ -140,7 +95,7 @@ WARNING
   #       fetch_current_example = RSpec.respond_to?(:current_example) ?
   #         proc { RSpec.current_example } : proc { |context| context.example }
   #
-  #       c.before(:each) do
+  #       c.before(:example) do
   #         example = fetch_current_example.call(self)
   #
   #         # ...
@@ -148,20 +103,29 @@ WARNING
   #     end
   #
   def self.current_example
-    Thread.current[:_rspec_current_example]
+    thread_local_metadata[:current_example]
   end
 
   # Set the current example being executed.
   # @api private
   def self.current_example=(example)
-    Thread.current[:_rspec_current_example] = example
+    thread_local_metadata[:current_example] = example
   end
 
   # @private
-  def self.windows_os?
-    RbConfig::CONFIG['host_os'] =~ /cygwin|mswin|mingw|bccwin|wince|emx/
+  # A single thread local variable so we don't excessively pollute that
+  # namespace.
+  def self.thread_local_metadata
+    Thread.current[:_rspec] ||= {}
   end
 
+  # @private
+  # Internal container for global non-configuration data
+  def self.world
+    @world ||= RSpec::Core::World.new
+  end
+
+  # Namespace for the rspec-core code.
   module Core
     # @private
     # This avoids issues with reporting time caused by examples that
@@ -179,12 +143,14 @@ WARNING
     end
   end
 
+  # @private
   MODULES_TO_AUTOLOAD = {
     :Matchers     => "rspec/expectations",
     :Expectations => "rspec/expectations",
     :Mocks        => "rspec/mocks"
   }
 
+  # @private
   def self.const_missing(name)
     # Load rspec-expectations when RSpec::Matchers is referenced. This allows
     # people to define custom matchers (using `RSpec::Matchers.define`) before
@@ -196,7 +162,7 @@ WARNING
     #
     # As of rspec 2.14.1, we no longer require `rspec/mocks` and
     # `rspec/expectations` when `rspec` is required, so we want
-    # to make them available as an autoload. For more info, see:
+    # to make them available as an autoload.
     require MODULES_TO_AUTOLOAD.fetch(name) { return super }
     ::RSpec.const_get(name)
   end