shoulda-matchers 2.5.0 → 2.6.0

data/.gitignore

@@ -1,11 +1,12 @@
-test/*/log/*.log
-doc
-coverage
+*.rbc
+*.swo
+*.swp
+.bundle
 .svn/
+.yardoc
+coverage
+doc
 pkg
-*.swp
-*.swo
 tags
+test/*/log/*.log
 tmp
-.bundle
-*.rbc

data/.travis.yml

@@ -20,12 +20,16 @@ matrix:
       gemfile: gemfiles/4.0.0.gemfile
     - rvm: 1.9.3
       gemfile: gemfiles/4.0.1.gemfile
+    - rvm: 1.9.3
+      gemfile: gemfiles/4.1.gemfile
     - rvm: 2.0.0
       gemfile: gemfiles/3.2.gemfile
     - rvm: 2.0.0
       gemfile: gemfiles/4.0.0.gemfile
     - rvm: 2.0.0
       gemfile: gemfiles/4.0.1.gemfile
+    - rvm: 2.0.0
+      gemfile: gemfiles/4.1.gemfile
     - rvm: rbx-19mode
       gemfile: gemfiles/3.2.gemfile
     - rvm: jruby-19mode

data/Appraisals

@@ -43,3 +43,11 @@ appraise '4.0.1' do
   gem 'sass-rails', '4.0.1'
   gem 'bcrypt-ruby', '~> 3.1.2'
 end
+
+appraise '4.1' do
+  instance_eval(&rails_4_0)
+  gem 'rails', '~> 4.1.0'
+  gem 'sass-rails', '4.0.3'
+  gem 'bcrypt-ruby', '~> 3.1.2'
+  gem "protected_attributes", '~> 1.0.6'
+end

data/CONTRIBUTING.md

@@ -3,7 +3,7 @@ We love pull requests. Here's a quick guide:
 1. Fork the repo.
 
 2. Run the tests. We only take pull requests with passing tests, and it's great
-to know that you have a clean slate: `bundle && rake`
+to know that you have a clean slate: `bundle && bundle exec rake`
 
 3. Add a test for your change. Only refactoring and documentation changes
 require no new tests. If you are adding functionality or fixing a bug, we need

data/Gemfile

@@ -3,7 +3,7 @@ source 'https://rubygems.org'
 gemspec
 
 # For test Rails application
-gem 'shoulda-context', '~> 1.1.2'
+gem 'shoulda-context', '~> 1.2.0'
 gem 'sqlite3', :platform => :ruby
 
 # Can't wrap in platform :jruby do...end block because appraisal doesn't support

data/Gemfile.lock

@@ -1,76 +1,84 @@
 PATH
   remote: .
   specs:
-    shoulda-matchers (2.5.0)
+    shoulda-matchers (2.6.0)
       activesupport (>= 3.0.0)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    actionmailer (3.2.9)
-      actionpack (= 3.2.9)
-      mail (~> 2.4.4)
-    actionpack (3.2.9)
-      activemodel (= 3.2.9)
-      activesupport (= 3.2.9)
+    actionmailer (3.2.16)
+      actionpack (= 3.2.16)
+      mail (~> 2.5.4)
+    actionpack (3.2.16)
+      activemodel (= 3.2.16)
+      activesupport (= 3.2.16)
       builder (~> 3.0.0)
       erubis (~> 2.7.0)
       journey (~> 1.0.4)
-      rack (~> 1.4.0)
+      rack (~> 1.4.5)
       rack-cache (~> 1.2)
       rack-test (~> 0.6.1)
       sprockets (~> 2.2.1)
-    activemodel (3.2.9)
-      activesupport (= 3.2.9)
+    activemodel (3.2.16)
+      activesupport (= 3.2.16)
       builder (~> 3.0.0)
-    activerecord (3.2.9)
-      activemodel (= 3.2.9)
-      activesupport (= 3.2.9)
+    activerecord (3.2.16)
+      activemodel (= 3.2.16)
+      activesupport (= 3.2.16)
       arel (~> 3.0.2)
       tzinfo (~> 0.3.29)
-    activeresource (3.2.9)
-      activemodel (= 3.2.9)
-      activesupport (= 3.2.9)
-    activesupport (3.2.9)
-      i18n (~> 0.6)
+    activeresource (3.2.16)
+      activemodel (= 3.2.16)
+      activesupport (= 3.2.16)
+    activesupport (3.2.16)
+      i18n (~> 0.6, >= 0.6.4)
       multi_json (~> 1.0)
-    appraisal (0.5.1)
+    appraisal (1.0.0.beta2)
       bundler
       rake
-    arel (3.0.2)
-    aruba (0.5.1)
+      thor (>= 0.14.0)
+    arel (3.0.3)
+    aruba (0.5.3)
       childprocess (~> 0.3.6)
       cucumber (>= 1.1.1)
       rspec-expectations (>= 2.7.0)
-    bourne (1.4.0)
-      mocha (~> 0.13.2)
+    bourne (1.5.0)
+      mocha (>= 0.13.2, < 0.15)
     builder (3.0.4)
-    childprocess (0.3.6)
-      ffi (~> 1.0, >= 1.0.6)
-    cucumber (1.2.1)
+    childprocess (0.3.9)
+      ffi (~> 1.0, >= 1.0.11)
+    coderay (1.1.0)
+    cucumber (1.3.10)
       builder (>= 2.1.2)
       diff-lcs (>= 1.1.3)
-      gherkin (~> 2.11.0)
-      json (>= 1.4.6)
-    diff-lcs (1.2.1)
+      gherkin (~> 2.12)
+      multi_json (>= 1.7.5, < 2.0)
+      multi_test (>= 0.0.2)
+    diff-lcs (1.2.5)
     erubis (2.7.0)
-    ffi (1.2.0)
-    gherkin (2.11.5)
-      json (>= 1.4.6)
-    hike (1.2.1)
-    i18n (0.6.4)
+    ffi (1.9.3)
+    gherkin (2.12.2)
+      multi_json (~> 1.3)
+    hike (1.2.3)
+    i18n (0.6.9)
     journey (1.0.4)
-    json (1.7.7)
-    mail (2.4.4)
-      i18n (>= 0.4.0)
+    json (1.8.1)
+    mail (2.5.4)
       mime-types (~> 1.16)
       treetop (~> 1.4.8)
     metaclass (0.0.1)
-    mime-types (1.19)
-    mocha (0.13.3)
+    method_source (0.8.2)
+    mime-types (1.25.1)
+    mocha (0.14.0)
       metaclass (~> 0.0.1)
-    multi_json (1.7.1)
+    multi_json (1.8.4)
+    multi_test (0.0.3)
     polyglot (0.3.3)
+    pry (0.9.12.6)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
     rack (1.4.5)
     rack-cache (1.2)
       rack (>= 0.4)
@@ -78,48 +86,50 @@ GEM
       rack
     rack-test (0.6.2)
       rack (>= 1.0)
-    rails (3.2.9)
-      actionmailer (= 3.2.9)
-      actionpack (= 3.2.9)
-      activerecord (= 3.2.9)
-      activeresource (= 3.2.9)
-      activesupport (= 3.2.9)
+    rails (3.2.16)
+      actionmailer (= 3.2.16)
+      actionpack (= 3.2.16)
+      activerecord (= 3.2.16)
+      activeresource (= 3.2.16)
+      activesupport (= 3.2.16)
       bundler (~> 1.0)
-      railties (= 3.2.9)
-    railties (3.2.9)
-      actionpack (= 3.2.9)
-      activesupport (= 3.2.9)
+      railties (= 3.2.16)
+    railties (3.2.16)
+      actionpack (= 3.2.16)
+      activesupport (= 3.2.16)
       rack-ssl (~> 1.3.2)
       rake (>= 0.8.7)
       rdoc (~> 3.4)
       thor (>= 0.14.6, < 2.0)
-    rake (10.0.3)
+    rake (10.1.1)
     rdoc (3.12.2)
       json (~> 1.4)
-    rspec-core (2.13.1)
-    rspec-expectations (2.13.0)
+    rspec-core (2.14.7)
+    rspec-expectations (2.14.4)
       diff-lcs (>= 1.1.3, < 2.0)
-    rspec-mocks (2.13.1)
-    rspec-rails (2.13.2)
+    rspec-mocks (2.14.4)
+    rspec-rails (2.14.1)
       actionpack (>= 3.0)
+      activemodel (>= 3.0)
       activesupport (>= 3.0)
       railties (>= 3.0)
-      rspec-core (~> 2.13.0)
-      rspec-expectations (~> 2.13.0)
-      rspec-mocks (~> 2.13.0)
-    shoulda-context (1.1.4)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    shoulda-context (1.2.0)
+    slop (3.4.7)
     sprockets (2.2.2)
       hike (~> 1.2)
       multi_json (~> 1.0)
       rack (~> 1.0)
       tilt (~> 1.1, != 1.3.0)
-    sqlite3 (1.3.6)
-    thor (0.17.0)
-    tilt (1.3.6)
-    treetop (1.4.12)
+    sqlite3 (1.3.8)
+    thor (0.18.1)
+    tilt (1.4.1)
+    treetop (1.4.15)
       polyglot
       polyglot (>= 0.3.1)
-    tzinfo (0.3.35)
+    tzinfo (0.3.38)
 
 PLATFORMS
   ruby
@@ -127,17 +137,18 @@ PLATFORMS
 DEPENDENCIES
   activerecord-jdbc-adapter
   activerecord-jdbcsqlite3-adapter
-  appraisal (~> 0.4)
+  appraisal (~> 1.0.0.beta2)
   aruba
   bourne (~> 1.3)
   bundler (~> 1.1)
   cucumber (~> 1.1)
   jdbc-sqlite3
   jruby-openssl
+  pry
   rails (~> 3.0)
   rake (>= 0.9.2)
   rspec-rails (>= 2.13.1, < 3)
-  shoulda-context (~> 1.1.2)
+  shoulda-context (~> 1.2.0)
   shoulda-matchers!
   sqlite3
   therubyrhino

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2006-2013, Tammer Saleh, thoughtbot, inc.
+Copyright (c) 2006-2014, Tammer Saleh, thoughtbot, inc.
 
 Permission is hereby granted, free of charge, to any person
 obtaining a copy of this software and associated documentation

data/NEWS.md

@@ -1,4 +1,66 @@
-# HEAD
+# 2.6.0
+
+* The boolean argument to `have_db_index`'s `unique` option is now optional, for
+  consistency with other matchers.
+
+* Association matchers now test that the model being referred to (either
+  implicitly or explicitly, using `:class_name`) actually exists.
+
+* Add ability to test `:autosave` option on associations.
+
+* Fix `validate_uniqueness_of(...).allow_nil` so that it can be used against an
+  non-password attribute which is in a model that `has_secure_password`. Doing
+  so previously would result in a "Password digest missing on new record" error.
+
+* Fix description for `validate_numericality_of` so that if the matcher fails,
+  the error message reported does not say the matcher accepts integer values if
+  you didn't specify that.
+
+* Fix `ensure_inclusion_of` so that you can use it against a boolean column
+  (and pass boolean values to `in_array`). There are two caveats:
+
+  * You should not test that your attribute allows both true and false
+    (`.in_array([true, false]`); there's no way to test that it doesn't accept
+    anything other than that.
+  * You cannot test that your attribute allows nil (`.in_array([nil])`) if
+    the column does not allow null values.
+
+* Change `validate_uniqueness_of(...)` so that it provides default values for
+  non-nullable attributes.
+
+* Running `rake` now installs Appraisals before running the test suite. 
+  (Additionally, we now manage Appraisals using the `appraisal` executable in
+  Appraisal 1.0.0.)
+
+* Add `allow_nil` option to `validate_numericality_of` so that you can validate
+  that numeric values are validated only if a value is supplied.
+
+* Fix `validate_numericality_of` so that test fails when the value with
+  `greater_than`, `greater_than_or_equal_to`, `less_than`, `less_than_or_equal_
+  to` or `equal_to` is not appropriate.
+
+* Change `validate_presence_of` under Rails 4 so that if you are using it with a
+  user whose model `has_secure_password` and whose password is set to a value,
+  you will be instructed to use a user whose password is blank instead. The
+  reason for this change is due to the fact that Rails 4's version of
+  `has_secure_password` defines #password= such that `nil` will be ignored,
+  which interferes with how `validate_presence_of` works.
+
+* Add ability to test `belongs_to` associations defined with `:inverse_of`.
+
+* Add back matchers that were removed in 2.0.0: `permit`, for testing strong
+  parameters, and `delegate_method`, for testing delegation.
+
+* Add new matchers for testing controller filters: `before_filter`,
+  `after_filter`, and `around_filter` (aliased to `before_action`,
+  `after_action` and `around_action` for Rails 4).
+
+* Fix `rescue_from` matcher so that it does not raise an error when testing
+  a method handler which has been marked as protected or private.
+
+* Fix compatibility issues with Rails 4.1:
+  * `set_the_flash` and `have_and_belongs_to_many` no longer raise errors
+  * Minitest no longer prints warnings whenever shoulda-matchers is required
 
 # v 2.5.0
 

data/README.md

@@ -8,7 +8,9 @@ complex, and error-prone.
 
 ## Installation
 
-Simply add the following to your Gemfile:
+### RSpec
+
+Include the gem in your Gemfile:
 
 ```ruby
 group :test do
@@ -16,17 +18,45 @@ group :test do
 end
 ```
 
-shoulda-matchers automatically includes itself into your test framework. It will
-mix in the appropriate matchers for ActiveRecord, ActiveModel, and
-ActionController depending on the modules that are available at runtime. For
-instance, in order to use the ActiveRecord matchers, ActiveRecord must be
-available beforehand.
+### Test::Unit
+
+shoulda-matchers was originally a component of
+[Shoulda](http://github.com/thoughtbot/shoulda) -- it's what provides the nice
+`should` syntax which is demonstrated below. For this reason, include it in
+your Gemfile instead:
+
+```ruby
+group :test do
+  gem 'shoulda'
+end
+```
+
+### Non-Rails apps
+
+Once it is loaded, shoulda-matchers automatically includes itself into your test
+framework. It will mix in the appropriate matchers for ActiveRecord,
+ActiveModel, and ActionController depending on the modules that are available at
+runtime. For instance, in order to use the ActiveRecord matchers, ActiveRecord
+must be available beforehand.
 
 If your application is on Rails, everything should "just work", as
 shoulda-matchers will most likely be declared after Rails in your Gemfile. If
 your application is on another framework such as Sinatra or Padrino, you may
 have a different setup, so you will want to ensure that you are requiring
-shoulda-matchers after the components of Rails you are using.
+shoulda-matchers after the components of Rails you are using. For instance,
+if you wanted to use and test against ActiveModel, you'd say:
+
+```ruby
+gem 'activemodel'
+gem 'shoulda-matchers'
+```
+
+and not:
+
+```ruby
+gem 'shoulda-matchers'
+gem 'activemodel'
+```
 
 ## Usage
 
@@ -38,7 +68,7 @@ Different matchers apply to different parts of Rails:
 
 ### ActiveModel Matchers
 
-*Jump to: [allow_mass_assignment_of](#allow_mass_assignment_of), [allow_value / disallow_value](#allow_value--disallow_value), [ensure_inclusion_of](#ensure_inclusion_of), [ensure_exclusion_of](#ensure_exclusion_of), [ensure_length_of](#ensure_length_of), [have_secure_password](#have_secure_password), [validate_absence_of](#validate_absence_of), [validate_acceptance_of](#validate_acceptance_of), [validate_confirmation_of](#validate_confirmation_of), [validate_numericality_of](#validate_numericality_of), [validate_presence_of](#validate_presence_of), [validate_uniqueness_of](#validate_uniqueness_of)*
+*Jump to: [allow_mass_assignment_of](#allow_mass_assignment_of), [allow_value](#allow_value), [ensure_inclusion_of](#ensure_inclusion_of), [ensure_exclusion_of](#ensure_exclusion_of), [ensure_length_of](#ensure_length_of), [have_secure_password](#have_secure_password), [validate_absence_of](#validate_absence_of), [validate_acceptance_of](#validate_acceptance_of), [validate_confirmation_of](#validate_confirmation_of), [validate_numericality_of](#validate_numericality_of), [validate_presence_of](#validate_presence_of), [validate_uniqueness_of](#validate_uniqueness_of)*
 
 Note that all of the examples in this section are based on an ActiveRecord
 model for simplicity, but these matchers will work just as well using an
@@ -81,7 +111,7 @@ class UserTest < ActiveSupport::TestCase
 end
 ```
 
-#### allow_value / disallow_value
+#### allow_value
 
 The `allow_value` matcher tests usage of the `validates_format_of` validation.
 It asserts that an attribute can be set to one or more values, succeeding if
@@ -105,7 +135,11 @@ describe UserProfile do
   it { should allow_value('http://foo.com', 'http://bar.com/baz').for(:website_url) }
   it { should_not allow_value('asdfjkl').for(:website_url) }
 
-  it { should allow_value(:birthday_as_string).on(:create) }
+  it do
+    should allow_value('2013-01-01').
+      for(:birthday_as_string).
+      on(:create)
+  end
 
   it do
     should allow_value('open', 'closed').
@@ -119,7 +153,9 @@ class UserProfileTest < ActiveSupport::TestCase
   should allow_value('http://foo.com', 'http://bar.com/baz').for(:website_url)
   should_not allow_value('asdfjkl').for(:website_url)
 
-  should allow_value(:birthday_as_string).on(:create)
+  should allow_value('2013-01-01').
+    for(:birthday_as_string).
+    on(:create)
 
   should allow_value('open', 'closed').
     for(:state).
@@ -139,18 +175,6 @@ describe User do
 end
 ```
 
-The `disallow_value` matcher is the exact opposite of `allow_value`. That is,
-`should_not allow_value` can also be written `should disallow_value`, and
-`should allow_value` can also be written `should_not disallow_value`. Because
-of this, it carries the same caveat when multiple values are provided:
-
-```ruby
-describe User do
-  # 'b' and 'c' will not be tested
-  it { should disallow_value('a', 'b', 'c').for(:website_url) }
-end
-```
-
 #### ensure_inclusion_of
 
 The `ensure_inclusion_of` matcher tests usage of the `validates_inclusion_of`
@@ -169,8 +193,8 @@ end
 
 # RSpec
 describe Issue do
-  it { should ensure_inclusion_of(:state).in_array(%w(open resolved unresolved))
-  it { should ensure_inclusion_of(:state).in_range(1..5) }
+  it { should ensure_inclusion_of(:state).in_array(%w(open resolved unresolved)) }
+  it { should ensure_inclusion_of(:priority).in_range(1..5) }
 
   it do
     should ensure_inclusion_of(:severity).
@@ -182,7 +206,7 @@ end
 # Test::Unit
 class IssueTest < ActiveSupport::TestCase
   should ensure_inclusion_of(:state).in_array(%w(open resolved unresolved))
-  should ensure_inclusion_of(:state).in_range(1..5)
+  should ensure_inclusion_of(:priority).in_range(1..5)
 
   should ensure_inclusion_of(:severity).
     in_array(%w(low medium high)).
@@ -259,7 +283,7 @@ describe User do
     should ensure_length_of(:api_token).
       is_at_least(10).
       is_at_most(20).
-      message('Password must be in between 10 and 20 characters')
+      with_message('Password must be in between 10 and 20 characters')
   end
 
   it do
@@ -281,7 +305,7 @@ class UserTest < ActiveSupport::TestCase
   should ensure_length_of(:api_token).
     is_at_least(15).
     is_at_most(20).
-    message('Password must be in between 15 and 20 characters')
+    with_message('Password must be in between 15 and 20 characters')
 
   should ensure_length_of(:secret_key).
     is_at_least(15).
@@ -424,6 +448,7 @@ class Person < ActiveRecord::Base
   validates_numericality_of :birth_year, less_than_or_equal_to: 1987
   validates_numericality_of :birth_day, odd: true
   validates_numericality_of :birth_month, even: true
+  validates_numericality_of :rank, less_than_or_equal_to: 10, allow_nil: true
 
   validates_numericality_of :number_of_dependents,
     message: 'Number of dependents must be a number'
@@ -443,7 +468,7 @@ describe Person do
 
   it do
     should validate_numericality_of(:number_of_dependents).
-      with_message('Number of dependents must be a number' }
+      with_message('Number of dependents must be a number')
   end
 end
 
@@ -506,7 +531,7 @@ end
 # RSpec
 describe Post do
   it { should validate_uniqueness_of(:permalink) }
-  it { should validate_uniqueness_of(:slug).scoped_to(:journal_id) }
+  it { should validate_uniqueness_of(:slug).scoped_to(:user_id) }
   it { should validate_uniqueness_of(:key).case_insensitive }
   it { should validate_uniqueness_of(:author_id).allow_nil }
 
@@ -519,7 +544,7 @@ end
 # Test::Unit
 class PostTest < ActiveSupport::TestCase
   should validate_uniqueness_of(:permalink)
-  should validate_uniqueness_of(:slug).scoped_to(:journal_id)
+  should validate_uniqueness_of(:slug).scoped_to(:user_id)
   should validate_uniqueness_of(:key).case_insensitive
   should validate_uniqueness_of(:author_id).allow_nil
 
@@ -884,7 +909,7 @@ end
 
 ### ActionController Matchers
 
-*Jump to: [filter_param](#filter_param), [redirect_to](#redirect_to), [render_template](#render_template), [render_with_layout](#render_with_layout), [rescue_from](#rescue_from), [respond_with](#respond_with), [route](#route), [set_session](#set_session), [set_the_flash](#set_the_flash)*
+*Jump to: [filter_param](#filter_param), [permit](#permit), [redirect_to](#redirect_to), [render_template](#render_template), [render_with_layout](#render_with_layout), [rescue_from](#rescue_from), [respond_with](#respond_with), [route](#route), [set_session](#set_session), [set_the_flash](#set_the_flash), [use_after_filter / use_after_action](#use_after_filter--use_after_action), [use_around_filter / use_around_action](#use_around_filter--use_around_action), [use_before_filter / use_around_action](#use_before_filter--use_before_action)*
 
 #### filter_param
 
@@ -906,6 +931,34 @@ class ApplicationControllerTest < ActionController::TestCase
 end
 ```
 
+#### permit
+
+The `permit` matcher tests that only whitelisted parameters are permitted.
+
+```ruby
+class UserController < ActionController::Base
+  def create
+    User.create(user_params)
+  end
+
+  private
+
+  def user_params
+    params.require(:user).permit(:email)
+  end
+end
+
+# RSpec
+describe UserController do
+  it { should permit(:email).for(:create) }
+end
+
+# Test::Unit
+class UserControllerTest < ActionController::TestCase
+  should permit(:email).for(:create)
+end
+```
+
 #### redirect_to
 
 The `redirect_to` matcher tests that an action redirects to a certain location.
@@ -1226,6 +1279,109 @@ class PostsControllerTest < ActionController::TestCase
 end
 ```
 
+#### use_after_filter / use_after_action
+
+The `use_after_filter` ensures a given `after_filter` is used. This is also
+available as `use_after_action` to provide Rails 4 support.
+
+```ruby
+class UserController < ActionController::Base
+  after_filter :log_activity
+end
+
+# RSpec
+describe UserController do
+  it { should use_after_filter(:log_activity) }
+end
+
+# Test::Unit
+class UserControllerTest < ActionController::TestCase
+  should use_after_filter(:log_activity)
+end
+```
+
+#### use_around_filter / use_around_action
+
+The `use_around_filter` ensures a given `around_filter` is used. This is also
+available as `use_around_action` to provide Rails 4 support.
+
+```ruby
+class UserController < ActionController::Base
+  around_filter :log_activity
+end
+
+# RSpec
+describe UserController do
+  it { should use_around_filter(:log_activity) }
+end
+
+# Test::Unit
+class UserControllerTest < ActionController::TestCase
+  should use_around_filter(:log_activity)
+end
+```
+
+#### use_before_filter / use_before_action
+
+The `use_before_filter` ensures a given `before_filter` is used. This is also
+available as `use_before_action` for Rails 4 support.
+
+```ruby
+class UserController < ActionController::Base
+  before_filter :authenticate_user!
+end
+
+# RSpec
+describe UserController do
+  it { should use_before_filter(:authenticate_user!) }
+end
+
+# Test::Unit
+class UserControllerTest < ActionController::TestCase
+  should use_before_filter(:authenticate_user!)
+end
+```
+
+## Independent Matchers
+
+Matchers to test non-Rails-dependent code:
+
+#### delegate_method
+
+```ruby
+class Human < ActiveRecord::Base
+  has_one :robot
+  delegate :work, to: :robot
+
+  # alternatively, if you are not using Rails
+  def work
+    robot.work
+  end
+
+  def protect
+    robot.protect('Sarah Connor')
+  end
+
+  def speak
+    robot.beep_boop
+  end
+end
+
+# RSpec
+describe Human do
+  it { should delegate_method(:work).to(:robot) }
+  it { should delegate_method(:protect).to(:robot).with_arguments('Sarah Connor') }
+  it { should delegate_method(:beep_boop).to(:robot).as(:speak) }
+end
+
+# Test::Unit
+class HumanTest < ActiveSupport::TestCase
+  should delegate_method(:work).to(:robot)
+  should delegate_method(:protect).to(:robot).with_arguments('Sarah Connor')
+  should delegate_method(:beep_boop).to(:robot).as(:speak)
+end
+```
+
 ## Versioning
 
 shoulda-matchers follows Semantic Versioning 2.0 as defined at
@@ -1238,7 +1394,7 @@ to all the [contributors][contributors].
 
 ## License
 
-shoulda-matchers is copyright © 2006-2013 thoughtbot, inc. It is free software,
+shoulda-matchers is copyright © 2006-2014 thoughtbot, inc. It is free software,
 and may be redistributed under the terms specified in the
 [MIT-LICENSE](MIT-LICENSE) file.