Shoulda

Shoulda helps you write more understandable, maintainable Rails-specific tests using Minitest.

The shoulda gem doesn't contain any code of its own; it actually brings behavior from two other gems:

• Shoulda Context
• Shoulda Matchers

See the READMEs for these projects for more information.

Overview

require "test_helper"

class UserTest < ActiveSupport::TestCase
  context "associations" do
    should have_many(:posts)
  end

  context "validations" do
    should validate_presence_of(:email)
    should allow_value("[email protected]").for(:email)
    should_not allow_value("not-an-email").for(:email)
  end

  context "#name" do
    should "consist of first and last name" do
      user = User.new(first_name: "John", last_name: "Smith")
      assert_equal "John Smith", user.name
    end
  end
end

Here, the context and should methods come from Shoulda Context; matchers (e.g. have_many, allow_value) come from Shoulda Matchers.

Compatibility

Shoulda is tested and supported against Ruby 2.2-2.4, Rails 4.2-5.0, and Minitest 5.

Contributing

Shoulda is open source, and we are grateful for everyone who's contributed so far.

If you'd like to contribute, please take a look at the instructions for installing dependencies and crafting a good pull request.

Versioning

Shoulda follows Semantic Versioning 2.0 as defined at http://semver.org.

License

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

About thoughtbot

Shoulda is maintained and funded by thoughtbot, inc. The names and logos for thoughtbot are trademarks of thoughtbot, inc.

We are passionate about open source software. See our other projects. We are available for hire.