opal-connect-rspec 0.5.0

data/rspec-core/spec/support/helper_methods.rb

@@ -0,0 +1,26 @@
+module RSpecHelpers
+  def relative_path(path)
+    RSpec::Core::Metadata.relative_path(path)
+  end
+
+  def ignoring_warnings
+    original = $VERBOSE
+    $VERBOSE = nil
+    result = yield
+    $VERBOSE = original
+    result
+  end
+
+  def safely
+    Thread.new do
+      ignoring_warnings { $SAFE = 3 }
+      yield
+    end.join
+
+    # $SAFE is not supported on Rubinius
+    unless defined?(Rubinius)
+      expect($SAFE).to eql 0 # $SAFE should not have changed in this thread.
+    end
+  end
+
+end

data/rspec-core/spec/support/isolated_home_directory.rb

@@ -0,0 +1,16 @@
+require 'tmpdir'
+require 'fileutils'
+
+RSpec.shared_context "isolated home directory", :isolated_home => true do
+  around do |ex|
+    Dir.mktmpdir do |tmp_dir|
+      original_home = ENV['HOME']
+      begin
+        ENV['HOME'] = tmp_dir
+        ex.call
+      ensure
+        ENV['HOME'] = original_home
+      end
+    end
+  end
+end

data/rspec-core/spec/support/matchers.rb

@@ -0,0 +1,103 @@
+RSpec::Matchers.define :map_specs do |specs|
+  match do |autotest|
+    @specs = specs
+    @autotest = prepare(autotest)
+    autotest.test_files_for(@file) == specs
+  end
+
+  chain :to do |file|
+    @file = file
+  end
+
+  failure_message_for_should do
+    "expected #{@autotest.class} to map #{@specs.inspect} to #{@file.inspect}\ngot #{@actual.inspect}"
+  end
+
+  def prepare(autotest)
+    find_order = @specs.dup << @file
+    autotest.instance_exec { @find_order = find_order }
+    autotest
+  end
+end
+
+RSpec::Matchers.define :fail_with do |exception_klass|
+  match do |example|
+    failure_reason(example, exception_klass).nil?
+  end
+
+  failure_message_for_should do |example|
+    "expected example to fail with a #{exception_klass} exception, but #{failure_reason(example, exception_klass)}"
+  end
+
+  def failure_reason(example, exception_klass)
+    result = example.execution_result
+    case
+      when example.metadata[:pending] then "was pending"
+      when result.status != :failed then result.status
+      when !result.exception.is_a?(exception_klass) then "failed with a #{result.exception.class}"
+      else nil
+    end
+  end
+end
+
+RSpec::Matchers.define :pass do
+  match do |example|
+    failure_reason(example).nil?
+  end
+
+  failure_message_for_should do |example|
+    "expected example to pass, but #{failure_reason(example)}"
+  end
+
+  def failure_reason(example)
+    result = example.metadata[:execution_result]
+    case
+      when example.metadata[:pending] then "was pending"
+      when result.status != :passed then result.status
+      else nil
+    end
+  end
+end
+
+RSpec::Matchers.module_exec do
+  alias_method :have_failed_with, :fail_with
+  alias_method :have_passed, :pass
+end
+
+RSpec::Matchers.define :be_pending_with do |message|
+  match do |example|
+    example.pending? &&
+    example.execution_result.status == :pending &&
+    example.execution_result.pending_message == message
+  end
+
+  failure_message_for_should do |example|
+    "expected: example pending with #{message.inspect}\n     got: #{example.execution_result.pending_message.inspect}"
+  end
+end
+
+RSpec::Matchers.define :be_skipped_with do |message|
+  match do |example|
+    example.skipped? &&
+    example.pending? &&
+    example.execution_result.pending_message == message
+  end
+
+  failure_message_for_should do |example|
+    "expected: example skipped with #{message.inspect}\n     got: #{example.execution_result.pending_message.inspect}"
+  end
+end
+
+RSpec::Matchers.define :contain_files do |*expected_files|
+  contain_exactly_matcher = RSpec::Matchers::BuiltIn::ContainExactly.new(expected_files.map { |f| File.expand_path(f) })
+
+  match do |actual_files|
+    files = actual_files.map { |f| File.expand_path(f) }
+    contain_exactly_matcher.matches?(files)
+  end
+
+  failure_message { contain_exactly_matcher.failure_message }
+  failure_message_when_negated { contain_exactly_matcher.failure_message_when_negated }
+end
+
+RSpec::Matchers.alias_matcher :a_file_collection, :contain_files

