rspec-core 2.0.0.a1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (143) hide show
  1. data/.document +5 -0
  2. data/.gitignore +7 -0
  3. data/.treasure_map.rb +23 -0
  4. data/License.txt +22 -0
  5. data/README.markdown +9 -0
  6. data/Rakefile +76 -0
  7. data/TODO.markdown +16 -0
  8. data/VERSION +1 -0
  9. data/VERSION.yml +5 -0
  10. data/bin/rspec +12 -0
  11. data/cucumber.yml +2 -0
  12. data/example_specs/failing/README.txt +7 -0
  13. data/example_specs/failing/diffing_spec.rb +36 -0
  14. data/example_specs/failing/failing_implicit_docstrings_example.rb +19 -0
  15. data/example_specs/failing/failure_in_after.rb +10 -0
  16. data/example_specs/failing/failure_in_before.rb +10 -0
  17. data/example_specs/failing/mocking_example.rb +40 -0
  18. data/example_specs/failing/mocking_with_flexmock.rb +26 -0
  19. data/example_specs/failing/mocking_with_mocha.rb +25 -0
  20. data/example_specs/failing/mocking_with_rr.rb +27 -0
  21. data/example_specs/failing/partial_mock_example.rb +20 -0
  22. data/example_specs/failing/pending_example.rb +9 -0
  23. data/example_specs/failing/predicate_example.rb +34 -0
  24. data/example_specs/failing/raising_example.rb +47 -0
  25. data/example_specs/failing/spec_helper.rb +3 -0
  26. data/example_specs/failing/syntax_error_example.rb +7 -0
  27. data/example_specs/failing/team_spec.rb +44 -0
  28. data/example_specs/failing/timeout_behaviour.rb +7 -0
  29. data/example_specs/passing/custom_formatter.rb +12 -0
  30. data/example_specs/passing/custom_matchers.rb +54 -0
  31. data/example_specs/passing/dynamic_spec.rb +9 -0
  32. data/example_specs/passing/file_accessor.rb +19 -0
  33. data/example_specs/passing/file_accessor_spec.rb +38 -0
  34. data/example_specs/passing/filtered_formatter.rb +18 -0
  35. data/example_specs/passing/filtered_formatter_example.rb +31 -0
  36. data/example_specs/passing/greeter_spec.rb +31 -0
  37. data/example_specs/passing/helper_method_example.rb +14 -0
  38. data/example_specs/passing/implicit_docstrings_example.rb +18 -0
  39. data/example_specs/passing/io_processor.rb +8 -0
  40. data/example_specs/passing/io_processor_spec.rb +21 -0
  41. data/example_specs/passing/mocking_example.rb +27 -0
  42. data/example_specs/passing/multi_threaded_example_group_runner.rb +26 -0
  43. data/example_specs/passing/nested_classes_example.rb +36 -0
  44. data/example_specs/passing/options_example.rb +31 -0
  45. data/example_specs/passing/options_formatter.rb +20 -0
  46. data/example_specs/passing/partial_mock_example.rb +29 -0
  47. data/example_specs/passing/pending_example.rb +20 -0
  48. data/example_specs/passing/predicate_example.rb +27 -0
  49. data/example_specs/passing/shared_example_group_example.rb +81 -0
  50. data/example_specs/passing/shared_stack_examples.rb +36 -0
  51. data/example_specs/passing/simple_matcher_example.rb +31 -0
  52. data/example_specs/passing/spec_helper.rb +14 -0
  53. data/example_specs/passing/stack.rb +36 -0
  54. data/example_specs/passing/stack_spec.rb +64 -0
  55. data/example_specs/passing/stack_spec_with_nested_example_groups.rb +67 -0
  56. data/example_specs/passing/stubbing_example.rb +69 -0
  57. data/example_specs/passing/yielding_example.rb +33 -0
  58. data/example_specs/ruby1.9.compatibility/access_to_constants_spec.rb +85 -0
  59. data/features-pending/command_line/line_number_option.feature +56 -0
  60. data/features-pending/command_line/line_number_option_with_example_with_no_name.feature +22 -0
  61. data/features-pending/example_groups/example_group_with_should_methods.feature +29 -0
  62. data/features-pending/example_groups/implicit_docstrings.feature +59 -0
  63. data/features-pending/example_groups/nested_groups.feature +32 -0
  64. data/features-pending/expectations/expect_change.feature +65 -0
  65. data/features-pending/expectations/expect_error.feature +44 -0
  66. data/features-pending/extensions/custom_example_group.feature +19 -0
  67. data/features-pending/formatters/custom_formatter.feature +30 -0
  68. data/features-pending/heckle/heckle.feature +56 -0
  69. data/features-pending/interop/examples_and_tests_together.feature +80 -0
  70. data/features-pending/interop/rspec_output.feature +25 -0
  71. data/features-pending/interop/test_but_not_test_unit.feature +26 -0
  72. data/features-pending/interop/test_case_with_should_methods.feature +46 -0
  73. data/features-pending/matchers/define_diffable_matcher.feature +26 -0
  74. data/features-pending/matchers/define_matcher.feature +179 -0
  75. data/features-pending/matchers/define_matcher_with_fluent_interface.feature +27 -0
  76. data/features-pending/mocks/mix_stubs_and_mocks.feature +22 -0
  77. data/features-pending/mocks/stub_implementation.feature +26 -0
  78. data/features-pending/pending/pending_examples.feature +81 -0
  79. data/features-pending/runner/specify_line_number.feature +32 -0
  80. data/features/before_and_after_blocks/before_and_after_blocks.feature +169 -0
  81. data/features/expectations/customized_message.feature +54 -0
  82. data/features/matchers/define_matcher_outside_rspec.feature +39 -0
  83. data/features/mock_framework_integration/use_flexmock.feature +23 -0
  84. data/features/mock_framework_integration/use_mocha.feature +23 -0
  85. data/features/mock_framework_integration/use_rr.feature +23 -0
  86. data/features/mock_framework_integration/use_rspec.feature +23 -0
  87. data/features/step_definitions/running_rspec_steps.rb +35 -0
  88. data/features/subject/explicit_subject.feature +31 -0
  89. data/features/subject/implicit_subject.feature +31 -0
  90. data/features/support/env.rb +82 -0
  91. data/features/support/matchers/smart_match.rb +14 -0
  92. data/lib/rspec/autorun.rb +2 -0
  93. data/lib/rspec/core.rb +38 -0
  94. data/lib/rspec/core/backward_compatibility.rb +9 -0
  95. data/lib/rspec/core/command_line_options.rb +60 -0
  96. data/lib/rspec/core/configuration.rb +222 -0
  97. data/lib/rspec/core/deprecation.rb +47 -0
  98. data/lib/rspec/core/example.rb +113 -0
  99. data/lib/rspec/core/example_group.rb +239 -0
  100. data/lib/rspec/core/example_group_subject.rb +77 -0
  101. data/lib/rspec/core/formatters.rb +16 -0
  102. data/lib/rspec/core/formatters/base_formatter.rb +123 -0
  103. data/lib/rspec/core/formatters/base_text_formatter.rb +139 -0
  104. data/lib/rspec/core/formatters/documentation_formatter.rb +84 -0
  105. data/lib/rspec/core/formatters/progress_formatter.rb +36 -0
  106. data/lib/rspec/core/kernel_extensions.rb +15 -0
  107. data/lib/rspec/core/mocking/with_absolutely_nothing.rb +13 -0
  108. data/lib/rspec/core/mocking/with_flexmock.rb +25 -0
  109. data/lib/rspec/core/mocking/with_mocha.rb +22 -0
  110. data/lib/rspec/core/mocking/with_rr.rb +26 -0
  111. data/lib/rspec/core/mocking/with_rspec.rb +21 -0
  112. data/lib/rspec/core/rake_task.rb +88 -0
  113. data/lib/rspec/core/runner.rb +66 -0
  114. data/lib/rspec/core/shared_behaviour.rb +41 -0
  115. data/lib/rspec/core/shared_behaviour_kernel_extensions.rb +31 -0
  116. data/lib/rspec/core/version.rb +16 -0
  117. data/lib/rspec/core/world.rb +105 -0
  118. data/rspec-core.gemspec +204 -0
  119. data/script/console +8 -0
  120. data/spec/resources/example_classes.rb +67 -0
  121. data/spec/rspec/core/command_line_options_spec.rb +63 -0
  122. data/spec/rspec/core/configuration_spec.rb +171 -0
  123. data/spec/rspec/core/example_group_spec.rb +351 -0
  124. data/spec/rspec/core/example_group_subject_spec.rb +67 -0
  125. data/spec/rspec/core/example_spec.rb +67 -0
  126. data/spec/rspec/core/formatters/base_formatter_spec.rb +105 -0
  127. data/spec/rspec/core/formatters/documentation_formatter_spec.rb +5 -0
  128. data/spec/rspec/core/formatters/progress_formatter_spec.rb +29 -0
  129. data/spec/rspec/core/kernel_extensions_spec.rb +13 -0
  130. data/spec/rspec/core/mocha_spec.rb +29 -0
  131. data/spec/rspec/core/resources/a_bar.rb +0 -0
  132. data/spec/rspec/core/resources/a_foo.rb +0 -0
  133. data/spec/rspec/core/resources/a_spec.rb +1 -0
  134. data/spec/rspec/core/resources/custom_example_group_runner.rb +14 -0
  135. data/spec/rspec/core/resources/example_classes.rb +67 -0
  136. data/spec/rspec/core/resources/utf8_encoded.rb +8 -0
  137. data/spec/rspec/core/runner_spec.rb +34 -0
  138. data/spec/rspec/core/shared_behaviour_spec.rb +185 -0
  139. data/spec/rspec/core/world_spec.rb +167 -0
  140. data/spec/rspec/core_spec.rb +35 -0
  141. data/spec/ruby_forker.rb +13 -0
  142. data/spec/spec_helper.rb +72 -0
  143. metadata +219 -0
