opal-rspec 0.7.0.rc.1 → 0.7.0.rc.2

data/rspec-core/upstream/features/metadata/current_example.feature

@@ -0,0 +1,57 @@
+Feature: current example
+
+  You can reference the example object, and access its metadata, using the block
+  argument provided to: `it`, `subject`, `let`, and the `before`, `after`, and
+  `around` hooks.
+
+  Scenario: Access the `example` object from within an example
+    Given a file named "spec/example_spec.rb" with:
+      """ruby
+      RSpec.describe "example as block arg to it, before, and after" do
+        before do |example|
+          expect(example.description).to eq("is the example object")
+        end
+
+        after do |example|
+          expect(example.description).to eq("is the example object")
+        end
+
+        it "is the example object" do |example|
+          expect(example.description).to eq("is the example object")
+        end
+      end
+
+      RSpec.describe "example as block arg to let" do
+        let(:the_description) do |example|
+          example.description
+        end
+
+        it "is the example object" do |example|
+          expect(the_description).to eq("is the example object")
+        end
+      end
+
+      RSpec.describe "example as block arg to subject" do
+        subject do |example|
+          example.description
+        end
+
+        it "is the example object" do |example|
+          expect(subject).to eq("is the example object")
+        end
+      end
+
+      RSpec.describe "example as block arg to subject with a name" do
+        subject(:the_subject) do |example|
+          example.description
+        end
+
+        it "is the example object" do |example|
+          expect(the_subject).to eq("is the example object")
+          expect(subject).to eq("is the example object")
+        end
+      end
+      """
+    When I run `rspec spec/example_spec.rb`
+    Then the example should pass
+

data/rspec-core/upstream/features/metadata/described_class.feature

@@ -0,0 +1,17 @@
+Feature: described class
+
+  If the first argument to the outermost example group is a class, the class is
+  exposed to each example via the `described_class()` method.
+
+  Scenario: Access the described class from the example
+    Given a file named "spec/example_spec.rb" with:
+      """ruby
+      RSpec.describe Fixnum do
+        it "is available as described_class" do
+          expect(described_class).to eq(Fixnum)
+        end
+      end
+      """
+    When I run `rspec spec/example_spec.rb`
+    Then the example should pass
+

data/rspec-core/upstream/features/metadata/user_defined.feature

@@ -0,0 +1,100 @@
+Feature: User-defined metadata
+
+  You can attach user-defined metadata to any example group or example. Pass a
+  hash as the last argument (before the block) to `describe`, `context` or `it`.
+  RSpec supports many configuration options that apply only to certain examples
+  or groups based on the metadata.
+
+  Metadata defined on an example group is available (and can be overridden) by
+  any sub-group or from any example in that group or a sub-group.
+
+  In addition, you can specify metdata using just symbols. Each symbol passed
+  as an argument to `describe`, `context` or `it` will be a key in the metadata
+  hash, with a corresponding value of `true`.
+
+  Scenario: Define group metadata using a hash
+    Given a file named "define_group_metadata_with_hash_spec.rb" with:
+      """ruby
+      RSpec.describe "a group with user-defined metadata", :foo => 17 do
+        it 'has access to the metadata in the example' do |example|
+          expect(example.metadata[:foo]).to eq(17)
+        end
+
+        it 'does not have access to metadata defined on sub-groups' do |example|
+          expect(example.metadata).not_to include(:bar)
+        end
+
+        describe 'a sub-group with user-defined metadata', :bar => 12 do
+          it 'has access to the sub-group metadata' do |example|
+            expect(example.metadata[:foo]).to eq(17)
+          end
+
+          it 'also has access to metadata defined on parent groups' do |example|
+            expect(example.metadata[:bar]).to eq(12)
+          end
+        end
+      end
+      """
+    When I run `rspec define_group_metadata_with_hash_spec.rb`
+    Then the examples should all pass
+
+  Scenario: Define example metadata using a hash
+    Given a file named "define_example_metadata_with_hash_spec.rb" with:
+      """ruby
+      RSpec.describe "a group with no user-defined metadata" do
+        it 'has an example with metadata', :foo => 17 do |example|
+          expect(example.metadata[:foo]).to eq(17)
+          expect(example.metadata).not_to include(:bar)
+        end
+
+        it 'has another example with metadata', :bar => 12, :bazz => 33 do |example|
+          expect(example.metadata[:bar]).to eq(12)
+          expect(example.metadata[:bazz]).to eq(33)
+          expect(example.metadata).not_to include(:foo)
+        end
+      end
+      """
+    When I run `rspec define_example_metadata_with_hash_spec.rb`
+    Then the examples should all pass
+
+  Scenario: Override user-defined metadata
+    Given a file named "override_metadata_spec.rb" with:
+      """ruby
+      RSpec.describe "a group with user-defined metadata", :foo => 'bar' do
+        it 'can be overridden by an example', :foo => 'bazz' do |example|
+          expect(example.metadata[:foo]).to eq('bazz')
+        end
+
+        describe "a sub-group with an override", :foo => 'goo' do
+          it 'can be overridden by a sub-group' do |example|
+            expect(example.metadata[:foo]).to eq('goo')
+          end
+        end
+      end
+      """
+    When I run `rspec override_metadata_spec.rb`
+    Then the examples should all pass
+
+  Scenario: Less verbose metadata
+    Given a file named "less_verbose_metadata_spec.rb" with:
+      """ruby
+      RSpec.describe "a group with simple metadata", :fast, :simple, :bug => 73 do
+        it 'has `:fast => true` metadata' do |example|
+          expect(example.metadata[:fast]).to eq(true)
+        end
+
+        it 'has `:simple => true` metadata' do |example|
+          expect(example.metadata[:simple]).to eq(true)
+        end
+
+        it 'can still use a hash for metadata' do |example|
+          expect(example.metadata[:bug]).to eq(73)
+        end
+
+        it 'can define simple metadata on an example', :special do |example|
+          expect(example.metadata[:special]).to eq(true)
+        end
+      end
+      """
+    When I run `rspec less_verbose_metadata_spec.rb`
+    Then the examples should all pass