data/rspec-core/spec/support/mathn_integration_support.rb

@@ -0,0 +1,12 @@
+require 'rspec/support/spec/in_sub_process'
+
+module MathnIntegrationSupport
+  include RSpec::Support::InSubProcess
+
+  def with_mathn_loaded
+    in_sub_process do
+      require 'mathn'
+      yield
+    end
+  end
+end

data/rspec-core/spec/support/sandboxing.rb

@@ -0,0 +1,50 @@
+RSpec.configure do |c|
+  c.around { |ex| Sandboxing.sandboxed { ex.run } }
+end
+
+class NullObject
+  private
+  def method_missing(method, *args, &block)
+    # ignore
+  end
+end
+
+module Sandboxing
+  def self.sandboxed(&block)
+    orig_load_path = $LOAD_PATH.dup
+    orig_config = RSpec.configuration
+    orig_world  = RSpec.world
+    orig_example = RSpec.current_example
+    new_config = RSpec::Core::Configuration.new
+    new_config.expose_dsl_globally = false
+    new_config.expecting_with_rspec = true
+    new_world  = RSpec::Core::World.new(new_config)
+    RSpec.configuration = new_config
+    RSpec.world = new_world
+    object = Object.new
+    object.extend(RSpec::Core::SharedExampleGroup)
+
+    (class << RSpec::Core::ExampleGroup; self; end).class_exec do
+      alias_method :orig_run, :run
+      def run(reporter=nil)
+        RSpec.current_example = nil
+        orig_run(reporter || NullObject.new)
+      end
+    end
+
+    RSpec::Mocks.with_temporary_scope do
+      object.instance_exec(&block)
+    end
+  ensure
+    (class << RSpec::Core::ExampleGroup; self; end).class_exec do
+      remove_method :run
+      alias_method :run, :orig_run
+      remove_method :orig_run
+    end
+
+    RSpec.configuration = orig_config
+    RSpec.world = orig_world
+    RSpec.current_example = orig_example
+    $LOAD_PATH.replace(orig_load_path)
+  end
+end

data/rspec-core/spec/support/shared_example_groups.rb

@@ -0,0 +1,43 @@
+RSpec.shared_examples_for "metadata hash builder" do
+  let(:hash) { metadata_hash(:foo, :bar, :bazz => 23) }
+
+  it 'treats symbols as metadata keys with a true value' do
+    expect(hash[:foo]).to be(true)
+    expect(hash[:bar]).to be(true)
+  end
+
+  it 'still processes hash values normally' do
+    expect(hash[:bazz]).to be(23)
+  end
+end
+
+RSpec.shared_examples_for "handling symlinked directories when loading spec files" do
+  include_context "isolated directory"
+  let(:project_dir) { Dir.getwd }
+
+  it "finds the files" do
+    foos_dir = File.join(project_dir, "spec/foos")
+    FileUtils.mkdir_p foos_dir
+    FileUtils.touch(File.join(foos_dir, "foo_spec.rb"))
+
+    bars_dir = File.join(Dir.tmpdir, "shared/spec/bars")
+    FileUtils.mkdir_p bars_dir
+    FileUtils.touch(File.join(bars_dir, "bar_spec.rb"))
+
+    FileUtils.ln_s bars_dir, File.join(project_dir, "spec/bars")
+
+    expect(loaded_files).to contain_files(
+      "spec/bars/bar_spec.rb",
+      "spec/foos/foo_spec.rb"
+    )
+  end
+
+  it "works on a more complicated example (issue 1113)" do
+    FileUtils.mkdir_p("subtrees/DD/spec")
+    FileUtils.mkdir_p("spec/lib")
+    FileUtils.touch("subtrees/DD/spec/dd_foo_spec.rb")
+    FileUtils.ln_s(File.join(project_dir, "subtrees/DD/spec"), "spec/lib/DD")
+
+    expect(loaded_files).to contain_files("spec/lib/DD/dd_foo_spec.rb")
+  end
+end

data/rspec-core/spec/support/spec_files.rb