@@ -0,0 +1,27 @@
1
+ Feature: define matcher
2
+
3
+ In order to express my domain clearly in my code examples
4
+ As an RSpec user
5
+ I want to define matchers with fluent interfaces
6
+
7
+ Scenario: one additional method
8
+ Given a file named "between_spec.rb" with:
9
+ """
10
+ Rspec::Matchers.define :be_bigger_than do |first|
11
+ def but_smaller_than(second)
12
+ @second = second
13
+ self
14
+ end
15
+
16
+ match do |actual|
17
+ (actual > first) && (actual < @second)
18
+ end
19
+ end
20
+
21
+ describe 5 do
22
+ it { should be_bigger_than(4).but_smaller_than(6) }
23
+ end
24
+ """
25
+ When I run "spec between_spec.rb --format specdoc"
26
+ Then the stdout should match "1 example, 0 failures"
27
+ And the stdout should match "should be bigger than 4"
@@ -0,0 +1,22 @@
1
+ Feature: Spec and test together
2
+
3
+ As an RSpec user
4
+ I want to use stubs and mocks together
5
+
6
+ Scenario: stub in before
7
+ Given a file named "stub_and_mocks_spec.rb" with:
8
+ """
9
+ describe "a stub in before" do
10
+ before(:each) do
11
+ @messenger = mock('messenger').as_null_object
12
+ end
13
+
14
+ it "a" do
15
+ @messenger.should_receive(:foo).with('first')
16
+ @messenger.foo('second')
17
+ @messenger.foo('third')
18
+ end
19
+ end
20
+ """
21
+ When I run "spec stub_and_mocks_spec.rb --format nested"
22
+ Then the stdout should match "expected :foo with (\"first\") but received it with ([\"second\"], [\"third\"])"
@@ -0,0 +1,26 @@
1
+ Feature: stub implementation
2
+
3
+ As an rspec user, I want to stub a complete implementation, not just a
4
+ return value.
5
+
6
+ Scenario: stub implementation
7
+ Given a file named "stub_implementation.rb" with:
8
+ """
9
+ describe "a stubbed implementation" do
10
+ it "works" do
11
+ object = Object.new
12
+ object.stub(:foo) do |arg|
13
+ if arg == :this
14
+ "got this"
15
+ elsif arg == :that
16
+ "got that"
17
+ end
18
+ end
19
+
20
+ object.foo(:this).should == "got this"
21
+ object.foo(:that).should == "got that"
22
+ end
23
+ end
24
+ """
25
+ When I run "spec stub_implementation.rb"
26
+ Then the stdout should match "1 example, 0 failures"
@@ -0,0 +1,81 @@
1
+ Feature: pending examples
2
+
3
+ RSpec offers three ways to indicate that an example is disabled pending
4
+ some action.
5
+
6
+ Scenario: pending implementation
7
+ Given a file named "example_without_block_spec.rb" with:
8
+ """
9
+ describe "an example" do
10
+ it "has not yet been implemented"
11
+ end
12
+ """
13
+ When I run "spec example_without_block_spec.rb"
14
+ Then the exit code should be 0
15
+ And the stdout should match "1 example, 0 failures, 1 pending"
16
+ And the stdout should match "Not Yet Implemented"
17
+ And the stdout should match "example_without_block_spec.rb:2"
18
+
19
+ Scenario: pending implementation with spec/test/unit
20
+ Given a file named "example_without_block_spec.rb" with:
21
+ """
22
+ require 'spec/test/unit'
23
+ describe "an example" do
24
+ it "has not yet been implemented"
25
+ end
26
+ """
27
+ When I run "spec example_without_block_spec.rb"
28
+ Then the exit code should be 0
29
+ And the stdout should match "1 example, 0 failures, 1 pending"
30
+ And the stdout should match "Not Yet Implemented"
31
+ And the stdout should match "example_without_block_spec.rb:3"
32
+
33
+ Scenario: pending any arbitary reason, with no block
34
+ Given a file named "pending_without_block_spec.rb" with:
35
+ """
36
+ describe "an example" do
37
+ it "is implemented but waiting" do
38
+ pending("something else getting finished")
39
+ end
40
+ end
41
+ """
42
+ When I run "spec pending_without_block_spec.rb"
43
+ Then the exit code should be 0
44
+ And the stdout should match "1 example, 0 failures, 1 pending"
45
+ And the stdout should match "(something else getting finished)"
46
+ And the stdout should match "pending_without_block_spec.rb:2"
47
+
48
+ Scenario: pending any arbitary reason, with a block that fails
49
+ Given a file named "pending_with_failing_block_spec.rb" with:
50
+ """
51
+ describe "an example" do
52
+ it "is implemented but waiting" do
53
+ pending("something else getting finished") do
54
+ raise "this is the failure"
55
+ end
56
+ end
57
+ end
58
+ """
59
+ When I run "spec pending_with_failing_block_spec.rb"
60
+ Then the exit code should be 0
61
+ And the stdout should match "1 example, 0 failures, 1 pending"
62
+ And the stdout should match "(something else getting finished)"
63
+ And the stdout should match "pending_with_failing_block_spec.rb:2"
64
+
65
+ Scenario: pending any arbitary reason, with a block that passes
66
+ Given a file named "pending_with_passing_block_spec.rb" with:
67
+ """
68
+ describe "an example" do
69
+ it "is implemented but waiting" do
70
+ pending("something else getting finished") do
71
+ true.should be(true)
72
+ end
73
+ end
74
+ end
75
+ """
76
+ When I run "spec pending_with_passing_block_spec.rb"
77
+ Then the exit code should be 256
78
+ And the stdout should match "1 example, 1 failure"
79
+ And the stdout should match "FIXED"
80
+ And the stdout should match "Expected pending 'something else getting finished' to fail. No Error was raised."
81
+ And the stdout should match "pending_with_passing_block_spec.rb:3"
@@ -0,0 +1,32 @@
1
+ Feature: run specific examples by line number
2
+
3
+ In order to run a single example from command line
4
+ RSpec allows you to specify the line number of the example(s) to run
5
+
6
+ Scenario: --line syntax on single example
7
+ Given a file named "example_spec.rb" with:
8
+ """
9
+ describe "an example" do
10
+ it "has not yet been implemented"
11
+ it "has been implemented" do
12
+ true
13
+ end
14
+ end
15
+ """
16
+ When I run "spec example_spec.rb --line 2"
17
+ Then the stdout should match "1 example, 0 failures, 1 pending"
18
+ And the stdout should match "example_spec.rb:2"
19
+
20
+ Scenario: colon line syntax on single example
21
+ Given a file named "example_spec.rb" with:
22
+ """
23
+ describe "an example" do
24
+ it "has not yet been implemented"
25
+ it "has been implemented" do
26
+ true
27
+ end
28
+ end
29
+ """
30
+ When I run "spec example_spec.rb:2"
31
+ Then the stdout should match "1 example, 0 failures, 1 pending"
32
+ And the stdout should match "example_spec.rb:2"
@@ -0,0 +1,169 @@
1
+ Feature: before and after blocks
2
+
3
+ As a developer using RSpec
4
+ I want to execute arbitrary code before and after each example
5
+ So that I can control the environment in which it is run
6
+
7
+ This is supported by the before and after methods which each take a symbol
8
+ indicating the scope, and a block of code to execute.
9
+
10
+ before(:each) blocks are run before each example
11
+ before(:all) blocks are run once before all of the examples in a group
12
+ before(:suite) blocks are run once before the entire suite
13
+
14
+ after(:each) blocks are run after each example
15
+ after(:all) blocks are run once after all of the examples in a group
16
+ after(:suite) blocks are run once after the entire suite
17
+
18
+ Before and after blocks are called in the following order:
19
+ before suite
20
+ before all
21
+ before each
22
+ after each
23
+ after all
24
+ after suite
25
+
26
+ Before and after blocks can be defined in the example groups to which they
27
+ apply or in a configuration. When defined in a configuration, they can be
28
+ applied to all groups or subsets of all groups defined by example group
29
+ types.
30
+
31
+ Scenario: define before(:each) block in example group
32
+ Given a file named "before_each_in_example_group_spec.rb" with:
33
+ """
34
+ class Thing
35
+ def widgets
36
+ @widgets ||= []
37
+ end
38
+ end
39
+
40
+ describe Thing do
41
+ before(:each) do
42
+ @thing = Thing.new
43
+ end
44
+
45
+ describe "initialized in before(:each)" do
46
+ it "has 0 widgets" do
47
+ @thing.should have(0).widgets
48
+ end
49
+
50
+ it "can get accept new widgets" do
51
+ @thing.widgets << Object.new
52
+ end
53
+
54
+ it "does not share state across examples" do
55
+ @thing.should have(0).widgets
56
+ end
57
+ end
58
+ end
59
+ """
60
+ When I run "rspec before_each_in_example_group_spec.rb"
61
+ Then the stdout should match "3 examples, 0 failures"
62
+
63
+ Scenario: define before(:all) block in example group
64
+ Given a file named "before_all_in_example_group_spec.rb" with:
65
+ """
66
+ class Thing
67
+ def widgets
68
+ @widgets ||= []
69
+ end
70
+ end
71
+
72
+ describe Thing do
73
+ before(:all) do
74
+ @thing = Thing.new
75
+ end
76
+
77
+ describe "initialized in before(:all)" do
78
+ it "has 0 widgets" do
79
+ @thing.should have(0).widgets
80
+ end
81
+
82
+ it "can get accept new widgets" do
83
+ @thing.widgets << Object.new
84
+ end
85
+
86
+ it "shares state across examples" do
87
+ @thing.should have(1).widgets
88
+ end
89
+ end
90
+ end
91
+ """
92
+ When I run "rspec before_all_in_example_group_spec.rb"
93
+ Then the stdout should match "3 examples, 0 failures"
94
+
95
+ @wip
96
+ Scenario: define before and after blocks in configuration
97
+ Given a file named "befores_in_configuration_spec.rb" with:
98
+ """
99
+ Rspec::Core.configure do |config|
100
+ config.before(:suite) do
101
+ $before_suite = "before suite"
102
+ end
103
+ config.before(:each) do
104
+ @before_each = "before each"
105
+ end
106
+ config.before(:all) do
107
+ @before_all = "before all"
108
+ end
109
+ end
110
+
111
+ describe "stuff in before blocks" do
112
+ describe "with :suite" do
113
+ it "should be available in the example" do
114
+ $before_suite.should == "before suite"
115
+ end
116
+ end
117
+ describe "with :all" do
118
+ it "should be available in the example" do
119
+ @before_all.should == "before all"
120
+ end
121
+ end
122
+ describe "with :each" do
123
+ it "should be available in the example" do
124
+ @before_each.should == "before each"
125
+ end
126
+ end
127
+ end
128
+ """
129
+ When I run "spec befores_in_configuration_spec.rb"
130
+ Then the stdout should match "3 examples, 0 failures"
131
+
132
+ @wip
133
+ Scenario: before/after blocks are run in order
134
+ Given a file named "ensure_block_order_spec.rb" with:
135
+ """
136
+ Rspec::Core.configure do |config|
137
+ config.before(:suite) do
138
+ puts "before suite"
139
+ end
140
+ config.after(:suite) do
141
+ puts "after suite"
142
+ end
143
+ end
144
+
145
+ describe "before and after callbacks" do
146
+ before(:all) do
147
+ puts "before all"
148
+ end
149
+
150
+ before(:each) do
151
+ puts "before each"
152
+ end
153
+
154
+ after(:each) do
155
+ puts "after each"
156
+ end
157
+
158
+ after(:all) do
159
+ puts "after all"
160
+ end
161
+
162
+ it "gets run in order" do
163
+
164
+ end
165
+ end
166
+ """
167
+ When I run "spec ensure_block_order_spec.rb"
168
+ Then the stdout should match /before suite\nbefore all\nbefore each\nafter each\n\.after all\n.*after suite/m
169
+
@@ -0,0 +1,54 @@
1
+ Feature: customized message
2
+
3
+ In order to get the feedback I want
4
+ As an RSpec user
5
+ I want to customize the failure message per example
6
+
7
+ Scenario: one additional method
8
+ Given a file named "node_spec.rb.rb" with:
9
+ """
10
+ class Node
11
+ def initialize(state=:waiting)
12
+ @state = state
13
+ end
14
+ def state
15
+ @state
16
+ end
17
+ def waiting?
18
+ @state == :waiting
19
+ end
20
+ def started?
21
+ @state == :started
22
+ end
23
+ def start
24
+ @state = :started
25
+ end
26
+ end
27
+
28
+ describe "a new Node" do
29
+ it "should be waiting" do
30
+ node = Node.new(:started) #start w/ started to trigger failure
31
+ node.should be_waiting, "node.state: #{node.state} (first example)"
32
+ end
33
+
34
+ it "should not be started" do
35
+ node = Node.new(:started) #start w/ started to trigger failure
36
+ node.should_not be_started, "node.state: #{node.state} (second example)"
37
+ end
38
+ end
39
+
40
+ describe "node.start" do
41
+ it "should change the state" do
42
+ node = Node.new(:started) #start w/ started to trigger failure
43
+ lambda {node.start}.should change{node.state}, "expected a change"
44
+ end
45
+ end
46
+
47
+ """
48
+ When I run "spec node_spec.rb.rb --format specdoc"
49
+ Then the stdout should match "3 examples, 3 failures"
50
+ And the stdout should not match "to return true, got false"
51
+ And the stdout should not match "to return false, got true"
52
+ And the stdout should match "node.state: started (first example)"
53
+ And the stdout should match "node.state: started (second example)"
54
+ And the stdout should match "expected a change"
@@ -0,0 +1,39 @@
1
+ Feature: define matcher outside rspec
2
+
3
+ In order to express my domain clearly in my code examples
4
+ As a non-rspec user
5
+ I want a shortcut to define custom matchers
6
+
7
+ Scenario: define a matcher with default messages
8
+ Given a file named "test_multiples.rb" with:
9
+ """
10
+ $:.unshift File.join(File.dirname(__FILE__), "/../../lib")
11
+ require 'test/unit'
12
+ require 'rspec/expectations'
13
+
14
+ Rspec::Matchers.define :be_a_multiple_of do |expected|
15
+ match do |actual|
16
+ actual % expected == 0
17
+ end
18
+ end
19
+
20
+ class Test::Unit::TestCase
21
+ include Rspec::Matchers
22
+ end
23
+
24
+ class TestMultiples < Test::Unit::TestCase
25
+
26
+ def test_9_should_be_a_multiple_of_3
27
+ 9.should be_a_multiple_of(3)
28
+ end
29
+
30
+ def test_9_should_be_a_multiple_of_4
31
+ 9.should be_a_multiple_of(4)
32
+ end
33
+
34
+ end
35
+ """
36
+ When I run "ruby test_multiples.rb"
37
+ Then the exit code should be 256
38
+ And the stdout should match "expected 9 to be a multiple of 4"
39
+ And the stdout should match "2 tests, 0 assertions, 1 failures, 0 errors"