1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
|
Feature: Using the `--order` option
Use the `--order` option to tell RSpec how to order the files, groups, and
examples. The available ordering schemes are `defined` and `rand`.
`defined` is the default, which executes groups and examples in the order they
are defined as the spec files are loaded, with the caveat that each group
runs its examples before running its nested example groups, even if the
nested groups are defined before the examples.
Use `rand` to randomize the order of groups and examples within the groups.
Nested groups are always run from top-level to bottom-level in order to avoid
executing `before(:context)` and `after(:context)` hooks more than once, but the
order of groups at each level is randomized.
With `rand` you can also specify a seed.
Use `recently-modified` to run the most recently modified files first. You can
combine it with `--only-failures` to find the most recent failing specs. Note
that `recently-modified` and `rand` are mutually exclusive.
** Example usage **
The `defined` option is only necessary when you have `--order rand` stored in a
config file (e.g. `.rspec`) and you want to override it from the command line.
<pre><code class="bash">--order defined
--order rand
--order rand:123
--seed 123 # same as --order rand:123
--order recently-modified
</code></pre>
Scenario: Default order is `defined`
Given a file named "example_spec.rb" with:
"""ruby
RSpec.describe "something" do
it "does something" do
end
it "in order" do
end
end
"""
When I run `rspec example_spec.rb --format documentation`
Then the output should contain:
"""
something
does something
in order
"""
Scenario: Order can be psuedo randomised (seed used here to fix the ordering for tests)
Given a file named "example_spec.rb" with:
"""ruby
RSpec.describe "something" do
it "does something" do
end
it "in order" do
end
end
"""
When I run `rspec example_spec.rb --format documentation --order rand:123`
Then the output should contain:
"""
something
in order
does something
"""
Scenario: Configure custom ordering
Given a file named "example_spec.rb" with:
"""ruby
RSpec.configure do |config|
config.register_ordering(:reverse) do |examples|
examples.reverse
end
config.order = :reverse
end
RSpec.describe "something" do
it "does something" do
end
it "in order" do
end
end
"""
When I run `rspec example_spec.rb --format documentation --order reverse`
Then the output should contain:
"""
something
in order
does something
"""
Scenario: Override order to `defined` when another order is set
Given a file named "example_spec.rb" with:
"""ruby
RSpec.configure do |config|
config.order = :random
config.seed = 123
end
RSpec.describe "something" do
it "does something" do
end
it "in order" do
end
end
"""
When I run `rspec example_spec.rb --format documentation --order defined`
Then the output should contain:
"""
something
does something
in order
"""
|
