opal-rspec 0.8.0.alpha3 → 1.0.0.alpha1

data/rspec-core/upstream/lib/rspec/core/world.rb

@@ -1,46 +1,54 @@
-require 'rbconfig'
-
 module RSpec
   module Core
     # @api private
     #
-    # Internal container for global non-configuration data
+    # Internal container for global non-configuration data.
     class World
-      include RSpec::Core::Hooks
-
       # @private
-      attr_reader :example_groups, :filtered_examples
+      attr_reader :example_groups, :filtered_examples, :example_group_counts_by_spec_file
 
-      # Used internally to determine what to do when a SIGINT is received
+      # Used internally to determine what to do when a SIGINT is received.
       attr_accessor :wants_to_quit
 
+      # Used internally to signify that a SystemExit occurred in
+      # `Configuration#load_file_handling_errors`, and thus examples cannot
+      # be counted accurately. Specifically, we cannot accurately report
+      # "No examples found".
+      # @private
+      attr_accessor :rspec_is_quitting
+
+      # Used internally to signal that a failure outside of an example
+      # has occurred, and that therefore the exit status should indicate
+      # the run failed.
+      # @private
+      attr_accessor :non_example_failure
+
       def initialize(configuration=RSpec.configuration)
+        @wants_to_quit = false
+        @rspec_is_quitting = false
         @configuration = configuration
+        configuration.world = self
         @example_groups = []
-        @filtered_examples = Hash.new do |hash, group|
-          hash[group] = begin
-            examples = group.examples.dup
-            examples = filter_manager.prune(examples)
-            examples.uniq!
-            examples
-          end
-        end
+        @example_group_counts_by_spec_file = Hash.new(0)
+        prepare_example_filtering
       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/
+      # @api public
+      #
+      # Prepares filters so that they apply to example groups when they run.
+      #
+      # This is a separate method so that filters can be modified/replaced and
+      # examples refiltered during a process's lifetime, which can be useful for
+      # a custom runner.
+      def prepare_example_filtering
+        @filtered_examples = Hash.new do |hash, group|
+          hash[group] = filter_manager.prune(group.examples)
+        end
       end
 
       # @api private
       #
-      # Apply ordering strategy from configuration to example groups
+      # Apply ordering strategy from configuration to example groups.
       def ordered_example_groups
         ordering_strategy = @configuration.ordering_registry.fetch(:global)
         ordering_strategy.order(@example_groups)
@@ -48,10 +56,13 @@ module RSpec
 
       # @api private
       #
-      # Reset world to 'scratch' before running suite
+      # Reset world to 'scratch' before running suite.
       def reset
+        RSpec::ExampleGroups.remove_all_constants
         example_groups.clear
-        @shared_example_group_registry = nil
+        @sources_by_path.clear if defined?(@sources_by_path)
+        @syntax_highlighter = nil
+        @example_group_counts_by_spec_file = Hash.new(0)
       end
 
       # @private
@@ -59,12 +70,22 @@ module RSpec
         @configuration.filter_manager
       end
 
+      # @private
+      def registered_example_group_files
+        @example_group_counts_by_spec_file.keys
+      end
+
       # @api private
       #
-      # Register an example group
-      def register(example_group)
-        example_groups << example_group
-        example_group
+      # Records an example group.
+      def record(example_group)
+        @configuration.on_example_group_definition_callbacks.each { |block| block.call(example_group) }
+        @example_group_counts_by_spec_file[example_group.metadata[:absolute_file_path]] += 1
+      end
+
+      # @private
+      def num_example_groups_defined_in(file)
+        @example_group_counts_by_spec_file[file]
       end
 
       # @private
@@ -82,26 +103,46 @@ module RSpec
         @configuration.exclusion_filter
       end
 
-      # @private
-      def configure_group(group)
-        @configuration.configure_group(group)
-      end
-
       # @api private
       #
-      # Get count of examples to be run
+      # 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
 
+      # @private
+      def all_example_groups
+        FlatMap.flat_map(example_groups) { |g| g.descendants }
+      end
+
+      # @private
+      def all_examples
+        FlatMap.flat_map(all_example_groups) { |g| g.examples }
+      end
+
+      # @private
+      # Traverses the tree of each top level group.
+      # For each it yields the group, then the children, recursively.
+      # Halts the traversal of a branch of the tree as soon as the passed block returns true.
+      # Note that siblings groups and their sub-trees will continue to be explored.
+      # This is intended to make it easy to find the top-most group that satisfies some
+      # condition.
+      def traverse_example_group_trees_until(&block)
+        example_groups.each do |group|
+          group.traverse_tree_until(&block)
+        end
+      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
+      # Find line number of previous declaration.
+      def preceding_declaration_line(absolute_file_name, filter_line)
+        line_numbers = descending_declaration_line_numbers_by_file.fetch(absolute_file_name) do
+          return nil
         end