@@ -0,0 +1,44 @@
+RSpec.shared_context "spec files" do
+  def failing_spec_filename
+    @failing_spec_filename ||= File.expand_path(File.dirname(__FILE__)) + "/_failing_spec.rb"
+  end
+
+  def passing_spec_filename
+    @passing_spec_filename ||= File.expand_path(File.dirname(__FILE__)) + "/_passing_spec.rb"
+  end
+
+  def create_passing_spec_file
+    File.open(passing_spec_filename, 'w') do |f|
+      f.write %q{
+        RSpec.describe "passing spec" do
+          it "passes" do
+            expect(1).to eq(1)
+          end
+        end
+      }
+    end
+  end
+
+  def create_failing_spec_file
+    File.open(failing_spec_filename, 'w') do |f|
+      f.write %q{
+        RSpec.describe "failing spec" do
+          it "fails" do
+            expect(1).to eq(2)
+          end
+        end
+      }
+    end
+  end
+
+  before(:all) do
+    create_passing_spec_file
+    create_failing_spec_file
+  end
+
+  after(:all) do
+    File.delete(passing_spec_filename)
+    File.delete(failing_spec_filename)
+  end
+
+end

data/rspec-expectations/benchmarks/2.x_vs_3.x_matcher_dsl_implementation.rb

