Awesome

RSpec Smart Formatter

RSpec Smart Formatter automatically chooses an appropriate formatter depending on the amount of specs you're running.

Why this formatter exists

This gem is for scratching an itch I have. When I run focussed tests (like, only one file, or only one example group) I want to use the documentation formatter, which gives me a better view of which tests pass and which tests fail.

When I run a lot of tests, I want something that doesn't fill my entire bash history and just shows the list of specs.

I like formatters like Instafail and Fuubar, which easily handles thousands of tests, without cluttering your terminal, and showing you the failing specs instantly so you can figure out what went wrong without having to wait for your whole suite to finish.

I could write -fd and -fp manually, but I keep forgetting that.

Installation

Add to your gemfile:

group :test do
  gem 'rspec-smart-formatter', :require => false
end

Run bundle install

Add it your .rspec file:

--format RSpec::Smart::Formatter

And you're done!

Usage

Just run RSpec as you normally would.

For explaination on how the smart formatter works, see this feature.

Configuration

Don't know yet. Still working on it.

Development

To run the specs of rspec-smart-formatter itself:

bundle install
rspec

PS. Don't run with bundle exec.

Pull requests are welcome.