rspec-rails 3.0.0.beta2 → 3.0.0.rc1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7a33b97b88c1b74c6ff81f48380f86281847892a
+  data.tar.gz: 7621acffba98290f0761567e9818300b5b7686a4
+SHA512:
+  metadata.gz: a3488a19517a4b3ee09cf23bc7da4f2bd14292c4a3f15252aebd621bd8b42a94beecc83212ac95188d1c4b0acaf13c5303b9b917cad0a4aed4fbd768cad92d35
+  data.tar.gz: 97ae5bb4223cd14bcc6357e735db57c08cd5efd2e3e4bf24ee18cae8b712b14fee57bf9cb09bb1b7f98fa31883c9f91d8db3dd34f5d046dd1951b33ca2dc0404

data.tar.gz.sig

@@ -1 +1,2 @@
-��$�]���{�[Y��O_�����=	.M���Q�hȊ��C`�ŭB�OLuD����$��cz*��]�-�Ǵ�s�4��s��A:���n��s3݉
+� E�6��~>�~�'= c(���<��&��<۱տ�2)a�h3D6�At�¸���P`�$���R��"�VUkȨ��/���L��\=j�2Re�%s�[��ĩ���+��+k;{a�
�xp��,�}��3�
�[|k��|?m��Ɏ�_�foQ̜��_NJ���G��*j�Pɥ?
+#˰0]���;&����{�h?�

data/Capybara.md

@@ -73,7 +73,5 @@ behavior and accepting the risks associated with doing so:
 
     # not recommended!
     RSpec.configure do |c|
-      c.include Capybara::DSL, :example_group => {
-        :file_path => "spec/requests"
-      }
+      c.include Capybara::DSL, :file_path => "spec/requests"
     end

data/Changelog.md

@@ -1,20 +1,41 @@
-### 3.0.0.beta2 / 2014-02-17
-[full changelog](http://github.com/rspec/rspec-rails/compare/v3.0.0.beta1...v3.0.0.beta2)
-
-Bug fixes
+### 3.0.0.rc1 / 2014-05-18
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v3.0.0.beta2...v3.0.0.rc1)
 
-* Use `__send__` rather than `send` to prevent naming collisions (Bradley Schaefer)
-* Supports Rails 4.1. (Andy Lindeman)
-* Routes are drawn correctly for anonymous controllers with abstract
-  parents. (Billy Chan)
-* Loads ActiveSupport properly to support changes in Rails 4.1. (Andy Lindeman)
-* Anonymous controllers inherit from `ActionController::Base` if `ApplicationController`
-  is not present. (Jon Rowe)
-* Require `rspec/collection_matchers` when `rspec/rails` is required. (Yuji Nakayama)
+Breaking Changes for 3.0.0:
 
-Enhancements
+* Extracts the `mock_model` and `stub_model` methods to the
+  `rspec-activemodel-mocks` gem. (Thomas Holmes)
+* Spec types are no longer inferred by location, they instead need to be
+  explicitly tagged. The old behaviour is enabled by
+  `config.infer_spec_type_from_file_location!`, which is still supplied
+  in the default generated `spec_helper.rb`. (Xavier Shay, Myron Marston)
+* `controller` macro in controller specs no longer mutates
+  `:described_class` metadata. It still overrides the subject and sets
+  the controller, though. (Myron Marston)
+* Stop depending on or requiring `rspec-collection_matchers`. Users who
+  want those matchers should add the gem to their Gemfile and require it
+  themselves. (Myron Marston)
+* Removes runtime dependency on `ActiveModel`. (Rodrigo Rosenfeld Rosas)
+
+Enhancements:
+
+* Supports Rails 4.x reference attribute ids in generated scaffold for view
+  specs. (Giovanni Cappellotto)
+* Add `have_http_status` matcher. (Aaron Kromer)
+* Add spec type metadata to generator templates. (Aaron Kromer)
+
+Bug Fixes:
+
+* Fix an inconsistency in the generated scaffold specs for a controller. (Andy Waite)
+* Ensure `config.before(:all, :type => <type>)` hooks run before groups
+  of the given type, even when the type is inferred by the file
+  location. (Jon Rowe, Myron Marston)
+* Switch to parsing params with `Rack::Utils::parse_nested_query` to match Rails.
+  (Tim Watson)
+* Fix incorrect namespacing of anonymous controller routes. (Aaron Kromer)
 
-* Improve be_valid matcher for non-ActiveModel::Errors implementations (Ben Hamill)
+### 3.0.0.beta2 / 2014-02-17
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v3.0.0.beta1...v3.0.0.beta2)
 
 Breaking Changes for 3.0.0:
 
@@ -26,56 +47,103 @@ Breaking Changes for 3.0.0:
   enabled by default. (Thomas Holmes)
 * Capybara 2.2.0 or above is required for feature specs. (Andy Lindeman)
 
-### 3.0.0.beta1 / 2013-11-07
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.99.0.beta1...v3.0.0.beta1)
+Enhancements:
 