@@ -0,0 +1,253 @@
+$LOAD_PATH.unshift "./lib"
+require 'benchmark'
+require 'rspec/expectations'
+
+include RSpec::Expectations
+include RSpec::Matchers
+
+n = 1000
+
+puts "3 runs of #{n} times for each example running rspec-expectations #{RSpec::Expectations::Version::STRING} -- #{RUBY_ENGINE}/#{RUBY_VERSION}"
+
+puts "Defining a custom matcher"
+Benchmark.benchmark do |bm|
+  3.times do |i|
+    bm.report do
+      n.times do |j|
+        RSpec::Matchers.define :"define_matcher_#{i}_#{j}" do
+          match { }
+        end
+      end
+    end
+  end
+end
+
+puts "Getting an instance of a custom matcher"
+RSpec::Matchers.define :be_a_multiple_of do |x|
+  match { |actual| (actual % x).zero? }
+end
+
+Benchmark.benchmark do |bm|
+  3.times do
+    bm.report do
+      n.times do |i|
+        be_a_multiple_of(i)
+      end
+    end
+  end
+end
+
+puts "Using a previously gotten custom matcher instance -- positive match"
+Benchmark.benchmark do |bm|
+  1.upto(3) do |i|
+    matcher = be_a_multiple_of(i)
+    bm.report do
+      n.times do |j|
+        expect(i * j).to matcher
+      end
+    end
+  end
+end
+
+puts "Using a previously gotten custom matcher instance -- negative match"
+Benchmark.benchmark do |bm|
+  2.upto(4) do |i|
+    matcher = be_a_multiple_of(i)
+    bm.report do
+      n.times do |j|
+        begin
+          expect(1 + i * j).to matcher
+        rescue RSpec::Expectations::ExpectationNotMetError
+        end
+      end
+    end
+  end
+end
+
+=begin
+
+Results are below for:
+
+- MRI 2.0.0, MRI 1.9.3, JRuby 1.7.4
+- Against 2.14.3, 3.0.0.pre before matcher DSL rewrite, 3.0.0.pre after matcher DSL rewrite
+
+Conclusions:
+
+* Getting an instance of a custom matcher was insanely slow in 2.x,
+  and it looks like the `making_declared_methods_public` hack for 1.8.6
+  was the primary source of that. Without that, getting an instance of
+  a matcher is ~20x faster. To see what changed between 2.14.3 and
+  the commit used for this benchmark, go to:
+  https://github.com/rspec/rspec-expectations/compare/v2.14.3...4c47e4c43ee6961c755d325e73181b1f5b6bf097#diff-a51020971ade2c87f1d5b93f20d711c7L6
+* With our new custom matcher DSL, using a matcher is approximately
+  the same perf. However, defining a matcher is a little bit faster,
+  and getting an instance of an already defined matcher is about 10x faster.
+
+Overall, this is definitely a net win.
+
+Results:
+
+3 runs of 1000 times for each example running rspec-expectations 2.14.3 -- ruby/2.0.0
+Defining a custom matcher
+   0.010000   0.000000   0.010000 (  0.004612)
+   0.000000   0.000000   0.000000 (  0.004674)
+   0.000000   0.000000   0.000000 (  0.004944)
+Getting an instance of a custom matcher
+   1.470000   0.010000   1.480000 (  1.472602)
+   1.420000   0.000000   1.420000 (  1.426760)
+   1.440000   0.000000   1.440000 (  1.442283)
+Using a previously gotten custom matcher instance -- positive match
+   0.000000   0.000000   0.000000 (  0.002213)
+   0.000000   0.000000   0.000000 (  0.002019)
+   0.000000   0.000000   0.000000 (  0.001884)
+Using a previously gotten custom matcher instance -- negative match
+   0.020000   0.000000   0.020000 (  0.019378)
+   0.030000   0.000000   0.030000 (  0.027001)
+   0.020000   0.010000   0.030000 (  0.022310)
+
+3 runs of 1000 times for each example running rspec-expectations 2.14.3 -- ruby/1.9.3
+Defining a custom matcher
+    0.000000   0.000000   0.000000 (  0.004455)
+   0.010000   0.000000   0.010000 (  0.004849)
+   0.010000   0.000000   0.010000 (  0.010495)
+Getting an instance of a custom matcher
+    1.690000   0.010000   1.700000 (  1.696415)
+   1.550000   0.000000   1.550000 (  1.556858)
+   1.550000   0.000000   1.550000 (  1.554830)
+Using a previously gotten custom matcher instance -- positive match
+    0.000000   0.000000   0.000000 (  0.002161)
+   0.000000   0.000000   0.000000 (  0.002038)
+   0.010000   0.000000   0.010000 (  0.002091)
+Using a previously gotten custom matcher instance -- negative match
+    0.050000   0.010000   0.060000 (  0.060512)
+   0.050000   0.000000   0.050000 (  0.064532)
+   0.060000   0.010000   0.070000 (  0.062206)
+
+3 runs of 1000 times for each example running rspec-expectations 2.14.3 -- jruby/1.9.3
+Defining a custom matcher
+    0.660000   0.010000   0.670000 (  0.299000)
+   0.280000   0.000000   0.280000 (  0.178000)
+   0.220000   0.010000   0.230000 (  0.143000)
+Getting an instance of a custom matcher
+    1.970000   0.030000   2.000000 (  1.389000)
+   1.340000   0.030000   1.370000 (  0.907000)
+   0.820000   0.030000   0.850000 (  0.795000)
+Using a previously gotten custom matcher instance -- positive match
+    0.110000   0.000000   0.110000 (  0.058000)
+   0.050000   0.000000   0.050000 (  0.036000)
+   0.030000   0.000000   0.030000 (  0.030000)
+Using a previously gotten custom matcher instance -- negative match
+    0.930000   0.010000   0.940000 (  0.474000)
+   0.620000   0.000000   0.620000 (  0.376000)
+   0.390000   0.000000   0.390000 (  0.279000)
+
+3 runs of 1000 times for each example running rspec-expectations 3.0.0.pre (before DSL rewrite) -- ruby/2.0.0
+Defining a custom matcher
+   0.010000   0.000000   0.010000 (  0.004719)
+   0.000000   0.000000   0.000000 (  0.004424)
+   0.010000   0.000000   0.010000 (  0.005562)
+Getting an instance of a custom matcher
+   0.050000   0.000000   0.050000 (  0.059949)
+   0.060000   0.000000   0.060000 (  0.058208)
+   0.060000   0.010000   0.070000 (  0.067402)
+Using a previously gotten custom matcher instance -- positive match
+   0.010000   0.000000   0.010000 (  0.001696)
+   0.000000   0.000000   0.000000 (  0.001558)
+   0.000000   0.000000   0.000000 (  0.001488)
+Using a previously gotten custom matcher instance -- negative match
+   0.020000   0.000000   0.020000 (  0.021522)
+   0.030000   0.000000   0.030000 (  0.027728)
+   0.020000   0.000000   0.020000 (  0.026185)
+
+3 runs of 1000 times for each example running rspec-expectations 3.0.0.pre (before DSL rewrite) -- ruby/1.9.3
+Defining a custom matcher
+    0.010000   0.000000   0.010000 (  0.004650)
+   0.000000   0.000000   0.000000 (  0.004658)
+   0.010000   0.000000   0.010000 (  0.011111)
+Getting an instance of a custom matcher
+    0.050000   0.010000   0.060000 (  0.047230)
+   0.060000   0.000000   0.060000 (  0.065500)
+   0.070000   0.000000   0.070000 (  0.073099)
+Using a previously gotten custom matcher instance -- positive match
+    0.000000   0.000000   0.000000 (  0.002007)
+   0.000000   0.000000   0.000000 (  0.002370)
+   0.010000   0.000000   0.010000 (  0.002121)
+Using a previously gotten custom matcher instance -- negative match
+    0.070000   0.010000   0.080000 (  0.078960)
+   0.060000   0.000000   0.060000 (  0.061351)
+   0.060000   0.000000   0.060000 (  0.069949)
+
+3 runs of 1000 times for each example running rspec-expectations 3.0.0.pre (before DSL rewrite) -- jruby/1.9.3
+Defining a custom matcher
+    0.730000   0.010000   0.740000 (  0.303000)
+   0.240000   0.010000   0.250000 (  0.153000)
+   0.210000   0.000000   0.210000 (  0.140000)
+Getting an instance of a custom matcher
+    0.940000   0.010000   0.950000 (  0.538000)
+   0.510000   0.000000   0.510000 (  0.174000)
+   0.160000   0.000000   0.160000 (  0.090000)
+Using a previously gotten custom matcher instance -- positive match
+    0.120000   0.000000   0.120000 (  0.053000)
+   0.040000   0.000000   0.040000 (  0.025000)
+   0.030000   0.000000   0.030000 (  0.026000)
+Using a previously gotten custom matcher instance -- negative match
+    0.970000   0.010000   0.980000 (  0.458000)
+   0.480000   0.010000   0.490000 (  0.314000)
+   0.360000   0.000000   0.360000 (  0.269000)
+
+3 runs of 1000 times for each example running rspec-expectations 3.0.0.pre -- ruby/2.0.0
+Defining a custom matcher
+   0.000000   0.000000   0.000000 (  0.003138)
+   0.000000   0.000000   0.000000 (  0.003083)
+   0.010000   0.000000   0.010000 (  0.003448)
+Getting an instance of a custom matcher
+   0.000000   0.000000   0.000000 (  0.007273)
+   0.010000   0.000000   0.010000 (  0.007096)
+   0.020000   0.000000   0.020000 (  0.021662)
+Using a previously gotten custom matcher instance -- positive match
+   0.000000   0.000000   0.000000 (  0.002582)
+   0.000000   0.000000   0.000000 (  0.001832)
+   0.010000   0.000000   0.010000 (  0.001588)
+Using a previously gotten custom matcher instance -- negative match
+   0.010000   0.000000   0.010000 (  0.017756)
+   0.030000   0.000000   0.030000 (  0.021225)
+   0.020000   0.010000   0.030000 (  0.021281)
+
+3 runs of 1000 times for each example running rspec-expectations 3.0.0.pre -- ruby/1.9.3
+Defining a custom matcher
+    0.000000   0.000000   0.000000 (  0.002903)
+   0.000000   0.000000   0.000000 (  0.002919)
+   0.010000   0.000000   0.010000 (  0.008956)
+Getting an instance of a custom matcher
+    0.010000   0.000000   0.010000 (  0.006640)
+   0.000000   0.000000   0.000000 (  0.006557)
+   0.010000   0.000000   0.010000 (  0.007869)
+Using a previously gotten custom matcher instance -- positive match
+    0.010000   0.000000   0.010000 (  0.003332)
+   0.000000   0.000000   0.000000 (  0.003288)
+   0.000000   0.000000   0.000000 (  0.002769)
+Using a previously gotten custom matcher instance -- negative match
+    0.070000   0.010000   0.080000 (  0.075547)
+   0.050000   0.000000   0.050000 (  0.053149)
+   0.060000   0.010000   0.070000 (  0.062583)
+
+3 runs of 1000 times for each example running rspec-expectations 3.0.0.pre -- jruby/1.9.3
+Defining a custom matcher
+    0.780000   0.020000   0.800000 (  0.316000)
+   0.170000   0.010000   0.180000 (  0.139000)
+   0.220000   0.000000   0.220000 (  0.135000)
+Getting an instance of a custom matcher
+    0.340000   0.000000   0.340000 (  0.183000)
+   0.230000   0.010000   0.240000 (  0.131000)
+   0.180000   0.000000   0.180000 (  0.104000)
+Using a previously gotten custom matcher instance -- positive match
+    0.170000   0.000000   0.170000 (  0.076000)
+   0.070000   0.000000   0.070000 (  0.049000)
+   0.110000   0.000000   0.110000 (  0.047000)
+Using a previously gotten custom matcher instance -- negative match
+    0.970000   0.010000   0.980000 (  0.461000)
+   0.410000   0.000000   0.410000 (  0.316000)
+   0.350000   0.010000   0.360000 (  0.256000)
+
+=end
+