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

Nyan Cat RSpec Formatter Build Status


This is my take on the Nyan Cat RSpec Formatter. It simply creates a rainbow trail of test results. It also counts the number of examples as they execute and highlights failed and pending specs.

The rainbow changes colors as it runs. See it in action here.

Works with RSpec 1.3, 2 and 3.

Using Nyan Cat

You can either specify the formatting when using the rspec command:

rspec --format NyanCatFormatter

Or add --format NyanCatFormatter to a .rspec file placed in your project's root directory, so that you won't have to specify the --format option everytime you run the command.

###Using with Bundler

To use Nyan Cat with a project that uses Bundler (Rails or Sinatra f.e.) you need to add Nyan Cat dependecy to your Gemfile:

group :test do
  gem "nyan-cat-formatter"

And then run bundle install.

Installing it

$ gem install nyan-cat-formatter

If you want to use Nyan Cat as your default formatter, simply put the options in your .rspec file:

--format NyanCatFormatter

Playing the Nyan Cat song

You can then enjoy playback in two ways:

1. Play the song only when desired using a command line option:

Use the following command to run your specs:

$ rspec spec -f NyanCatMusicFormatter

And enjoy the site of Nyan Cat running across your terminal to the Nyan Cat song!

2. Play the song by default when you run your specs:

Make sure your .rspec file in your application's root directory contains the following:

--format NyanCatMusicFormatter

Then run rspec spec and enjoy Nyan Cat formatted text output accompanied by the Nyan Cat song by default!

This currently only works on Mac OS X or on Linux (if you have mpg321 or mpg123 installed).

Using the Nyan Cat Wide Formatter

The classic Nyan Cat Formatter uses a terminal column per test. One test, and single step that the cat goes ahead. The Nyan Cat Wide Formatter, instead, uses the whole terminal width, so the cat will always end up reaching the end of the terminal.

Simple use it by configuring it as the RSpec formatter:

--format NyanCatWideFormatter


Once you've made your great commits:

  1. Fork Nyan Cat
  2. Create a topic branch - git checkout -b my_branch
  3. Push to your branch - git push origin my_branch
  4. Create a Pull Request from your branch
  5. That's it!


Matt Sears :: @mattsears


Nyan Cat inspired RSpec formatter!







No releases published


No packages published