data/rspec-core/upstream/features/mock_framework_integration/use_any_framework.feature

@@ -0,0 +1,106 @@
+Feature: mock with an alternative framework
+
+  In addition to rspec, mocha, flexmock, and RR, you can choose an alternate
+  framework as the mocking framework. You (or the framework authors) just needs
+  to provide an adapter that hooks RSpec's events into those of the framework.
+
+  A mock framework adapter must expose three methods:
+
+  * `setup_mocks_for_rspec`
+    * called before each example is run
+  * `verify_mocks_for_rspec`
+    * called after each example is run
+    * this is where message expectation failures should result in an error with
+      the appropriate failure message
+  * `teardown_mocks_for_rspec`
+    * called after `verify_mocks_for_rspec`
+    * use this to clean up resources, restore objects to earlier state, etc
+    * guaranteed to run even if there are failures
+
+  Scenario: Mock with alternate framework
+    Given a file named "expector.rb" with:
+      """ruby
+      class Expector
+        class << self
+          def expectors
+            @expectors ||= []
+          end
+
+          def clear_expectors
+            expectors.clear
+          end
+
+          def verify_expectors
+            expectors.each {|d| d.verify}
+          end
+        end
+
+        def initialize
+          self.class.expectors << self
+        end
+
+        def expectations
+          @expectations ||= []
+        end
+
+        def expect(message)
+          expectations << message.to_s
+        end
+
+        def verify
+          unless expectations.empty?
+            raise expectations.map {|e|
+              "expected #{e}, but it was never received"
+            }.join("\n")
+          end
+        end
+
+      private
+
+        def method_missing(name, *args, &block)
+          expectations.delete(name.to_s)
+        end
+
+      public
+
+        module RSpecAdapter
+          def setup_mocks_for_rspec
+            # no setup necessary
+          end
+
+          def verify_mocks_for_rspec
+            Expector.verify_expectors
+          end
+
+          def teardown_mocks_for_rspec
+            Expector.clear_expectors
+          end
+        end
+      end
+      """
+
+    Given a file named "example_spec.rb" with:
+      """ruby
+      require File.expand_path("../expector", __FILE__)
+
+      RSpec.configure do |config|
+        config.mock_framework = Expector::RSpecAdapter
+      end
+
+      RSpec.describe Expector do
+        it "passes when message is received" do
+          expector = Expector.new
+          expector.expect(:foo)
+          expector.foo
+        end
+
+        it "fails when message is received" do
+          expector = Expector.new
+          expector.expect(:foo)
+        end
+      end
+      """
+    When I run `rspec example_spec.rb --format doc`
+    Then the exit status should be 1
+    And the output should contain "2 examples, 1 failure"
+    And the output should contain "fails when message is received (FAILED - 1)"

