https://github.com/rspec/rspec

The RSpec monorepo
https://github.com/rspec/rspec

Keywords from Contributors

rspec activerecord activejob mvc rubygems rack rubocop code-formatter static-code-analysis sinatra

Last synced: about 22 hours ago
JSON representation

Repository metadata

The RSpec monorepo

Host: GitHub
URL: https://github.com/rspec/rspec
Owner: rspec
License: mit
Created: 2024-11-27T01:05:29.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2026-02-27T18:04:02.000Z (4 days ago)
Last Synced: 2026-03-01T09:17:31.618Z (2 days ago)
Language: Ruby
Size: 13.3 MB
Stars: 90
Watchers: 7
Forks: 37
Open Issues: 156
Releases: 0
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md

rspec

This is the RSpec mono repo, it contains the core gems we think of as "rspec", they are:

rspec-core provides the structure for writing executable examples of how your
code should behave, and an rspec command with tools to constrain which
examples get run and tailor the output.
rspec-expectations lets you express expected outcomes on an object in an example.
rspec-mocks is a test-double framework for rspec with support for method stubs,
fakes, and message expectations on generated test-doubles and real objects
alike.
rspec-support provides shared helper functionality for the other three gems, in
general you don't install this on its own.

Install

gem install rspec              # for rspec-core, rspec-expectations and rspec-mocks
gem install rspec-core         # for rspec-core only
gem install rspec-expectations # for rspec-expectations only
gem install rspec-mocks        # for rspec-mocks only

Want to run against the main branch? You'll need to include the dependent
RSpec repos as well. Add the following to your Gemfile:

%w[rspec rspec-core rspec-expectations rspec-mocks rspec-support].each do |lib|
  if lib == 'rspec'
    gem lib, git: "https://github.com/rspec/rspec"
  else
    gem lib, git: "https://github.com/rspec/rspec", glob: "#{lib}/#{lib}.gemspec"
  end
end

The `rspec` Command

If you install the rspec-core gem, it installs the rspec executable,
which you'll use to run rspec. The rspec command comes with many useful
options.

Run rspec --help to see the complete list.

Getting started:

RSpec uses the words "describe" and "it" so we can express concepts like a conversation:

"Describe a calculator."
"It adds together numbers."

e.g.

# in spec/calculator_spec.rb
RSpec.describe Calculator do
  describe '#add' do
    it 'returns the sum of its arguments' do
      expect(Calculator.new.add(1, 2)).to eq(3)
    end
  end
end

Run this with the rspec command, and watch it fail:

$ rspec spec/calculator_spec.rb
./spec/calculator_spec.rb:1: uninitialized constant Calculator

Address the failure by defining a skeleton of the Calculator class:

# in lib/calculator.rb
class Calculator
  def add(a, b)
  end
end

Be sure to require the implementation file in the spec:

# in spec/calculator_spec.rb
# - RSpec adds ./lib to the $LOAD_PATH
require "calculator"

Now run the spec again, and watch the expectation fail:

$ rspec spec/calculator_spec.rb
F

Failures:

  1) Calculator#add returns the sum of its arguments
     Failure/Error: expect(Calculator.new.add(1, 2)).to eq(3)

       expected: 3
            got: nil

       (compared using ==)
     # ./spec/calculator_spec.rb:6:in `block (3 levels) in <top (required)>'

Finished in 0.00131 seconds (files took 0.10968 seconds to load)
1 example, 1 failure

Failed examples:

rspec ./spec/calculator_spec.rb:5 # Calculator#add returns the sum of its arguments

Implement the simplest solution, by changing the definition of Calculator#add to:

def add(a, b)
  a + b
end

Now run the spec again, and watch it pass:

$ rspec spec/calculator_spec.rb
.

Finished in 0.000315 seconds
1 example, 0 failures

Use the documentation formatter to see the resulting spec:

$ rspec spec/calculator_spec.rb --format doc
Calculator
  #add
    returns the sum of its arguments

Finished in 0.000379 seconds
1 example, 0 failures

Contributing

Once you've set up the environment, you'll need to cd into the working
directory of whichever repo you want to work in. From there you can run the
specs and cucumber features, and make patches.

Also see

https://github.com/rspec/rspec-rails

Owner metadata

Name: RSpec
Login: rspec
Email:
Kind: organization
Description:
Website: http://rspec.info
Location:
Twitter:
Company:
Icon url: https://avatars.githubusercontent.com/u/22388?v=4
Repositories: 18
Last ynced at: 2024-03-25T19:34:00.441Z
Profile URL: https://github.com/rspec

GitHub Events

Total

