forked from rspec/rspec.github.io
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathindex.html
438 lines (438 loc) · 53.2 KB
/
index.html
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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>
File: README
— Documentation by YARD 0.8.7.3
</title>
<link rel="stylesheet" href="/stylesheets/docs/style.css" type="text/css" charset="utf-8" />
<link rel="stylesheet" href="/stylesheets/docs/common.css" type="text/css" charset="utf-8" />
<link rel="stylesheet" href="/stylesheets/docs/rspec.css" type="text/css" charset="utf-8" />
<script type="text/javascript" charset="utf-8">
hasFrames = window.top.frames.main ? true : false;
relpath = '';
framesUrl = "frames.html#!" + escape(window.location.href);
</script>
<script type="text/javascript" charset="utf-8" src="/javascripts/docs/jquery.js"></script>
<script type="text/javascript" charset="utf-8" src="/javascripts/docs/app.js"></script>
</head>
<body>
<div id="header">
<div id="menu">
<a href="_index.html">Index</a> »
<span class="title">File: README</span>
<div class="noframes"><span class="title">(</span><a href="." target="_top">no frames</a><span class="title">)</span></div>
</div>
<div id="search">
<a class="full_list_link" id="class_list_link"
href="class_list.html">
Class List
</a>
<a class="full_list_link" id="method_list_link"
href="method_list.html">
Method List
</a>
<a class="full_list_link" id="file_list_link"
href="file_list.html">
File List
</a>
</div>
<div class="clear"></div>
</div>
<iframe id="search_frame"></iframe>
<div id="content"><div id='filecontents'><h1>rspec-rails <a href="http://travis-ci.org/rspec/rspec-rails"><img src="https://secure.travis-ci.org/rspec/rspec-rails.png?branch=master" alt="Build Status"></a> <a href="https://codeclimate.com/github/rspec/rspec-rails"><img src="https://codeclimate.com/github/rspec/rspec-rails.png" alt="Code Climate"></a></h1>
<p><strong>rspec-rails</strong> is a testing framework for Rails 3.x and 4.x.</p>
<p>Use <strong><a href="http://github.com/dchelimsky/rspec-rails">rspec-rails 1.x</a></strong> for Rails
2.x.</p>
<h2>Installation</h2>
<p>Add <code>rspec-rails</code> to <strong>both</strong> the <code>:development</code> and <code>:test</code> groups in the
<code>Gemfile</code>:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_group'>group</span> <span class='symbol'>:development</span><span class='comma'>,</span> <span class='symbol'>:test</span> <span class='kw'>do</span>
<span class='id identifier rubyid_gem'>gem</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>rspec-rails</span><span class='tstring_end'>'</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>~> 3.0</span><span class='tstring_end'>'</span></span>
<span class='kw'>end</span>
</code></pre>
<p>Download and install by running:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_bundle'>bundle</span> <span class='id identifier rubyid_install'>install</span>
</code></pre>
<p>Initialize the <code>spec/</code> directory (where specs will reside) with:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_rails'>rails</span> <span class='id identifier rubyid_generate'>generate</span> <span class='label'>rspec:</span><span class='id identifier rubyid_install'>install</span>
</code></pre>
<p>This adds the following files which are used for configuration:</p>
<ul>
<li><code>.rspec</code></li>
<li><code>spec/spec_helper.rb</code></li>
<li><code>spec/rails_helper.rb</code></li>
</ul>
<p>Check the comments in each file for more information.</p>
<p>Use the <code>rspec</code> command to run your specs:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_bundle'>bundle</span> <span class='id identifier rubyid_exec'>exec</span> <span class='id identifier rubyid_rspec'>rspec</span>
</code></pre>
<p>By default the above will run all <code>_spec.rb</code> files in the <code>spec</code> directory. For
more details about this see the <a href="https://www.relishapp.com/rspec/rspec-core/docs/spec-files">RSpec spec file
docs</a>.</p>
<p>To run only a subset of these specs use the following command:</p>
<pre class="code ruby"><code class="ruby"><span class='comment'># Run only model specs
</span><span class='id identifier rubyid_bundle'>bundle</span> <span class='id identifier rubyid_exec'>exec</span> <span class='id identifier rubyid_rspec'>rspec</span> <span class='id identifier rubyid_spec'>spec</span><span class='op'>/</span><span class='id identifier rubyid_models'>models</span>
<span class='comment'># Run only specs for AccountsController
</span><span class='id identifier rubyid_bundle'>bundle</span> <span class='id identifier rubyid_exec'>exec</span> <span class='id identifier rubyid_rspec'>rspec</span> <span class='id identifier rubyid_spec'>spec</span><span class='op'>/</span><span class='id identifier rubyid_controllers'>controllers</span><span class='op'>/</span><span class='id identifier rubyid_accounts_controller_spec'>accounts_controller_spec</span><span class='period'>.</span><span class='id identifier rubyid_rb'>rb</span>
</code></pre>
<p>Specs can also be run via <code>rake spec</code>, though this command may be slower to
start than the <code>rspec</code> command.</p>
<p>In Rails 4, you may want to create a binstub for the <code>rspec</code> command so it can
be run via <code>bin/rspec</code>:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_bundle'>bundle</span> <span class='id identifier rubyid_binstubs'>binstubs</span> <span class='id identifier rubyid_rspec'>rspec</span><span class='op'>-</span><span class='id identifier rubyid_core'>core</span>
</code></pre>
<h3>Upgrade Note</h3>
<p>For detailed information on the general RSpec 3.x upgrade process see the
<a href="https://relishapp.com/rspec/docs/upgrade">RSpec Upgrade docs</a>.</p>
<p>There are three particular <code>rspec-rails</code> specific changes to be aware of:</p>
<ol>
<li><a href="https://www.relishapp.com/rspec/rspec-rails/docs/upgrade#default-helper-files">The default helper files created in RSpec 3.x have changed</a></li>
<li><a href="https://www.relishapp.com/rspec/rspec-rails/docs/upgrade#file-type-inference-disabled">File-type inference disabled by default</a></li>
<li><a href="https://www.relishapp.com/rspec/rspec-rails/docs/upgrade#pending-migration-checks">Rails 4.x <code>ActiveRecord::Migration</code> pending migration checks</a></li>
<li>Extraction of <code>stub_model</code> and <code>mock_model</code> to
<a href="https://github.com/rspec/rspec-activemodel-mocks"><code>rspec-activemodel-mocks</code></a></li>
</ol>
<p>Please see the <a href="https://www.relishapp.com/rspec/rspec-rails/docs/upgrade">RSpec Rails Upgrade
docs</a> for full
details.</p>
<p><strong>NOTE:</strong> Generators run in RSpec 3.x will now require <code>rails_helper</code> instead
of <code>spec_helper</code>.</p>
<h3>Generators</h3>
<p>Once installed, RSpec will generate spec files instead of Test::Unit test files
when commands like <code>rails generate model</code> and <code>rails generate controller</code> are
used.</p>
<p>You may also invoke RSpec generators independently. For instance,
running <code>rails generate rspec:model</code> will generate a model spec. For more
information, see <a href="https://www.relishapp.com/rspec/rspec-rails/docs/generators">list of all
generators</a>.</p>
<h2>Model Specs</h2>
<p>Use model specs to describe behavior of models (usually ActiveRecord-based) in
the application.</p>
<p>Model specs default to residing in the <code>spec/models</code> folder. Tagging any
context with the metadata <code>:type => :model</code> treats its examples as model
specs.</p>
<p>For example:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>rails_helper</span><span class='tstring_end'>"</span></span>
<span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='const'>User</span><span class='comma'>,</span> <span class='symbol'>:type</span> <span class='op'>=></span> <span class='symbol'>:model</span> <span class='kw'>do</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>orders by last name</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_lindeman'>lindeman</span> <span class='op'>=</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_create!'>create!</span><span class='lparen'>(</span><span class='label'>first_name:</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Andy</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='label'>last_name:</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Lindeman</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
<span class='id identifier rubyid_chelimsky'>chelimsky</span> <span class='op'>=</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_create!'>create!</span><span class='lparen'>(</span><span class='label'>first_name:</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>David</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='label'>last_name:</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Chelimsky</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_ordered_by_last_name'>ordered_by_last_name</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_eq'>eq</span><span class='lparen'>(</span><span class='lbracket'>[</span><span class='id identifier rubyid_chelimsky'>chelimsky</span><span class='comma'>,</span> <span class='id identifier rubyid_lindeman'>lindeman</span><span class='rbracket'>]</span><span class='rparen'>)</span>
<span class='kw'>end</span>
<span class='kw'>end</span>
</code></pre>
<p>For more information, see <a href="https://www.relishapp.com/rspec/rspec-rails/docs/model-specs">cucumber scenarios for model
specs</a>.</p>
<h2>Controller Specs</h2>
<p>Use controller specs to describe behavior of Rails controllers.</p>
<p>Controller specs default to residing in the <code>spec/controllers</code> folder. Tagging
any context with the metadata <code>:type => :controller</code> treats its examples as
controller specs.</p>
<p>For example:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>rails_helper</span><span class='tstring_end'>"</span></span>
<span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='const'>PostsController</span><span class='comma'>,</span> <span class='symbol'>:type</span> <span class='op'>=></span> <span class='symbol'>:controller</span> <span class='kw'>do</span>
<span class='id identifier rubyid_describe'>describe</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>GET #index</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>responds successfully with an HTTP 200 status code</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_get'>get</span> <span class='symbol'>:index</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_be_success'>be_success</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_have_http_status'>have_http_status</span><span class='lparen'>(</span><span class='int'>200</span><span class='rparen'>)</span>
<span class='kw'>end</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>renders the index template</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_get'>get</span> <span class='symbol'>:index</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_render_template'>render_template</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>index</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
<span class='kw'>end</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>loads all of the posts into @posts</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_post1'>post1</span><span class='comma'>,</span> <span class='id identifier rubyid_post2'>post2</span> <span class='op'>=</span> <span class='const'>Post</span><span class='period'>.</span><span class='id identifier rubyid_create!'>create!</span><span class='comma'>,</span> <span class='const'>Post</span><span class='period'>.</span><span class='id identifier rubyid_create!'>create!</span>
<span class='id identifier rubyid_get'>get</span> <span class='symbol'>:index</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_assigns'>assigns</span><span class='lparen'>(</span><span class='symbol'>:posts</span><span class='rparen'>)</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_match_array'>match_array</span><span class='lparen'>(</span><span class='lbracket'>[</span><span class='id identifier rubyid_post1'>post1</span><span class='comma'>,</span> <span class='id identifier rubyid_post2'>post2</span><span class='rbracket'>]</span><span class='rparen'>)</span>
<span class='kw'>end</span>
<span class='kw'>end</span>
<span class='kw'>end</span>
</code></pre>
<p>For more information, see <a href="https://www.relishapp.com/rspec/rspec-rails/docs/controller-specs">cucumber scenarios for controller
specs</a>.</p>
<p><strong>Note:</strong> To encourage more isolated testing, views are not rendered by default
in controller specs. If you are verifying discrete view logic, use a <a href="#view-specs">view
spec</a>. If you are verifying the behaviour of a controller and view
together, consider a <a href="#request-specs">request spec</a>. You can use
<a href="https://www.relishapp.com/rspec/rspec-rails/docs/controller-specs/render-views">render_views</a>
if you must verify the rendered view contents within a controller spec, but
this is not recommended.</p>
<h2>Request Specs</h2>
<p>Use request specs to specify one or more request/response cycles from end to
end using a black box approach.</p>
<p>Request specs default to residing in the <code>spec/requests</code>, <code>spec/api</code>, and
<code>spec/integration</code> directories. Tagging any context with the metadata <code>:type =>
:request</code> treats its examples as request specs.</p>
<p>Request specs mix in behavior from
<a href="http://api.rubyonrails.org/classes/ActionDispatch/Integration/Runner.html">ActionDispatch::Integration::Runner</a>,
which is the basis for <a href="http://guides.rubyonrails.org/testing.html#integration-testing">Rails' integration
tests</a>.</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>rails_helper</span><span class='tstring_end'>'</span></span>
<span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>home page</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:type</span> <span class='op'>=></span> <span class='symbol'>:request</span> <span class='kw'>do</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>displays the user's username after successful login</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_user'>user</span> <span class='op'>=</span> <span class='const'>User</span><span class='period'>.</span><span class='id identifier rubyid_create!'>create!</span><span class='lparen'>(</span><span class='symbol'>:username</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>jdoe</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:password</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>secret</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
<span class='id identifier rubyid_get'>get</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/login</span><span class='tstring_end'>"</span></span>
<span class='id identifier rubyid_assert_select'>assert_select</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>form.login</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_assert_select'>assert_select</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>input[name=?]</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>username</span><span class='tstring_end'>"</span></span>
<span class='id identifier rubyid_assert_select'>assert_select</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>input[name=?]</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>password</span><span class='tstring_end'>"</span></span>
<span class='id identifier rubyid_assert_select'>assert_select</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>input[type=?]</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>submit</span><span class='tstring_end'>"</span></span>
<span class='kw'>end</span>
<span class='id identifier rubyid_post'>post</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/login</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:username</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>jdoe</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:password</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>secret</span><span class='tstring_end'>"</span></span>
<span class='id identifier rubyid_assert_select'>assert_select</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>.header .username</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:text</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>jdoe</span><span class='tstring_end'>"</span></span>
<span class='kw'>end</span>
<span class='kw'>end</span>
</code></pre>
<p>The above example uses only standard Rails and RSpec API's, but many
RSpec/Rails users like to use extension libraries like
<a href="https://github.com/thoughtbot/factory_girl">FactoryGirl</a> and
<a href="https://github.com/jnicklas/capybara">Capybara</a>:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>rails_helper</span><span class='tstring_end'>'</span></span>
<span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>home page</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:type</span> <span class='op'>=></span> <span class='symbol'>:request</span> <span class='kw'>do</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>displays the user's username after successful login</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_user'>user</span> <span class='op'>=</span> <span class='const'>FactoryGirl</span><span class='period'>.</span><span class='id identifier rubyid_create'>create</span><span class='lparen'>(</span><span class='symbol'>:user</span><span class='comma'>,</span> <span class='symbol'>:username</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>jdoe</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:password</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>secret</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
<span class='id identifier rubyid_visit'>visit</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/login</span><span class='tstring_end'>"</span></span>
<span class='id identifier rubyid_fill_in'>fill_in</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Username</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:with</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>jdoe</span><span class='tstring_end'>"</span></span>
<span class='id identifier rubyid_fill_in'>fill_in</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Password</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:with</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>secret</span><span class='tstring_end'>"</span></span>
<span class='id identifier rubyid_click_button'>click_button</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Log in</span><span class='tstring_end'>"</span></span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_page'>page</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_have_selector'>have_selector</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>.header .username</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:text</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>jdoe</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
<span class='kw'>end</span>
<span class='kw'>end</span>
</code></pre>
<p>FactoryGirl decouples this example from changes to validation requirements,
which can be encoded into the underlying factory definition without requiring
changes to this example.</p>
<p>Among other benefits, Capybara binds the form post to the generated HTML, which
means we don't need to specify them separately. Note that Capybara's DSL as
shown is, by default, only available in specs in the spec/features directory.
For more information, see the <a href="http://rubydoc.info/gems/rspec-rails/file/Capybara.md">Capybara integration
docs</a>.</p>
<p>There are several other Ruby libs that implement the factory pattern or provide
a DSL for request specs (a.k.a. acceptance or integration specs), but
FactoryGirl and Capybara seem to be the most widely used. Whether you choose
these or other libs, we strongly recommend using something for each of these
roles.</p>
<h2>Feature Specs</h2>
<p>Feature specs test your application from the outside by simulating a browser.
<a href="https://github.com/jnicklas/capybara"><code>capybara</code></a> is used to manage the
simulated browser.</p>
<p>Feature specs default to residing in the <code>spec/features</code> folder. Tagging any
context with the metadata <code>:type => :feature</code> treats its examples as feature
specs.</p>
<p>Feature specs mix in functionality from the capybara gem, thus they require
<code>capybara</code> to use. To use feature specs, add <code>capybara</code> to the <code>Gemfile</code>:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_gem'>gem</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>capybara</span><span class='tstring_end'>"</span></span>
</code></pre>
<p>For more information, see the <a href="https://www.relishapp.com/rspec/rspec-rails/v/3-0/docs/feature-specs/feature-spec">cucumber scenarios for feature
specs</a>.</p>
<h2>View specs</h2>
<p>View specs default to residing in the <code>spec/views</code> folder. Tagging any context
with the metadata <code>:type => :view</code> treats its examples as view specs.</p>
<p>View specs mix in <code>ActionView::TestCase::Behavior</code>.</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>rails_helper</span><span class='tstring_end'>'</span></span>
<span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>events/index</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:type</span> <span class='op'>=></span> <span class='symbol'>:view</span> <span class='kw'>do</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>renders _event partial for each event</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_assign'>assign</span><span class='lparen'>(</span><span class='symbol'>:events</span><span class='comma'>,</span> <span class='lbracket'>[</span><span class='id identifier rubyid_double'>double</span><span class='lparen'>(</span><span class='const'>Event</span><span class='rparen'>)</span><span class='comma'>,</span> <span class='id identifier rubyid_double'>double</span><span class='lparen'>(</span><span class='const'>Event</span><span class='rparen'>)</span><span class='rbracket'>]</span><span class='rparen'>)</span>
<span class='id identifier rubyid_render'>render</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_view'>view</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_render_template'>render_template</span><span class='lparen'>(</span><span class='symbol'>:partial</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>_event</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:count</span> <span class='op'>=></span> <span class='int'>2</span><span class='rparen'>)</span>
<span class='kw'>end</span>
<span class='kw'>end</span>
<span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>events/show</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:type</span> <span class='op'>=></span> <span class='symbol'>:view</span> <span class='kw'>do</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>displays the event location</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_assign'>assign</span><span class='lparen'>(</span><span class='symbol'>:event</span><span class='comma'>,</span> <span class='const'>Event</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='symbol'>:location</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Chicago</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span><span class='rparen'>)</span>
<span class='id identifier rubyid_render'>render</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_rendered'>rendered</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_include'>include</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Chicago</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
<span class='kw'>end</span>
<span class='kw'>end</span>
</code></pre>
<p>View specs infer the controller name and path from the path to the view
template. e.g. if the template is <code>events/index.html.erb</code> then:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_controller'>controller</span><span class='period'>.</span><span class='id identifier rubyid_controller_path'>controller_path</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>events</span><span class='tstring_end'>"</span></span>
<span class='id identifier rubyid_controller'>controller</span><span class='period'>.</span><span class='id identifier rubyid_request'>request</span><span class='period'>.</span><span class='id identifier rubyid_path_parameters'>path_parameters</span><span class='lbracket'>[</span><span class='symbol'>:controller</span><span class='rbracket'>]</span> <span class='op'>==</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>events</span><span class='tstring_end'>"</span></span>
</code></pre>
<p>This means that most of the time you don't need to set these values. When
spec'ing a partial that is included across different controllers, you <em>may</em>
need to override these values before rendering the view.</p>
<p>To provide a layout for the render, you'll need to specify <em>both</em> the template
and the layout explicitly. For example:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_render'>render</span> <span class='symbol'>:template</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>events/show</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:layout</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>layouts/application</span><span class='tstring_end'>"</span></span>
</code></pre>
<h3><code>assign(key, val)</code></h3>
<p>Use this to assign values to instance variables in the view:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_assign'>assign</span><span class='lparen'>(</span><span class='symbol'>:widget</span><span class='comma'>,</span> <span class='const'>Widget</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='rparen'>)</span>
<span class='id identifier rubyid_render'>render</span>
</code></pre>
<p>The code above assigns <code>Widget.new</code> to the <code>@widget</code> variable in the view, and
then renders the view.</p>
<p>Note that because view specs mix in <code>ActionView::TestCase</code> behavior, any
instance variables you set will be transparently propagated into your views
(similar to how instance variables you set in controller actions are made
available in views). For example:</p>
<pre class="code ruby"><code class="ruby"><span class='ivar'>@widget</span> <span class='op'>=</span> <span class='const'>Widget</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
<span class='id identifier rubyid_render'>render</span> <span class='comment'># @widget is available inside the view
</span></code></pre>
<p>RSpec doesn't officially support this pattern, which only works as a
side-effect of the inclusion of <code>ActionView::TestCase</code>. Be aware that it may be
made unavailable in the future.</p>
<h4>Upgrade note</h4>
<pre class="code ruby"><code class="ruby"><span class='comment'># rspec-rails-1.x
</span><span class='id identifier rubyid_assigns'>assigns</span><span class='lbracket'>[</span><span class='id identifier rubyid_key'>key</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id identifier rubyid_value'>value</span>
<span class='comment'># rspec-rails-2.x+
</span><span class='id identifier rubyid_assign'>assign</span><span class='lparen'>(</span><span class='id identifier rubyid_key'>key</span><span class='comma'>,</span> <span class='id identifier rubyid_value'>value</span><span class='rparen'>)</span>
</code></pre>
<h3><code>rendered</code></h3>
<p>This represents the rendered view.</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_render'>render</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_rendered'>rendered</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_match'>match</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>Some text expected to appear on the page</span><span class='regexp_end'>/</span></span>
</code></pre>
<h4>Upgrade note</h4>
<pre class="code ruby"><code class="ruby"><span class='comment'># rspec-rails-1.x
</span><span class='id identifier rubyid_render'>render</span>
<span class='id identifier rubyid_response'>response</span><span class='period'>.</span><span class='id identifier rubyid_should'>should</span> <span class='id identifier rubyid_xxx'>xxx</span>
<span class='comment'># rspec-rails-2.x+
</span><span class='id identifier rubyid_render'>render</span>
<span class='id identifier rubyid_rendered'>rendered</span><span class='period'>.</span><span class='id identifier rubyid_should'>should</span> <span class='id identifier rubyid_xxx'>xxx</span>
<span class='comment'># rspec-rails-2.x+ with expect syntax
</span><span class='id identifier rubyid_render'>render</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_rendered'>rendered</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_xxx'>xxx</span>
</code></pre>
<h2>Routing specs</h2>
<p>Routing specs default to residing in the <code>spec/routing</code> folder. Tagging any
context with the metadata <code>:type => :routing</code> treats its examples as routing
specs.</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>rails_helper</span><span class='tstring_end'>'</span></span>
<span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>routing to profiles</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:type</span> <span class='op'>=></span> <span class='symbol'>:routing</span> <span class='kw'>do</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>routes /profile/:username to profile#show for username</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='symbol'>:get</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/profiles/jsmith</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_route_to'>route_to</span><span class='lparen'>(</span>
<span class='symbol'>:controller</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>profiles</span><span class='tstring_end'>"</span></span><span class='comma'>,</span>
<span class='symbol'>:action</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>show</span><span class='tstring_end'>"</span></span><span class='comma'>,</span>
<span class='symbol'>:username</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>jsmith</span><span class='tstring_end'>"</span></span>
<span class='rparen'>)</span>
<span class='kw'>end</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>does not expose a list of profiles</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='symbol'>:get</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/profiles</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_not_to'>not_to</span> <span class='id identifier rubyid_be_routable'>be_routable</span>
<span class='kw'>end</span>
<span class='kw'>end</span>
</code></pre>
<h3>Upgrade note</h3>
<p><code>route_for</code> from rspec-rails-1.x is gone. Use <code>route_to</code> and <code>be_routable</code>
instead.</p>
<h2>Helper specs</h2>
<p>Helper specs default to residing in the <code>spec/helpers</code> folder. Tagging any
context with the metadata <code>:type => :helper</code> treats its examples as helper
specs.</p>
<p>Helper specs mix in ActionView::TestCase::Behavior. A <code>helper</code> object is
provided which mixes in the helper module being spec'd, along with
<code>ApplicationHelper</code> (if present).</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>rails_helper</span><span class='tstring_end'>'</span></span>
<span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_describe'>describe</span> <span class='const'>EventsHelper</span><span class='comma'>,</span> <span class='symbol'>:type</span> <span class='op'>=></span> <span class='symbol'>:helper</span> <span class='kw'>do</span>
<span class='id identifier rubyid_describe'>describe</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>#link_to_event</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_it'>it</span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>displays the title, and formatted date</span><span class='tstring_end'>"</span></span> <span class='kw'>do</span>
<span class='id identifier rubyid_event'>event</span> <span class='op'>=</span> <span class='const'>Event</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>Ruby Kaigi</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='const'>Date</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span><span class='lparen'>(</span><span class='int'>2010</span><span class='comma'>,</span> <span class='int'>8</span><span class='comma'>,</span> <span class='int'>27</span><span class='rparen'>)</span><span class='rparen'>)</span>
<span class='comment'># helper is an instance of ActionView::Base configured with the
</span> <span class='comment'># EventsHelper and all of Rails' built-in helpers
</span> <span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_helper'>helper</span><span class='period'>.</span><span class='id identifier rubyid_link_to_event'>link_to_event</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_match'>match</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>Ruby Kaigi, 27 Aug, 2010</span><span class='regexp_end'>/</span></span>
<span class='kw'>end</span>
<span class='kw'>end</span>
<span class='kw'>end</span>
</code></pre>
<h2>Matchers</h2>
<p>Several domain-specific matchers are provided to each of the example group
types. Most simply delegate to their equivalent Rails' assertions.</p>
<h3><code>be_a_new</code></h3>
<ul>
<li>Available in all specs</li>
<li>Primarily intended for controller specs</li>
</ul>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_object'>object</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_be_a_new'>be_a_new</span><span class='lparen'>(</span><span class='const'>Widget</span><span class='rparen'>)</span>
</code></pre>
<p>Passes if the object is a <code>Widget</code> and returns true for <code>new_record?</code></p>
<h3><code>render_template</code></h3>
<ul>
<li>Delegates to Rails' <code>assert_template</code></li>
<li>Available in request, controller, and view specs</li>
</ul>
<p>In request and controller specs, apply to the <code>response</code> object:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_render_template'>render_template</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>new</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
</code></pre>
<p>In view specs, apply to the <code>view</code> object:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_view'>view</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_render_template'>render_template</span><span class='lparen'>(</span><span class='symbol'>:partial</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>_form</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:locals</span> <span class='op'>=></span> <span class='lbrace'>{</span> <span class='symbol'>:widget</span> <span class='op'>=></span> <span class='id identifier rubyid_widget'>widget</span> <span class='rbrace'>}</span> <span class='rparen'>)</span>
</code></pre>
<h3><code>redirect_to</code></h3>
<ul>
<li>Delegates to <code>assert_redirect</code></li>
<li>Available in request and controller specs</li>
</ul>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_redirect_to'>redirect_to</span><span class='lparen'>(</span><span class='id identifier rubyid_widgets_path'>widgets_path</span><span class='rparen'>)</span>
</code></pre>
<h3><code>route_to</code></h3>
<ul>
<li>Delegates to Rails' <code>assert_routing</code></li>
<li>Available in routing and controller specs</li>
</ul>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='symbol'>:get</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/widgets</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_route_to'>route_to</span><span class='lparen'>(</span><span class='symbol'>:controller</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>widgets</span><span class='tstring_end'>"</span></span><span class='comma'>,</span> <span class='symbol'>:action</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>index</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span>
</code></pre>
<h3><code>be_routable</code></h3>
<p>Passes if the path is recognized by Rails' routing. This is primarily intended
to be used with <code>not_to</code> to specify standard CRUD routes which should not be
routable.</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='symbol'>:get</span> <span class='op'>=></span> <span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>/widgets/1/edit</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_not_to'>not_to</span> <span class='id identifier rubyid_be_routable'>be_routable</span>
</code></pre>
<h3><code>have_http_status</code></h3>
<ul>
<li>Passes if <code>response</code> has a matching HTTP status code</li>
<li>The following symbolic status codes are allowed:
<ul>
<li><code>Rack::Utils::SYMBOL_TO_STATUS_CODE</code></li>
<li>One of the defined <code>ActionDispatch::TestResponse</code> aliases:</li>
<li><code>:error</code></li>
<li><code>:missing</code></li>
<li><code>:redirect</code></li>
<li><code>:success</code></li>
</ul></li>
<li>Available in controller, feature, and request specs.</li>
</ul>
<p>In controller and request specs, apply to the <code>response</code> object:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_have_http_status'>have_http_status</span><span class='lparen'>(</span><span class='int'>201</span><span class='rparen'>)</span>
<span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_response'>response</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_not_to'>not_to</span> <span class='id identifier rubyid_have_http_status'>have_http_status</span><span class='lparen'>(</span><span class='symbol'>:created</span><span class='rparen'>)</span>
</code></pre>
<p>In feature specs, apply to the <code>page</code> object:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_expect'>expect</span><span class='lparen'>(</span><span class='id identifier rubyid_page'>page</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_to'>to</span> <span class='id identifier rubyid_have_http_status'>have_http_status</span><span class='lparen'>(</span><span class='symbol'>:success</span><span class='rparen'>)</span>
</code></pre>
<h2><code>rake</code> tasks</h2>
<p>Several rake tasks are provided as a convience for working with RSpec. To run
the entire spec suite use <code>rake spec</code>. To run a subset of specs use the
associated type task, for example <code>rake spec:models</code>.</p>
<p>A full list of the available rake tasks can be seen by running <code>rake -T | grep
spec</code>.</p>
<h3>Customizing <code>rake</code> tasks</h3>
<p>If you want to customize the behavior of <code>rake spec</code>, you may <a href="https://www.relishapp.com/rspec/rspec-core/docs/command-line/rake-task">define your own
task in the <code>Rakefile</code> for your
project</a>.
However, you must first clear the task that rspec-rails defined:</p>
<pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_task'>task</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>"</span><span class='tstring_content'>spec</span><span class='tstring_end'>"</span></span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_clear'>clear</span>
</code></pre>
<h2>Contribute</h2>
<p>See <a href="http://github.com/rspec/rspec-dev">http://github.com/rspec/rspec-dev</a>.</p>
<p>For <code>rspec-rails</code>-specific development information, see
<a href="https://github.com/rspec/rspec-rails/blob/master/README_DEV.md">README_DEV</a>.</p>
<h2>Also see</h2>
<ul>
<li><a href="http://github.com/rspec/rspec">http://github.com/rspec/rspec</a></li>
<li><a href="http://github.com/rspec/rspec-core">http://github.com/rspec/rspec-core</a></li>
<li><a href="http://github.com/rspec/rspec-expectations">http://github.com/rspec/rspec-expectations</a></li>
<li><a href="http://github.com/rspec/rspec-mocks">http://github.com/rspec/rspec-mocks</a></li>
</ul>
<h2>Feature Requests & Bugs</h2>
<p>See <a href="http://github.com/rspec/rspec-rails/issues">http://github.com/rspec/rspec-rails/issues</a></p>
</div></div>
<div id="footer">
Generated on Thu Jan 29 13:55:21 2015 by
<a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
0.8.7.3 (ruby-2.1.5).
</div>
</body>
</html>