RSpecの出力をカスタマイズする方法。
例えばテスト中に計測した統計情報とか、そういうものを出力内容に含めたい時に便利。

結論から言うと、自分でFormatterやPrinterを作って、RSpecにこれを使え、って指定すれば良い。

# コマンド例
rspec -r my_html_formatter.rb -r my_html_printer.rb --format MyHtmlFormatter myapp_spec.rb

「-r」は外部のソースファイルを読み込ませるオプション。
そのファイルに書かれてるクラスや関数などが、specファイルの中で使用可能になる。

「--format」はFormatterの指定 (クラス名を書く、ファイル名じゃないよ！)。
Formatterは当然別ファイルに書かなきゃいけないので、別途「-r」で読み込んでおく。

Printerは実際に出力するHtmlソースなどを記述する。

オレオレFormatterの書き方だけど、RSpec内のデフォルトのFormatterクラスを継承して、
好きなように書き換えれば良い。こんな感じ。

require 'rspec/core/formatters/html_formatter'
require 'my_printer'

class MyHtmlFormatter < RSpec::Core::Formatters::HtmlFormatter

  # 例えばテスト成功時、通常出力の後に、オレオレ出力を出したいとする
  def example_passed(example)
      super
      @printer.print_my_result
  end
end

詳しくはRSpecのソースコードを参照！

RSpecではFormatterは「あれを出力して、次にこれを、最後にそれを出力」みたいな
ことを書いてるに過ぎなくて、実際のHTMLソースはPrinterが持っている。

これもコードを見てみよう。

これも継承して、オレオレ出力用のメソッドを追加しておこう。

require 'rspec/core/formatters/html_printer'

class MyHtmlPrinter < RSpec::Core::Formatters::HtmlPrinter

  def print_my_result
    @output.puts "<div>"
    @output.puts "なんか役に立つ結果！"
    @output.puts "</div>"
  end

end

既存の表記やデザインが気に食わないなら、
print_example_passed とか print_example_failed などをいじってみよう。

実際には、あれもこれもとカジュアルに追加できるようなHtml構造にはなっていなくて、
適当にブロックを追加してみたらデザインが崩れた…、なんてこともあるので、
割と細かい調整が必要になってしまうかもしれない。

なお、テスト中に色々なデータを集めたりするには、
before, after, each を上手に活用してみよう。