Delete event: 50
Pull request event: 147
Fork event: 25
Issues event: 166
Watch event: 76
Issue comment event: 198
Push event: 280
Pull request review event: 80
Pull request review comment event: 80
Create event: 107

Last Year

Delete event: 26
Pull request event: 65
Fork event: 15
Issues event: 40
Watch event: 40
Issue comment event: 124
Push event: 179
Pull request review event: 31
Pull request review comment event: 35
Create event: 43

Committers metadata

Last synced: 3 days ago

Total Commits: 10,496
Total Committers: 655
Avg Commits per committer: 16.024
Development Distribution Score (DDS): 0.729

Commits in past year: 192
Committers in past year: 16
Avg Commits per committer in past year: 12.0
Development Distribution Score (DDS) in past year: 0.328

Name	Email	Commits
Myron Marston	m**n@g**m	2841
David Chelimsky	d**y@g**m	2399
Jon Rowe	h**o@j**k	2215
Sam Phippen	s**n@g**m	308
Andy Lindeman	a**n@g**m	144
Chad Humphries	c**d@s**m	126
Xavier Shay	x**r@r**t	124
Justin Ko	j**0@g**m	121
Yuji Nakayama	n**j@g**m	107
Phil Pirozhkov	h**o@f**u	103
Benoit Tigeot	b**t@h**m	95
Aaron Kromer	a**r@g**m	72
Bradley Schaefer	b**r@g**m	63
Eric Mueller	n**a@g**m	51
lucapette	l**e@g**m	25
Sidu Ponnappa	c**a@g**m	21
Pete Higgins	p**e@p**g	19
Charlie Maffitt	c**t@h**m	18
Greggory Rothmeier	g**g@h**m	18
Olle Jonsson	o**n@g**m	18
Marc-Andre Lafortune	g**b@m**a	17
Pritesh Jain	p**6@g**m	16
ydah	1****h	16
Michi Huber	m**r@g**m	16
Joe Ferris	j**s@t**m	15
Benjamin Fleischer	g**b@b**m	15
sleepingkingstudios	m**n@s**m	14
Peter Goldstein	p**n@g**m	14
Baden Ashford	b**d@g**m	14
Ben Hoskings	b**n@h**t	13
and 625 more...

Committer domains:

Issue and Pull Request metadata

Last synced: 3 days ago

Total issues: 144
Total pull requests: 153
Average time to close issues: 3 months
Average time to close pull requests: 20 days
Total issue authors: 123
Total pull request authors: 25
Average comments per issue: 5.78
Average comments per pull request: 0.88
Merged pull request: 67
Bot issues: 0
Bot pull requests: 0

Past year issues: 41
Past year pull requests: 68
Past year average time to close issues: 15 days
Past year average time to close pull requests: 5 days
Past year issue authors: 38
Past year pull request authors: 18
Past year average comments per issue: 1.88
Past year average comments per pull request: 0.91
Past year merged pull request: 44
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/rspec/rspec

Top Issue Authors

myronmarston (11)
mtasaka (4)
pirj (3)
jrmhaig (2)
xaviershay (2)
JonRowe (2)
benoittgt (2)
maxlinc (2)
nevinera (2)
HoneyryderChuck (1)
bannable (1)
swiknaba (1)
sorah (1)
cconstantine (1)
maxmeyer (1)

Top Pull Request Authors

JonRowe (98)
pirj (13)
benoittgt (5)
jrmhaig (4)
chadlwilson (4)
AnthonyClark (3)
byroot (3)
bquorning (3)
neilvcarvalho (2)
viralpraxis (2)
MaxLap (2)
nevinera (1)
lekemula (1)
G-Rath (1)
dguardado (1)

Top Issue Labels

Feature (11)
documentation (3)
bug (3)
good first issue (1)
3-99 (1)

Top Pull Request Labels

3-99 (7)
4-0 (7)
rspec-expectations (2)
rspec-core (2)
rspec-mocks (1)

Package metadata

Total packages: 13
Total downloads:
- rubygems: 10,771,839,968 total
Total docker downloads: 37,817,842,664
Total dependent packages: 62,308 (may contain duplicates)
Total dependent repositories: 1,806,807 (may contain duplicates)
Total versions: 1,308
Total maintainers: 5

gem.coop: rspec-expectations

rspec-expectations provides a simple, readable API to express expected outcomes of a code example.

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec-expectations/
Licenses: MIT
Latest release: 3.13.5 (published 9 months ago)
Last Synced: 2026-03-01T13:02:27.619Z (2 days ago)
Versions: 126
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 1,113,712,049 Total
Docker Downloads: 3,793,730,932
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.003%
- Downloads: 0.009%
Maintainers (1)
- JonRowe