+
+        line_numbers.find { |num| num <= filter_line }
       end
 
       # @private
@@ -109,10 +150,26 @@ module RSpec
         @configuration.reporter
       end
 
+      # @private
+      def source_from_file(path)
+        unless defined?(@sources_by_path)
+          RSpec::Support.require_rspec_support 'source'
+          @sources_by_path = {}
+        end
+
+        @sources_by_path[path] ||= Support::Source.from_file(path)
+      end
+
+      # @private
+      def syntax_highlighter
+        @syntax_highlighter ||= Formatters::SyntaxHighlighter.new(@configuration)
+      end
+
       # @api private
       #
-      # Notify reporter of filters
+      # Notify reporter of filters.
       def announce_filters
+        fail_if_config_and_cli_options_invalid
         filter_announcements = []
 
         announce_inclusion_filter filter_announcements
@@ -120,14 +177,14 @@ module RSpec
 
         unless filter_manager.empty?
           if filter_announcements.length == 1
-            reporter.message("Run options: #{filter_announcements[0]}")
+            report_filter_message("Run options: #{filter_announcements[0]}")
           else
-            reporter.message("Run options:\n  #{filter_announcements.join("\n  ")}")
+            report_filter_message("Run options:\n  #{filter_announcements.join("\n  ")}")
           end
         end
 
-        if @configuration.run_all_when_everything_filtered? && example_count.zero?
-          reporter.message("#{everything_filtered_message}; ignoring #{inclusion_filter.description}")
+        if @configuration.run_all_when_everything_filtered? && example_count.zero? && !@configuration.only_failures?
+          report_filter_message("#{everything_filtered_message}; ignoring #{inclusion_filter.description}")
           filtered_examples.clear
           inclusion_filter.clear
         end
@@ -135,19 +192,20 @@ module RSpec
         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}"
+        unless rspec_is_quitting
+          if filter_manager.empty?
+            report_filter_message("No examples found.")
+          elsif exclusion_filter.empty? || inclusion_filter.empty?
+            report_filter_message(everything_filtered_message)
           end
-          reporter.message(message)
-        elsif inclusion_filter.empty?
-          reporter.message(everything_filtered_message)
         end
       end
 
+      # @private
+      def report_filter_message(message)
+        reporter.message(message) unless @configuration.silence_filter_announcements?
+      end
+
       # @private
       def everything_filtered_message
         "\nAll examples were filtered out"
@@ -155,7 +213,7 @@ module RSpec
 
       # @api private
       #
-      # Add inclusion filters to announcement message
+      # Add inclusion filters to announcement message.
       def announce_inclusion_filter(announcements)
         return if inclusion_filter.empty?
 
@@ -164,7 +222,7 @@ module RSpec
 
       # @api private
       #
-      # Add exclusion filters to announcement message
+      # Add exclusion filters to announcement message.
       def announce_exclusion_filter(announcements)
         return if exclusion_filter.empty?
 
@@ -173,10 +231,56 @@ module RSpec
 
     private
 
-      def declaration_line_numbers
-        @line_numbers ||= example_groups.inject([]) do |lines, g|
-          lines + g.declaration_line_numbers
+      def descending_declaration_line_numbers_by_file
+        @descending_declaration_line_numbers_by_file ||= begin
+          declaration_locations = FlatMap.flat_map(example_groups, &:declaration_locations)
+          hash_of_arrays = Hash.new { |h, k| h[k] = [] }
+
+          # TODO: change `inject` to `each_with_object` when we drop 1.8.7 support.
+          line_nums_by_file = declaration_locations.inject(hash_of_arrays) do |hash, (file_name, line_number)|
+            hash[file_name] << line_number
+            hash
+          end
+
+          line_nums_by_file.each_value do |list|
+            list.sort!
+            list.reverse!
+          end
+        end
+      end
+
+      def fail_if_config_and_cli_options_invalid
+        return unless @configuration.only_failures_but_not_configured?
+
+        reporter.abort_with(
+          "\nTo use `--only-failures`, you must first set " \
+          "`config.example_status_persistence_file_path`.",
+          1 # exit code
+        )
+      end
+
+      # @private
+      # Provides a null implementation for initial use by configuration.
+      module Null
+        def self.non_example_failure; end
+        def self.non_example_failure=(_); end
+
+        def self.registered_example_group_files
+          []
+        end
+
+        def self.traverse_example_group_trees_until
+        end
+
+        # :nocov:
+        def self.example_groups
+          []
+        end
+
+        def self.all_example_groups
+          []
         end
