# Shoulda Matchers

Ruby gem that provides RSpec and Minitest one-liner matchers for testing Rails models, controllers and routes.


Source: https://findsoftware.frbit.cloud/shoulda-matchers/
Last reviewed: 2026-11-16
Listed since: 2026-11-16

## Record

### Links

- home: https://matchers.shoulda.io
- repository: https://github.com/thoughtbot/shoulda-matchers
- docs: https://matchers.shoulda.io/docs

### Identity

- status: active
- maintainer: Tammer Saleh and thoughtbot, inc.
- maintainerType: unknown
- parent: unknown
- firstRelease: 2011
- hqCountry: unknown

### Kind

- category: testing
- hosting: not applicable
- language: ruby
- runtime: ruby
- runtimeMin: ruby 3.3
- basedOn: rails

### Content

- contentStore: not applicable
- databases: not applicable
- adminUi: not applicable
- headlessApi: not applicable
- templating: not applicable
- i18n: not applicable

### Rendering and deploy

- runsAs: unknown
- renderingModes: not applicable
- installMethod: gem

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 8
- latestReleaseDate: 2026-06-12

### Adoption

- githubStargazers: 3577
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 279
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: 69221
- dependentPackages: 765

### Sources

- urls: https://matchers.shoulda.io/ (read 2026-11-16)
- urls: https://api.github.com/repos/thoughtbot/shoulda-matchers (read 2026-11-16)
- urls: https://matchers.shoulda.io/docs/ (read 2026-11-16)
- category: https://github.com/thoughtbot/shoulda-matchers/blob/main/README.md (read 2026-11-16)
- basedOn: https://raw.githubusercontent.com/thoughtbot/shoulda-matchers/v8.0.1/shoulda-matchers.gemspec (read 2026-11-16)
- language: https://api.github.com/repos/thoughtbot/shoulda-matchers (read 2026-11-16)
- runtime: https://github.com/thoughtbot/shoulda-matchers/blob/main/README.md (read 2026-11-16)
- runtimeMin: https://raw.githubusercontent.com/thoughtbot/shoulda-matchers/v8.0.1/shoulda-matchers.gemspec (read 2026-11-16)
- installMethod: https://github.com/thoughtbot/shoulda-matchers/blob/main/README.md (read 2026-11-16)
- license: https://rubygems.org/api/v1/gems/shoulda-matchers.json (read 2026-11-16)
- licenseModel: https://github.com/thoughtbot/shoulda-matchers/blob/main/README.md (read 2026-11-16)
- maintainer: https://raw.githubusercontent.com/thoughtbot/shoulda-matchers/main/LICENSE (read 2026-11-16)
- firstRelease: https://rubygems.org/api/v1/versions/shoulda-matchers.json (read 2026-11-16)
- currentMajor: https://api.github.com/repos/thoughtbot/shoulda-matchers/releases (read 2026-11-16)
- latestReleaseDate: https://api.github.com/repos/thoughtbot/shoulda-matchers/releases (read 2026-11-16)
- githubStargazers: https://api.github.com/repos/thoughtbot/shoulda-matchers (read 2026-11-16)
- contributors: https://api.github.com/repos/thoughtbot/shoulda-matchers/contributors?per_page=1 (read 2026-11-16)
- dependentPackages: https://packages.ecosyste.ms/api/v1/registries/rubygems.org/packages/shoulda-matchers (read 2026-11-16)
- dependentRepos: https://packages.ecosyste.ms/api/v1/registries/rubygems.org/packages/shoulda-matchers (read 2026-11-16)

## Notes

Shoulda Matchers adds one-line tests for common Rails functionality, such as models, controllers and routes, to RSpec and Minitest suites. The matchers cover ActiveModel, ActiveRecord and ActionController, and the gem is loaded by test suites, in the test group of a Gemfile.

Apps that are not Rails apps but use ActiveRecord or ActiveModel can use the gem too, by naming the library in a configuration block. The gem is copyrighted by Tammer Saleh and thoughtbot, inc, and the README says thoughtbot, inc maintains and funds the repository.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0