-Breaking Changes for 3.0.0:
-
-* Extracts `autotest` and `autotest-rails` support to `rspec-autotest` gem.
-  (Andy Lindeman)
+* Improve `be_valid` matcher for non-ActiveModel::Errors implementations (Ben Hamill)
 
-### 2.99.0.beta2 / 2014-02-17
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.99.0.beta1...v2.99.0.beta2)
-
-Bug fixes
+Bug Fixes:
 
 * Use `__send__` rather than `send` to prevent naming collisions (Bradley Schaefer)
 * Supports Rails 4.1. (Andy Lindeman)
+* Routes are drawn correctly for anonymous controllers with abstract
+  parents. (Billy Chan)
 * Loads ActiveSupport properly to support changes in Rails 4.1. (Andy Lindeman)
 * Anonymous controllers inherit from `ActionController::Base` if `ApplicationController`
   is not present. (Jon Rowe)
+* Require `rspec/collection_matchers` when `rspec/rails` is required. (Yuji Nakayama)
+
+### 3.0.0.beta1 / 2013-11-07
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.99.0.rc1...v3.0.0.beta1)
+
+Breaking Changes for 3.0.0:
+
+* Extracts `autotest` and `autotest-rails` support to `rspec-autotest` gem.
+  (Andy Lindeman)
+
+### 2.99.0.rc1 / 2014-05-18
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.99.0.beta2...v2.99.0.rc1)
 
 Deprecations
 
+* Deprecates `stub_model` and `mock_model` in favor of the
+  `rspec-activemodel-mocks` gem. (Thomas Holmes)
+* Issue a deprecation to instruct users to configure
+  `config.infer_spec_type_from_file_location!` during the
+  upgrade process since spec type inference is opt-in in 3.0.
+  (Jon Rowe)
+* Issue a deprecation when `described_class` is accessed in a controller
+  example group that has used the `controller { }` macro to generate an
+  anonymous controller class, since in 2.x, `described_class` would
+  return that generated class but in 3.0 it will continue returning the
+  class passed to `describe`. (Myron Marston)
+
+### 2.99.0.beta2 / 2014-02-17
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.99.0.beta1...v2.99.0.beta2)
+
+Deprecations:
+
 * Deprecates the `--webrat` option to the scaffold and request spec generator (Andy Lindeman)
 * Deprecates the use of `Capybara::DSL` (e.g., `visit`) in controller specs.
   It is more appropriate to use capybara in feature specs (`spec/features`)
   instead. (Andy Lindeman)
 
+Bug Fixes:
+
+* Use `__send__` rather than `send` to prevent naming collisions (Bradley Schaefer)
+* Supports Rails 4.1. (Andy Lindeman)
+* Loads ActiveSupport properly to support changes in Rails 4.1. (Andy Lindeman)
+* Anonymous controllers inherit from `ActionController::Base` if `ApplicationController`
+  is not present. (Jon Rowe)
+
 ### 2.99.0.beta1 / 2013-11-07
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.14.0...v2.99.0.beta1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.14.0...v2.99.0.beta1)
 
-Deprecations
+Deprecations:
 
 * Deprecates autotest integration in favor of the `rspec-autotest` gem. (Andy
   Lindeman)
 
-Enhancements
+Enhancements:
 
 * Supports Rails 4.1 and Minitest 5. (Patrick Van Stee)
 
