Skip to content
Branch: master
Go to file
Code

Latest commit

mcmire committed fabc856 Jun 14, 2020
Update docs
* Update README for consistency across all shoulda-* gems
* Add MAINTAINING
* Drop CONTRIBUTING document since this gem is more or less deprecated

[ci skip]

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Shoulda Gem Version Build Status Downloads Hound

Shoulda helps you write more understandable, maintainable Rails-specific tests under Minitest and Test::Unit.

Quick links

📢 See what's changed in recent versions.

Overview

As an umbrella gem, the shoulda gem doesn't contain any code of its own but rather brings in behavior from two other gems:

For instance:

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("user@example.com").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.

See the READMEs for these projects for more information.

Compatibility

Shoulda is tested and supported against Ruby 2.4+, Rails 4.2+, RSpec 3.x, Minitest 4.x, and Test::Unit 3.x.

Versioning

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

Team

Shoulda is maintained by Elliot Winkler. It was previously maintained by Travis Jeffery.

Copyright/License

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

About thoughtbot

thoughtbot

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.

About

Makes tests easy on the fingers and the eyes

Resources

License

Sponsor this project

 
Learn more about GitHub Sponsors
You can’t perform that action at this time.