rcov でカバレージを計測する - 君の瞳はまるでルビー

目的

RCov を使ってカバレージを計測する方法を簡単に説明します。

RCov は Ruby 1.8 では使えますが、Ruby 1.9 では使えません。 Ruby 1.9 でカバレージを計測するには別の方法を利用する必要があります。

RCov はネイティブコードを含んでおり、インストールには DEVELOPMENT KIT が必要になります。

以上を参考に DEVELOPMENT KIT をセットアップした後、以下のコマンドを実行してください。

gem install rcov

以下のコマンドを実行し、インストールに成功していることを確認してください。

rcov --version

また、以下のコマンドを実行すると、コマンドの説明が見れることを覚えておくと役に立ちます。

rcov --help

カバレージを計測するには、ruby コマンドの代わりに rcov コマンドを使って Ruby プログラムを実行します*1。

rcov example.rb

ruby コマンドで実行したときと同じようにプログラムが動作します。

通常の ruby コマンドと違うのは、実行後に coverage ディレクトリが作成され、そこに計測結果が格納されることです。

計測結果を見るには、以下の HTML ファイルをブラウザで開いてください。

以下、表示事例です。

実行したプログラムだけではなく、プログラム内で require したソースコードも計測対象となります。

表の内容は以下の通りです。

このページから、さらに各ソースコード毎のカバレージ詳細を見ることもできます。

ruby コマンドで実行する場合と違い、rcov コマンドは複数のプログラムを実行できる。

rcov example1.rb example2.rb

プログラムをパターンで指定する方法（example.rb, example1.rb, example2.rb などなど、その他 example と先頭につくプログラムが対象）

rcov example*.rb

rcov example/*.rb

rcov は引数を計測対象のプログラムと判断します。

計測対象プログラムではなく、プログラムへのコマンドライン引数であることを明確にするため「--」で区切って以下のように書きます。

rcov example1.rb -- 引数１ 引数２ 引数３

計測対象のプログラムを複数にした場合も同様です。その場合、全てのプログラムに同じコマンドライン引数が入力されます。

複数回にプログラムを分けて実行し、全ての計測結果を蓄積し、まとめるには --aggregate オプションを使います。

以下、事例です。

rcov --aggregate coverage.rcov example1.rb -- 引数Ａ
rcov --aggregate coverage.rcov example1.rb -- 引数Ｂ
rcov --aggregate coverage.rcov example2.rb

aggregate オプションを使うと、その後に指定したファイル（この場合は coverage.rcov としている）に計測結果が蓄積されます。ファイル名称は任意です。

計測結果は同様に coverage ディレクトリに作成されます。

計測結果を見やすくするため、計測不要なものを計測対象から除外するためのオプションが数多く存在します。

例えば、

などを計測不要なものを計測対象から除外したい場合、このようなオプションが使えるでしょう。

汎用オプション
- exclude
  - 指定したパターンに合致するソースコードを計測対象から除外する。
- exclude-only
  - 通常、RubyGems でインストールしたソースコードは標準で対象外だが、このオプションを指定した場合は、例外なく指定したパターンに合致したもののみを計測対象から除外する。

詳細は rcov --help を参照してください。

本ページの内容に関して何かコメントがある方は、以下に記入してください。

コメントはありません。コメント/rcov/about