gem.coop: rspec-core

BDD for Ruby. RSpec runner and example groups.

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec-core/
Licenses: MIT
Latest release: 3.13.6 (published 5 months ago)
Last Synced: 2026-02-28T17:01:50.320Z (3 days ago)
Versions: 149
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 1,112,893,091 Total
Docker Downloads: 3,793,561,496
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.003%
- Downloads: 0.009%
Maintainers (1)
- JonRowe

gem.coop: rspec-support

Support utilities for RSpec gems

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec-support/
Licenses: MIT
Latest release: 3.13.7 (published about 1 month ago)
Last Synced: 2026-03-01T08:03:13.099Z (2 days ago)
Versions: 53
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 1,098,209,736 Total
Docker Downloads: 3,734,949,580
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.004%
- Downloads: 0.011%
Maintainers (1)
- JonRowe

gem.coop: rspec-mocks

RSpec's 'test double' framework, with support for stubbing and mocking

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec-mocks/
Licenses: MIT
Latest release: 3.13.8 (published 4 days ago)
Last Synced: 2026-03-01T16:02:16.288Z (2 days ago)
Versions: 135
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 1,107,116,330 Total
Docker Downloads: 3,793,351,416
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.005%
- Downloads: 0.01%
- Docker downloads count: 0.011%
Maintainers (1)
- JonRowe

gem.coop: rspec

BDD for Ruby

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec/
Licenses: MIT
Latest release: 3.13.2 (published 4 months ago)
Last Synced: 2026-02-27T18:01:22.057Z (4 days ago)
Versions: 173
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 954,029,461 Total
Docker Downloads: 3,793,327,908
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 0.006%
- Docker downloads count: 0.012%
- Downloads: 0.014%
Maintainers (1)
- JonRowe

rubygems.org: rspec

BDD for Ruby

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec/
Licenses: MIT
Latest release: 3.13.2 (published 4 months ago)
Last Synced: 2026-03-01T06:31:14.696Z (2 days ago)
Versions: 173
Dependent Packages: 60,331
Dependent Repositories: 350,079
Downloads: 954,305,878 Total
Docker Downloads: 3,793,327,908
Rankings:
- Dependent packages count: 0.001%
- Downloads: 0.012%
- Dependent repos count: 0.057%
- Docker downloads count: 0.059%
- Average: 0.425%
- Stargazers count: 0.685%
- Forks count: 1.736%
Maintainers (4)

rubygems.org: rspec-core

BDD for Ruby. RSpec runner and example groups.

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec-core/
Licenses: MIT
Latest release: 3.13.6 (published 5 months ago)
Last Synced: 2026-02-28T18:31:39.760Z (3 days ago)
Versions: 149
Dependent Packages: 645
Dependent Repositories: 397,977
Downloads: 1,112,900,019 Total
Docker Downloads: 3,793,561,496
Rankings:
- Downloads: 0.005%
- Dependent repos count: 0.047%
- Docker downloads count: 0.056%
- Dependent packages count: 0.071%
- Average: 0.459%
- Forks count: 0.825%
- Stargazers count: 1.751%
Maintainers (1)
- JonRowe

rubygems.org: rspec-expectations

rspec-expectations provides a simple, readable API to express expected outcomes of a code example.

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec-expectations/
Licenses: MIT
Latest release: 3.13.5 (published 9 months ago)
Last Synced: 2026-02-28T21:30:52.313Z (3 days ago)
Versions: 126
Dependent Packages: 578
Dependent Repositories: 398,836
Downloads: 1,113,600,166 Total
Docker Downloads: 3,793,730,932
Rankings:
- Downloads: 0.004%
- Dependent repos count: 0.046%
- Docker downloads count: 0.056%
- Dependent packages count: 0.079%
- Average: 0.547%
- Forks count: 1.363%
- Stargazers count: 1.731%
Maintainers (1)
- JonRowe

rubygems.org: rspec-mocks

RSpec's 'test double' framework, with support for stubbing and mocking

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec-mocks/
Licenses: MIT
Latest release: 3.13.8 (published 4 days ago)
Last Synced: 2026-02-28T16:01:14.329Z (3 days ago)
Versions: 135
Dependent Packages: 718
Dependent Repositories: 397,261
Downloads: 1,106,948,319 Total
Docker Downloads: 3,793,351,416
Rankings:
- Downloads: 0.006%
- Dependent repos count: 0.047%
- Docker downloads count: 0.057%
- Dependent packages count: 0.064%
- Average: 0.575%
- Forks count: 1.475%
- Stargazers count: 1.8%
Maintainers (4)

