1
0
Fork 0
mirror of https://github.com/thoughtbot/shoulda-matchers.git synced 2022-11-09 12:01:38 -05:00
Simple one-liner tests for common Rails functionality
Find a file
2012-06-06 11:02:43 +03:00
features Use correct version of RSpec in generated Rails app. 2012-04-21 20:48:45 -04:00
gemfiles Add #allow_blank and #allow_nil options to #ensure_inclusion_of . 2012-06-06 11:02:43 +03:00
lib Add #allow_blank and #allow_nil options to #ensure_inclusion_of . 2012-06-06 11:02:43 +03:00
spec Add #allow_blank and #allow_nil options to #ensure_inclusion_of . 2012-06-06 11:02:43 +03:00
.gitignore Unignore Gemfile.lock, per Appraisal instructions. 2012-04-10 22:55:29 -04:00
.travis.yml Correct travis-ci allow_failures syntax 2012-05-11 17:51:05 -04:00
Appraisals Test against Rails 3.2. 2012-04-20 14:35:57 -04:00
CONTRIBUTING.md Update contribution guidelines. 2012-03-18 20:39:15 -04:00
Gemfile get jruby passing 2012-04-13 10:11:42 -04:00
Gemfile.lock Bump rspec-rails. 2012-04-20 14:15:56 -04:00
MIT-LICENSE converted to the MIT license 2007-11-26 15:18:29 +00:00
NEWS.md Add #allow_blank and #allow_nil options to #ensure_inclusion_of . 2012-06-06 11:02:43 +03:00
Rakefile Clean up Rakefile. 2012-04-10 22:53:11 -04:00
README.md Formatting. 2012-04-03 20:01:17 -04:00
shoulda-matchers.gemspec Bump rspec-rails. 2012-04-20 14:15:56 -04:00

shoulda-matchers Build Status

Official Documentation

Test::Unit- and RSpec-compatible one-liners that test common Rails functionality. These tests would otherwise be much longer, more complex, and error-prone.

Refer to the shoulda-context gem if you want to know more about using shoulda with Test::Unit.

ActiveRecord Matchers

Matchers to test associations:

describe Post do
  it { should belong_to(:user) }
  it { should have_many(:tags).through(:taggings) }
end

describe User do
  it { should have_many(:posts) }
end

ActiveModel Matchers

Matchers to test validations and mass assignments:

describe Post do
  it { should validate_uniqueness_of(:title) }
  it { should validate_presence_of(:body).with_message(/wtf/) }
  it { should validate_presence_of(:title) }
  it { should validate_numericality_of(:user_id) }

  # validates_uniqueness_of requires an entry to be in the database already
  it "validates uniqueness of title" do
    Post.create!(title: "My Awesome Post", body: "whatever")
    should validate_uniqueness_of(:title)
  end
end

describe User do
  it { should_not allow_value("blah").for(:email) }
  it { should allow_value("a@b.com").for(:email) }
  it { should ensure_inclusion_of(:age).in_range(1..100) }
  it { should_not allow_mass_assignment_of(:password) }
end

ActionController Matchers

Matchers to test common patterns:

describe PostsController, "#show" do
  context "for a fictional user" do
    before do
      get :show, :id => 1
    end

    it { should assign_to(:user) }
    it { should respond_with(:success) }
    it { should render_template(:show) }
    it { should_not set_the_flash }
  end
end

Installation

In Rails 3 and Bundler, add the following to your Gemfile:

group :test do
  gem "rspec-rails"
  gem "shoulda-matchers"
end

Shoulda will automatically include matchers into the appropriate example groups.

Credits

Shoulda is maintained and funded by thoughtbot. Thank you to all the contributors.

License

Shoulda is Copyright © 2006-2010 thoughtbot, inc. It is free software, and may be redistributed under the terms specified in the MIT-LICENSE file.