-Bug fixes
+Bug Fixes:
+
+* Fixes "warning: instance variable @orig\_routes not initialized" raised by
+  controller specs when `--warnings` are enabled. (Andy Lindeman)
+* Where possible, check against the version of ActiveRecord, rather than
+  Rails. It is possible to use some of rspec-rails without all of Rails.
+  (Darryl Pogue)
+* Explicitly depends on `activemodel`. This allows libraries that do not bring
+  in all of `rails` to use `rspec-rails`. (John Firebaugh)
+
+### 2.14.1 / 2013-12-29
+[full changelog](http://github.com/rspec/rspec-rails/compare/v2.14.0...v2.14.1)
+
+Bug Fixes:
 
 * Fixes "warning: instance variable @orig\_routes not initialized" raised by
   controller specs when `--warnings` are enabled. (Andy Lindeman)
 * Where possible, check against the version of ActiveRecord, rather than
   Rails. It is possible to use some of rspec-rails without all of Rails.
   (Darryl Pogue)
+* Supports Rails 4.1 and Minitest 5. (Patrick Van Stee, Andy Lindeman)
 * Explicitly depends on `activemodel`. This allows libraries that do not bring
   in all of `rails` to use `rspec-rails`. (John Firebaugh)
+* Use `__send__` rather than `send` to prevent naming collisions (Bradley Schaefer)
 
 ### 2.14.0 / 2013-07-06
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.14.0.rc1...v2.14.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.14.0.rc1...v2.14.0)
 
 Bug fixes
 
@@ -87,7 +155,7 @@ Bug fixes
   Rails 4. (Andy Lindeman)
 
 ### 2.14.0.rc1 / 2013-05-27
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.13.2...v2.14.0.rc1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.13.2...v2.14.0.rc1)
 
 Enhancements
 
@@ -100,7 +168,7 @@ Bug fixes
   spec/ directory. (Benjamin Fleischer)
 
 ### 2.13.2 / 2013-05-18
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.13.1...v2.13.2)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.13.1...v2.13.2)
 
 Bug fixes
 
@@ -115,7 +183,7 @@ Enhancements
 * Document how the spec/support directory works. (Sam Phippen)
 
 ### 2.13.1 / 2013-04-27
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.13.0...v2.13.1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.13.0...v2.13.1)
 
 Bug fixes
 
@@ -129,7 +197,7 @@ Bug fixes
 * Fix spacing in the install generator template (Taiki ONO)
 
 ### 2.13.0 / 2013-02-23
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.12.2...v2.13.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.12.2...v2.13.0)
 
 Enhancements
 
@@ -144,7 +212,7 @@ Enhancements
   (Rudolf Schmidt)
 
 ### 2.12.2 / 2013-01-12
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.12.1...v2.12.2)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.12.1...v2.12.2)
 
 Bug fixes
 
@@ -156,7 +224,7 @@ Bug fixes
   Lindeman)
 
 ### 2.12.1 / 2013-01-07
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.12.0...v2.12.1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.12.0...v2.12.1)
 
 Bug fixes
 
@@ -171,7 +239,7 @@ Bug fixes
   and generation of URLs from other contexts. (Andy Lindeman)
 
 ### 2.12.0 / 2012-11-12
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.11.4...v2.12.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.11.4...v2.12.0)
 
 Enhancements
 
@@ -192,7 +260,7 @@ Bug fixes
 * Failures message for `be_new_record` are more useful (Andy Lindeman)
 
 ### 2.11.4 / 2012-10-14
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.11.0...v2.11.4)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.11.0...v2.11.4)
 
 Capybara-2.0 integration support:
 
@@ -206,7 +274,7 @@ for background.
 2.11.1, .2, .3 were yanked due to errant documentation.
 
 ### 2.11.0 / 2012-07-07
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.10.1...v2.11.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.10.1...v2.11.0)
 
 Enhancements
 
@@ -225,7 +293,7 @@ Bug fixes
   loads (Andy Lindeman)
 
 ### 2.10.1 / 2012-05-03
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.10.0...v2.10.1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.10.0...v2.10.1)
 
 Bug fixes
 
