Monkey Test


Monkey Test is a command-line utility which will run your ruby tests and provide a simple at-a-glance summary of how your project is doing. Currently there are three different types of summaries for Monkey Test which are listed in the command summary section below.

The current version of Monkey Test is 1.0.0


  • [NEW] Completely rewrote Monkey Test to be a UI for the Test::Unit framework. It is now much faster and easier to use. This will also make it easier to add new types of output in the future.
  • [NEW] You can now specify the directory in which to look for your tests with -d or --directory.
  • [NEW] You can now specify the regular expression pattern to use when searching for test files with -p or --pattern.
  • [NEW] There are now commands to specify only one type of tests within rails. These are -f/--functional, -u/--unit, and -i/--integration.
  • [CHANGED] HTML output is currently not available. We really wanted to get 1.0.0 out there to you guys... We#39;ll add it soon, promise.
View the full changelog
Screenshot of Monkey Test.
An example of running monkeytest on a rails app.


Monkey test is released as a gem on rubyforge.

On OS X or Linux:

sudo gem install monkeytest

On Windows:

gem install monkeytest

You can download the gems from the files page but if you choose to install or update locally don't forget to get the required gems from the links below:

You'll also need ruby 1.8.5 for this version.

Note to Windows users: Be sure to select the Win32 version of the gem if you plan to use monkey test from the windows command prompt. If you are using a program such as cygwin the ruby version will work fine.

Command Summary

          Test selection criteria options:
              -d, --directory DIRECTORY        Search DIRECTORY for tests
              -r, --[no-]recursive             [Don't] Search directories recursively
              -u, --[no-]unit                  [Don't] Run unit tests
              -f, --[no-]functional            [Don't] Run functional tests
              -i, --[no-]integration           [Don't] Run integration tests
              -p, --pattern PATTERN            Run test files which match PATTERN
                                               (use quotes for safety!)

          Output options:
              -q, --quiet                      Output summary of failures and errors only
              -v, --verbose                    Output full fault messages
                  --[no-]color                 [Don't] Show colored output

          Other options:
              -h, --help                       Displays this help message
              -V, --version                    Display monkey test version info