+        # :nocov:
       end
     end
   end

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

@@ -2,8 +2,6 @@
 $_rspec_core_load_started_at = Time.now
 # rubocop:enable Style/GlobalVars
 
-require 'rbconfig'
-
 require "rspec/support"
 RSpec::Support.require_rspec_support "caller_filter"
 
@@ -13,6 +11,7 @@ RSpec::Support.define_optimized_require_for_rspec(:core) { |f| require_relative
   version
   warnings
 
+  set
   flat_map
   filter_manager
   dsl
@@ -32,6 +31,7 @@ RSpec::Support.define_optimized_require_for_rspec(:core) { |f| require_relative
   option_parser
   configuration_options
   runner
+  invocations
   example
   shared_example_group
   example_group
@@ -43,18 +43,39 @@ module RSpec
 
   extend RSpec::Core::Warnings
 
-  # Used to ensure examples get reloaded between multiple runs in
-  # the same process.
+  class << self
+    # Setters for shared global objects
+    # @api private
+    attr_writer :configuration, :world
+  end
+
+  # Used to ensure examples get reloaded and user configuration gets reset to
+  # defaults 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.
+  # they use the runner multiple times within the same process. Users must deal
+  # themselves with re-configuration of RSpec before run.
   def self.reset
+    RSpec::ExampleGroups.remove_all_constants
     @world = nil
     @configuration = nil
   end
 
-  # Returns the global [Configuration](RSpec/Core/Configuration) object. While you
-  # _can_ use this method to access the configuration, the more common
+  # Used to ensure examples get reloaded between multiple runs in the same
+  # process and ensures user configuration is persisted.
+  #
+  # Users must invoke this if they want to clear all examples but preserve
+  # current configuration when they use the runner multiple times within the
+  # same process.
+  def self.clear_examples
+    world.reset
+    configuration.reset_reporter
+    configuration.start_time = ::RSpec::Core::Time.now
+    configuration.reset_filters
+  end
+
+  # Returns the global [Configuration](RSpec/Core/Configuration) object. While
+  # you _can_ use this method to access the configuration, the more common
   # convention is to use [RSpec.configure](RSpec#configure-class_method).
   #
   # @example
@@ -62,11 +83,7 @@ module RSpec
   # @see RSpec.configure
   # @see Core::Configuration
   def self.configuration
-    @configuration ||= begin
-                         config = RSpec::Core::Configuration.new
-                         config.expose_dsl_globally = true
-                         config
-                       end
+    @configuration ||= RSpec::Core::Configuration.new
   end
 
   # Yields the global configuration to a block.
@@ -103,30 +120,53 @@ module RSpec
   #     end
   #
   def self.current_example
-    thread_local_metadata[:current_example]
+    RSpec::Support.thread_local_data[:current_example]
   end
 
   # Set the current example being executed.
   # @api private
   def self.current_example=(example)
-    thread_local_metadata[:current_example] = example
+    RSpec::Support.thread_local_data[:current_example] = example
   end
 
-  # @private
-  # A single thread local variable so we don't excessively pollute that
-  # namespace.
-  def self.thread_local_metadata
-    Thread.current[:_rspec] ||= {}
+  # Set the current scope rspec is executing in
+  # @api private
+  def self.current_scope=(scope)
+    RSpec::Support.thread_local_data[:current_scope] = scope
+  end
+  RSpec.current_scope = :suite
+
+  # Get the current RSpec execution scope
+  #
+  # Returns (in order of lifecycle):
+  #   * `:suite` as an initial value, this is outside of the test lifecycle.
+  #   * `:before_suite_hook` during `before(:suite)` hooks.
+  #   * `:before_context_hook` during `before(:context)` hooks.
+  #   * `:before_example_hook` during `before(:example)` hooks and `around(:example)` before `example.run`.
+  #   * `:example` within the example run.
+  #   * `:after_example_hook` during `after(:example)` hooks and `around(:example)` after `example.run`.
+  #   * `:after_context_hook` during `after(:context)` hooks.
+  #   * `:after_suite_hook` during `after(:suite)` hooks.
+  #   * `:suite` as a final value, again this is outside of the test lifecycle.
+  #
+  # Reminder, `:context` hooks have `:all` alias and `:example` hooks have `:each` alias.
+  # @return [Symbol]
+  def self.current_scope
+    RSpec::Support.thread_local_data[:current_scope]
   end
 
   # @private
-  # Internal container for global non-configuration data
+  # Internal container for global non-configuration data.
   def self.world
     @world ||= RSpec::Core::World.new
   end
 
   # Namespace for the rspec-core code.
   module Core
+    autoload :ExampleStatusPersister, "rspec/core/example_status_persister"
+    autoload :Profiler,               "rspec/core/profiler"
+    autoload :DidYouMean,             "rspec/core/did_you_mean"
+
     # @private
     # This avoids issues with reporting time caused by examples that
     # change the value/meaning of Time.now without properly restoring
@@ -137,7 +177,7 @@ module RSpec
       end
     end
 
-    # @private path to executable file
+    # @private path to executable file.
     def self.path_to_executable
       @path_to_executable ||= File.expand_path('../../../exe/rspec', __FILE__)
     end
@@ -166,4 +206,7 @@ module RSpec
     require MODULES_TO_AUTOLOAD.fetch(name) { return super }
     ::RSpec.const_get(name)
   end
+
+  Core::DSL.expose_globally!
+  Core::SharedExampleGroup::TopLevelDSL.expose_globally!
 end

data/rspec-core/upstream/maintenance-branch

@@ -1 +1 @@
-3-1-maintenance
+main

data/rspec-core/upstream/rspec-core.gemspec

@@ -9,14 +9,20 @@ Gem::Specification.new do |s|
   s.license     = "MIT"
   s.authors     = ["Steven Baker", "David Chelimsky", "Chad Humphries", "Myron Marston"]
   s.email       = "rspec@googlegroups.com"
-  s.homepage    = "http://github.com/rspec/rspec-core"
+  s.homepage    = "https://github.com/rspec/rspec-core"
   s.summary     = "rspec-core-#{RSpec::Core::Version::STRING}"
   s.description = "BDD for Ruby. RSpec runner and example groups."
 
-  s.rubyforge_project  = "rspec"
+  s.metadata = {
+    'bug_tracker_uri'   => 'https://github.com/rspec/rspec-core/issues',
+    'changelog_uri'     => "https://github.com/rspec/rspec-core/blob/v#{s.version}/Changelog.md",
+    'documentation_uri' => 'https://rspec.info/documentation/',
+    'mailing_list_uri'  => 'https://groups.google.com/forum/#!forum/rspec',
+    'source_code_uri'   => 'https://github.com/rspec/rspec-core',
+  }
 
   s.files            = `git ls-files -- lib/*`.split("\n")
-  s.files           += %w[README.md License.txt Changelog.md .yardopts .document]
+  s.files           += %w[README.md LICENSE.md Changelog.md .yardopts .document]
   s.test_files       = []
   s.bindir           = 'exe'
   s.executables      = `git ls-files -- exe/*`.split("\n").map{ |f| File.basename(f) }
@@ -39,15 +45,14 @@ Gem::Specification.new do |s|
     s.add_runtime_dependency "rspec-support", "~> #{RSpec::Core::Version::STRING.split('.')[0..1].concat(['0']).join('.')}"
   end
 
-  s.add_development_dependency "rake",     "~> 10.0.0"
-  s.add_development_dependency "cucumber", "~> 1.3"
+  s.add_development_dependency "cucumber", ">= 1.3"
   s.add_development_dependency "minitest", "~> 5.3"
-  s.add_development_dependency "aruba",    "~> 0.5"
+  s.add_development_dependency "aruba",    "~> 0.14.9"
 
-  s.add_development_dependency "nokogiri", "1.5.2"
-  s.add_development_dependency "coderay",  "~> 1.0.9"
+  s.add_development_dependency "coderay",  "~> 1.1.1"
 
-  s.add_development_dependency "mocha",    "~> 0.13.0"
-  s.add_development_dependency "rr",       "~> 1.0.4"
-  s.add_development_dependency "flexmock", "~> 0.9.0"
+  s.add_development_dependency "mocha",        "~> 0.13.0"
+  s.add_development_dependency "rr",           "~> 1.0.4"
+  s.add_development_dependency "flexmock",     "~> 0.9.0"
+  s.add_development_dependency "thread_order", "~> 1.1.0"
 end

data/rspec-core/upstream/script/ci_functions.sh

@@ -0,0 +1,73 @@
+# This file was generated on 2022-09-08T12:41:59+01:00 from the rspec-dev repo.
+# DO NOT modify it by hand as your changes will get lost the next time it is generated.
+
+# Taken from:
+# https://github.com/travis-ci/travis-build/blob/e9314616e182a23e6a280199cd9070bfc7cae548/lib/travis/build/script/templates/header.sh#L34-L53
+travis_retry() {
+  local result=0
+  local count=1
+  while [ $count -le 3 ]; do
+    [ $result -ne 0 ] && {
+      echo -e "\n\033[33;1mThe command \"$@\" failed. Retrying, $count of 3.\033[0m\n" >&2
+    }
+    "$@"
+    result=$?
+    [ $result -eq 0 ] && break
+    count=$(($count + 1))
+    sleep 1
+  done
+
+  [ $count -eq 3 ] && {
+    echo "\n\033[33;1mThe command \"$@\" failed 3 times.\033[0m\n" >&2
+  }
+
+  return $result
+}
+
+# Taken from https://github.com/vcr/vcr/commit/fa96819c92b783ec0c794f788183e170e4f684b2
+# and https://github.com/vcr/vcr/commit/040aaac5370c68cd13c847c076749cd547a6f9b1
+nano_cmd="$(type -p gdate date | head -1)"
+nano_format="+%s%N"
+[ "$(uname -s)" != "Darwin" ] || nano_format="${nano_format/%N/000000000}"
+
+travis_time_start() {
+  travis_timer_id=$(printf %08x $(( RANDOM * RANDOM )))
+  travis_start_time=$($nano_cmd -u "$nano_format")
+  printf "travis_time:start:%s\r\e[0m" $travis_timer_id
+}
+
+travis_time_finish() {
+  local travis_end_time=$($nano_cmd -u "$nano_format")
+  local duration=$(($travis_end_time-$travis_start_time))
+  printf "travis_time:end:%s:start=%s,finish=%s,duration=%s\r\e[0m" \
+    $travis_timer_id $travis_start_time $travis_end_time $duration
+}
+
+fold() {
+  local name="$1"
+  local status=0
+  shift 1
+  if [ -n "$TRAVIS" ]; then
+    printf "travis_fold:start:%s\r\e[0m" "$name"
+    travis_time_start
+  else
+    echo "============= Starting $name ==============="
+  fi
+
+  "$@"
+  status=$?
+
+  [ -z "$TRAVIS" ] || travis_time_finish
+
+  if [ "$status" -eq 0 ]; then
+    if [ -n "$TRAVIS" ]; then
+      printf "travis_fold:end:%s\r\e[0m" "$name"
+    else
+      echo "============= Ending $name ==============="
+    fi
+  else
+    STATUS="$status"
+  fi
+
+  return $status
+}

data/rspec-core/upstream/script/clone_all_rspec_repos

@@ -1,8 +1,8 @@
 #!/bin/bash
-# This file was generated on 2014-08-23T21:27:12-07:00 from the rspec-dev repo.
+# This file was generated on 2022-09-08T12:41:59+01:00 from the rspec-dev repo.
 # DO NOT modify it by hand as your changes will get lost the next time it is generated.
 
-set -e -x
+set -e
 source script/functions.sh
 
 if is_mri; then

data/rspec-core/upstream/script/cucumber.sh

@@ -0,0 +1,8 @@
+#!/bin/bash
+# This file was generated on 2022-09-08T12:41:59+01:00 from the rspec-dev repo.
+# DO NOT modify it by hand as your changes will get lost the next time it is generated.
+
+set -e
+source script/functions.sh
+
+run_cukes

data/rspec-core/upstream/script/custom_build_functions.sh

@@ -0,0 +1,22 @@
+function run_cukes {
+  if [ -d features ]; then
+    echo "${PWD}/bin/cucumber"
+
+    if is_mri_192; then
+      # For some reason we get SystemStackError on 1.9.2 when using
+      # the bin/cucumber approach below. That approach is faster
+      # (as it avoids the bundler tax), so we use it on rubies where we can.
+      bundle exec cucumber --strict
+    elif is_jruby; then
+      echo "WARNING: Cucumber is skipped on JRuby on rspec-core due to" \
+           "excessive build times (>45 minutes) causing timeouts on Travis"
+      return 0
+    else
+      # Prepare RUBYOPT for scenarios that are shelling out to ruby,
+      # and PATH for those that are using `rspec` or `rake`.
+      RUBYOPT="${RUBYOPT} -I${PWD}/../bundle -rbundler/setup" \
+         PATH="${PWD}/bin:$PATH" \
+         bin/cucumber --strict
+    fi
+  fi
+}