Posted over 8 years ago. Visible to the public.

RSpec: Where to put shared example groups

Shared example groups Archive are a useful RSpec feature. Unfortunately the default directory structure generated by rspec-rails has no obvious place to put them.

I recommend storing them like this:

spec/models/shared_examples/foo.rb spec/models/shared_examples/bar.rb spec/models/shared_examples/baz.rb spec/controllers/shared_examples/foo.rb spec/controllers/shared_examples/bar.rb spec/controllers/shared_examples/baz.rb

To make those shared examples available to all specs, put the following into your spec_helper.rb (for rails 4 in rails_helper.rb), above the RSpec.configure block:

Dir[Rails.root.join("spec/models/shared_examples/**/*.rb")].each {|f| require f} Dir[Rails.root.join("spec/controllers/shared_examples/**/*.rb")].each {|f| require f}

Make sure you don't call your examples files like ..._spec.rb, else RSpec will believe they're actual spec files and require them.

Also see where to put custom matchers and other support code.

makandra has been working exclusively with Ruby on Rails since 2007. Our laser focus on a single technology has made us a leader in this space.

Owner of this card:

Henning Koch
Last edit:
over 6 years ago
by Dominik Schöler
store, save, folder, location, path
About this deck:
We are makandra and do test-driven, agile Ruby on Rails software development.
License for source code
Posted by Henning Koch to makandra dev
This website uses short-lived cookies to improve usability.
Accept or learn more