README

= OutputCatcher

by Matthias Hennemeyer <mhennemeyer@gmail.com>

== Introduction

OutputCatcher is available as a Rails plugin and as a gem.
It provides a way to capture the standard out($stdout) or standard error($stderr) of your code without pain 
and suppresses the output of the 'err' or 'out' stream.


== Usage

  OutputCatcher knows only two methods: .catch_err and .catch_out
  
  To capture the stderr of your code:
  
  err = OutputCatcher.catch_err do
    $stderr << "error error"
  end
  err #=> "error error"
  
  
  To capture the stdout of your code:
  
  out = OutputCatcher.catch_out do
    puts "Hello Hello"
  end
  out #=> "Hello Hello"
  
== INSTALL:
Rails:
  
  $ ruby script/plugin install git://github.com/mhennemeyer/output_catcher.git

Gem:

  $ gem install mhennemeyer-output_catcher
  

Copyright (c) 2008 Matthias Hennemeyer, released under the MIT license