@@ -235,7 +303,7 @@ Bug fixes
   Rails already does this (Jack Dempsey)
 
 ### 2.10.0 / 2012-05-03
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.9.0...v2.10.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.9.0...v2.10.0)
 
 Bug fixes
 
@@ -250,7 +318,7 @@ Bug fixes
   Strother)
 
 ### 2.9.0 / 2012-03-17
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.8.1...v2.9.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.8.1...v2.9.0)
 
 Enhancements
 
@@ -265,7 +333,7 @@ Bug fixes
 
 ### 2.8.1 / 2012-01-04
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.8.0...v2.8.1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.8.0...v2.8.1)
 
 NOTE: there was a change in rails-3.2.0.rc2 which broke compatibility with
 stub_model in rspec-rails. This release fixes that issue, but it means that
@@ -278,7 +346,7 @@ you'll have to upgrade to rspec-rails-2.8.1 when you upgrade to rails >=
 
 ### 2.8.0 / 2012-01-04
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.8.0.rc2...v2.8.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.8.0.rc2...v2.8.0)
 
 * Enhancements
     * Eliminate deprecation warnings in generated view specs in Rails 3.2
@@ -288,7 +356,7 @@ you'll have to upgrade to rspec-rails-2.8.1 when you upgrade to rails >=
 
 ### 2.8.0.rc2 / 2011-12-19
 
-[full changelog](http://github.com/rspec/rspec-mocks/compare/v2.8.0.rc1...v2.8.0.rc2)
+[Full Changelog](http://github.com/rspec/rspec-mocks/compare/v2.8.0.rc1...v2.8.0.rc2)
 
 * Enhancements
     * Add session hash to generated controller specs (Thiago Almeida)
@@ -300,7 +368,7 @@ you'll have to upgrade to rspec-rails-2.8.1 when you upgrade to rails >=
 
 ### 2.8.0.rc1 / 2011-11-06
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.7.0...v2.8.0.rc1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.7.0...v2.8.0.rc1)
 
 * Enhancements
     * Removed unnecessary "config.mock_with :rspec" from spec_helper.rb (Paul
@@ -316,7 +384,7 @@ you'll have to upgrade to rspec-rails-2.8.1 when you upgrade to rails >=
 
 ### 2.7.0 / 2011-10-16
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.6.1...v2.7.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.6.1...v2.7.0)
 
 * Enhancements
   * `ActiveRecord::Relation` can use the `=~` matcher (Andy Lindeman)
@@ -341,7 +409,7 @@ you'll have to upgrade to rspec-rails-2.8.1 when you upgrade to rails >=
 
 ### 2.6.1 / 2011-05-25
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.6.0...v2.6.1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.6.0...v2.6.1)
 
 This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
@@ -352,7 +420,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.6.0 / 2011-05-12
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.5.0...v2.6.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.5.0...v2.6.0)
 
 * Enhancements
   * rails 3 shortcuts for routing specs (Joe Fiorini)
@@ -376,7 +444,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.5.0 / 2011-02-05
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.4.1...v2.5.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.4.1...v2.5.0)
 
 * Enhancements
   * use index_helper instead of table_name when generating specs (Reza
@@ -391,7 +459,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.4.1 / 2011-01-03
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.4.0...v2.4.1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.4.0...v2.4.1)
 
 * Bug fixes
   * fixed bug caused by including some Rails modules before RSpec's
@@ -399,7 +467,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.4.0 / 2011-01-02
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.3.1...v2.4.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.3.1...v2.4.0)
 
 * Enhancements
   * include ApplicationHelper in helper object in helper specs
@@ -419,7 +487,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.3.1 / 2010-12-16
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.3.0...v2.3.1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.3.0...v2.3.1)
 
 * Bug fixes
   * respond_to? correctly handles 2 args
@@ -427,7 +495,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.3.0 / 2010-12-12
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.2.1...v2.3.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.2.1...v2.3.0)
 
 * Changes
   * Generator no longer generates autotest/autodiscover.rb, as it is no longer