data/rspec-core/upstream/features/mock_framework_integration/use_flexmock.feature

@@ -0,0 +1,94 @@
+Feature: mock with flexmock
+
+  Configure RSpec to use flexmock as shown in the scenarios below.
+
+  Scenario: Passing message expectation
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :flexmock
+      end
+
+      RSpec.describe "mocking with Flexmock" do
+        it "passes when it should" do
+          receiver = flexmock('receiver')
+          receiver.should_receive(:message).once
+          receiver.message
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass
+
+  Scenario: Failing message expectation
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :flexmock
+      end
+
+      RSpec.describe "mocking with Flexmock" do
+        it "fails when it should" do
+          receiver = flexmock('receiver')
+          receiver.should_receive(:message).once
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 1 failure"
+
+  Scenario: Failing message expectation in pending example (remains pending)
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :flexmock
+      end
+
+      RSpec.describe "failed message expectation in a pending example" do
+        it "is listed as pending" do
+          pending
+          receiver = flexmock('receiver')
+          receiver.should_receive(:message).once
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 0 failures, 1 pending"
+    And the exit status should be 0
+
+  Scenario: Passing message expectation in pending example (fails)
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :flexmock
+      end
+
+      RSpec.describe "passing message expectation in a pending example" do
+        it "fails with FIXED" do
+          pending
+          receiver = flexmock('receiver')
+          receiver.should_receive(:message).once
+          receiver.message
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "FIXED"
+    Then the output should contain "1 example, 1 failure"
+    And the exit status should be 1
+
+  Scenario: Accessing `RSpec.configuration.mock_framework.framework_name`
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :flexmock
+      end
+
+      RSpec.describe "RSpec.configuration.mock_framework.framework_name" do
+        it "returns :flexmock" do
+          expect(RSpec.configuration.mock_framework.framework_name).to eq(:flexmock)
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass

data/rspec-core/upstream/features/mock_framework_integration/use_mocha.feature

@@ -0,0 +1,95 @@
+Feature: mock with mocha
+
+  Configure RSpec to use mocha as shown in the scenarios below.
+
+  Scenario: Passing message expectation
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :mocha
+      end
+
+      RSpec.describe "mocking with RSpec" do
+        it "passes when it should" do
+          receiver = mock('receiver')
+          receiver.expects(:message).once
+          receiver.message
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass
+
+  Scenario: Failing message expectation
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :mocha
+      end
+
+      RSpec.describe "mocking with RSpec" do
+        it "fails when it should" do
+          receiver = mock('receiver')
+          receiver.expects(:message).once
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 1 failure"
+
+  Scenario: Failing message expectation in pending example (remains pending)
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :mocha
+      end
+
+      RSpec.describe "failed message expectation in a pending example" do
+        it "is listed as pending" do
+          pending
+          receiver = mock('receiver')
+          receiver.expects(:message).once
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "1 example, 0 failures, 1 pending"
+    And the exit status should be 0
+
+  Scenario: Passing message expectation in pending example (fails)
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :mocha
+      end
+
+      RSpec.describe "passing message expectation in a pending example" do
+        it "fails with FIXED" do
+          pending
+          receiver = mock('receiver')
+          receiver.expects(:message).once
+          receiver.message
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "FIXED"
+    Then the output should contain "1 example, 1 failure"
+    And the exit status should be 1
+
+  Scenario: Accessing `RSpec.configuration.mock_framework.framework_name`
+    Given a file named "example_spec.rb" with:
+      """ruby
+      RSpec.configure do |config|
+        config.mock_framework = :mocha
+      end
+
+      RSpec.describe "RSpec.configuration.mock_framework.framework_name" do
+        it "returns :mocha" do
+          expect(RSpec.configuration.mock_framework.framework_name).to eq(:mocha)
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass
+