how to hack in log messages to rspec 2

loggingdocumentationformatter.txt

When doing automation I coach people not to put in logging in their scripts aside from things like 'here is the user name and password I randomly created just now' but I couldn't coax the default documentation formatter in rspec to capture information send via 'puts'. So I over-engineered a solution. Proper documentation and inclusion in my rspec-selenium-pageobjects project in a day or so.

spec_helper.rb
--------------
module RSpec
  module Core
    class Reporter
      def with(message)
        notify :with, message
      end
      
      def notify(method, *args, &block)
        @formatters.each do |formatter|
          if formatter.respond_to?(method)
            formatter.send method, *args, &block
          end
        end
      end
    end
  end
end

def with(message)
  RSpec.configuration.reporter.with message
end

you_spec.rb
-----------
        it "goes to the story", :homepage => true do
          clicked = @home.goto_random_section_story
          with 'this rabbit hole'
          with 'is hella deep'
        end

logging_documentation_formatter.rb
----------------------------------

require 'rspec/core/formatters/documentation_formatter'

class LoggingDocumentationFormatter < RSpec::Core::Formatters::DocumentationFormatter
  def initialize(output)
    super(output)
    @group_level = 0
    @with_messages = Array.new
  end

  def with(message)
    @with_messages << (grey("#{current_indentation}with: #{message}"))
  end
  
  def flush
    @with_messages.length.times{@with_messages.shift}
  end
  
  def example_passed(example)
    super(example)
    output.puts @with_messages.join("\n")
    flush
  end
  
  def example_failed(example)
    super(example)
    output.puts @with_messages.join("\n")
    flush
  end
end

how to use
----------
rspec --require spec/support/formatters/logging_documentation_formatter.rb -f LoggingDocumentationFormatter -c spec/your_spec.rb

output
------
      goes to the story
      with: this rabbit hole
      with: is hella deep