@@ -435,7 +503,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.2.1 / 2010-12-01
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.2.0...v2.2.1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.2.0...v2.2.1)
 
 * Bug fixes
   * Depend on railties, activesupport, and actionpack instead of rails (Piotr
@@ -447,7 +515,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.2.0 / 2010-11-28
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.1.0...v2.2.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.1.0...v2.2.0)
 
 * Enhancements
   * Added stub_template in view specs
@@ -462,7 +530,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.1.0 / 2010-11-07
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.0.1...v2.1.0)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.0.1...v2.1.0)
 
 * Enhancements
   * Move errors_on to ActiveModel to support other AM-compliant ORMs
@@ -473,7 +541,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.0.1 / 2010-10-15
 
-[full changelog](http://github.com/rspec/rspec-rails/compare/v2.0.0...v2.0.1)
+[Full Changelog](http://github.com/rspec/rspec-rails/compare/v2.0.0...v2.0.1)
 
 * Enhancements
   * Add option to not generate request spec (--skip-request-specs)
@@ -486,7 +554,7 @@ This release is compatible with rails-3.1.0.rc1, but not rails-3.1.0.beta1
 
 ### 2.0.0 / 2010-10-10
 
-[full changelog](https://github.com/rspec/rspec-rails/compare/ea6bdef...v2.0.0)
+[Full Changelog](https://github.com/rspec/rspec-rails/compare/ea6bdef...v2.0.0)
 
 * Enhancements
   * ControllerExampleGroup uses controller as the implicit subject by default (Paul Rosania)

data/README.md

@@ -1,4 +1,4 @@
-# rspec-rails [![Build Status](https://secure.travis-ci.org/rspec/rspec-rails.png?branch=master)](http://travis-ci.org/rspec/rspec-rails) [![Code Climate](https://codeclimate.com/github/rspec/rspec-rails.png)](https://codeclimate.com/github/rspec/rspec-rails)
+# rspec-rails [![Build Status](https://secure.travis-ci.org/rspec/rspec-rails.png?branch=master)](http://travis-ci.org/rspec/rspec-rails) [![Code Climate](https://codeclimate.com/github/rspec/rspec-rails.png)](https://codeclimate.com/github/rspec/rspec-rails) [![Inline docs](http://inch-pages.github.io/github/rspec/rspec-rails.png)](http://inch-pages.github.io/github/rspec/rspec-rails)
 
 **rspec-rails** is a testing framework for Rails 3.x and 4.x.
 
@@ -120,10 +120,12 @@ For more information, see [cucumber scenarios for controller
 specs](https://www.relishapp.com/rspec/rspec-rails/docs/controller-specs).
 
 **Note:** To encourage more isolated testing, views are not rendered by default
-in controller specs. If you wish to assert against the contents of the rendered
-view in a controller spec, enable
+in controller specs. If you are verifying discrete view logic, use a
+[view spec](#view-specs).  If you are verifying the behaviour of a controller and
+view together, consider a [request spec](#request-specs). You can use
 [render\_views](https://www.relishapp.com/rspec/rspec-rails/docs/controller-specs/render-views)
-or use a higher-level [request spec](#request-specs).
+if you must verify the rendered view contents within a controller spec, but this is
+not recommended.
 
 ## <a id="request-spec"></a>Request Specs
 
@@ -415,6 +417,31 @@ to be used with `not_to` to specify routes that should not be routable.
 expect(:get => "/widgets/1/edit").not_to be_routable
 ```
 
+## `have_http_status`
+
+* Passes if `response` has a matching HTTP status code
+* The following symbolic status codes are allowed:
+  - `Rack::Utils::SYMBOL_TO_STATUS_CODE`
+  - One of the defined `ActionDispatch::TestResponse` aliases:
+    - `:error`
+    - `:missing`
+    - `:redirect`
+    - `:success`
+* Available in controller, feature, and request specs.
+
+In controller and request specs, apply to the `response` object:
+
+```ruby
+expect(response).to have_http_status(201)
+expect(response).not_to have_http_status(:created)
+```
+
+In feature specs, apply to the `page` object:
+
+```ruby
+expect(page).to have_http_status(:success)
+```
+
 # `rake` tasks
 
 `rspec-rails` defines rake tasks to run the entire test suite (`rake spec`)