Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

rspec-multi-mock Build Status

Allows multiple mock frameworks to be in action in RSpec. This version is for rspec >=2.3.0.

  • For rspec 1.3.1 refer to v0.1.0
  • For rspec 2.x and not_a_mock support refer to v0.2.1


    gem install rspec-multi-mock


If you are using bundler add the dependency in Gemfile

    gem 'rspec-multi-mock', :group => :test

Configure multi-mock for RSpec runner (Usually done in spec_helper.rb)

    RSpec.configure do |config|
      config.mock_with MultiMock::Adapter.for(:rspec, :mocha, :rr, ::NewMockFramework::RSpecAdapter)

As shown above you can use a symbol for frameworks listed above. The usage of adapter module directly may not work completely if the adapter module contains any extensions methods to be used in specs. For instance RR rspec adapter includes both the adapter methods and the extension methods.

When & How is this useful?

There are cases where you might have to use two different mocking in the same project(for a while). It could be because

  • You are merging two big projects and they use different mocking frameworks for unit testing.
  • You want to try a new mocking framework with cleaner syntax and some new features.

Since RSpec does not support multiple mocking frameworks, we might hesitate to pick up these tasks because

  • There could be less time and it needs some effort to convert all the specs to use new mocking framework.
  • The new mocking framework may not yet provide all the features available in the current mocking framework.

Using this gem you can

  • Start moving specs incrementally to new framework
  • Start using new framework for new specs. This will reduce the number of specs need to be converted at the end.
  • Use both mocking frameworks till the new one provides all the required features.

Please note that using multiple mocking frameworks can create a lot of confusion in the team. So make sure that the end goal is to use single mocking framework(Your favorite one!). Use this gem only during the transition phase.


If you are already using multiple mock frameworks with just one mock framework configured in spec runner, the mocks may not be working completely as you expected.

  • The expectations set using the un-configured mocking framework will not be verified.
  • The methods mocked or stubbed using the un-configured mocking framework will not be cleaned up after the spec run is completed. This becomes a serious issue if it is a class method


Allows multiple mock frameworks to be in action in RSpec (With no monkey patching on Rspec)







No packages published