rubygems.org: rspec-support

Support utilities for RSpec gems

Homepage: https://rspec.info
Documentation: http://www.rubydoc.info/gems/rspec-support/
Licenses: MIT
Latest release: 3.13.7 (published about 1 month ago)
Last Synced: 2026-02-28T20:00:37.348Z (3 days ago)
Versions: 53
Dependent Packages: 36
Dependent Repositories: 262,654
Downloads: 1,098,120,577 Total
Docker Downloads: 3,734,949,580
Rankings:
- Downloads: 0.007%
- Docker downloads count: 0.057%
- Dependent repos count: 0.089%
- Dependent packages count: 0.685%
- Average: 1.564%
- Forks count: 2.661%
- Stargazers count: 5.884%
Maintainers (1)
- JonRowe

proxy.golang.org: github.com/rspec/rspec

Homepage:
Documentation: https://pkg.go.dev/github.com/rspec/rspec#section-documentation
Licenses: mit
Latest release: v3.13.4+incompatible (published 10 months ago)
Last Synced: 2026-02-27T18:01:29.202Z (4 days ago)
Versions: 34
Dependent Packages: 0
Dependent Repositories: 0
Rankings:
- Stargazers count: 1.273%
- Forks count: 1.795%
- Average: 5.861%
- Dependent packages count: 9.576%
- Dependent repos count: 10.802%

gem.coop: sspec

BDD for Ruby

Homepage: http://github.com/rspec
Documentation: http://www.rubydoc.info/gems/sspec/
Licenses: MIT
Latest release: 3.8.0 (published almost 7 years ago)
Last Synced: 2026-02-27T18:01:20.953Z (4 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 2,171 Total
Rankings:
- Dependent repos count: 0.0%
- Dependent packages count: 0.0%
- Average: 31.234%
- Downloads: 93.703%
Maintainers (1)
- mensfeld

rubygems.org: sspec

BDD for Ruby

Homepage: http://github.com/rspec
Documentation: http://www.rubydoc.info/gems/sspec/
Licenses: MIT
Latest release: 3.8.0 (published almost 7 years ago)
Last Synced: 2026-02-27T18:01:21.124Z (4 days ago)
Versions: 1
Dependent Packages: 0
Dependent Repositories: 0
Downloads: 2,171 Total
Rankings:
- Dependent packages count: 15.706%
- Dependent repos count: 46.782%
- Average: 52.909%
- Downloads: 96.239%
Maintainers (1)
- mensfeld

Dependencies

.github/workflows/ci.yml actions

.github/workflows/documentation_coverage.yml actions

actions/checkout v4 composite
ruby/setup-ruby v1 composite

.github/workflows/rspec.yml actions

actions/checkout v4 composite
ruby/setup-ruby v1 composite

.github/workflows/rubocop.yml actions

actions/checkout v4 composite
ruby/setup-ruby v1 composite

Gemfile rubygems

github-markup >= 0 development
redcarpet >= 0 development
simplecov >= 0 development
webrick ~> 1.9.1 development
yard ~> 0.9.24 development
aruba >= 1.1.0, < 3.0.0
coderay >= 0
flexmock ~> 0.9.0
jruby-openssl >= 0
minitest ~> 5.12.0
mocha ~> 0.13.0
rake >= 13.0.0
rr ~> 1.0.4
test-unit ~> 3.0
thread_order ~> 1.1.0

rspec/rspec.gemspec rubygems

rspec-core/rspec-core.gemspec rubygems

rspec-expectations/rspec-expectations.gemspec rubygems

diff-lcs >= 1.6.0, < 2.0

rspec-mocks/rspec-mocks.gemspec rubygems

diff-lcs >= 1.6.0, < 2.0

rspec-support/rspec-support.gemspec rubygems

Score: 36.59668291120746

https://github.com/rspec/rspec

Keywords from Contributors

Repository metadata

README.md

rspec

Install

The rspec Command

Getting started:

Contributing

Also see

Owner metadata

GitHub Events

Total

Last Year

Committers metadata

Committer domains:

Issue and Pull Request metadata

Top Issue Authors

Top Pull Request Authors

Top Issue Labels

Top Pull Request Labels

Package metadata

gem.coop: rspec-expectations

gem.coop: rspec-core

gem.coop: rspec-support

gem.coop: rspec-mocks

gem.coop: rspec

rubygems.org: rspec

rubygems.org: rspec-core

rubygems.org: rspec-expectations

rubygems.org: rspec-mocks

rubygems.org: rspec-support

proxy.golang.org: github.com/rspec/rspec

gem.coop: sspec

rubygems.org: sspec

Dependencies

The `rspec` Command