1. R 言語でユニットテスト
@yokkuns: 里 洋平
2011.05.28 Tokyo.R#14

2. AGENDA
●
自己紹介
●
RUnit とは
●
テストの実行
●
テストケースをチェックする
●
まとめ

3. AGENDA
●
自己紹介
●
RUnit とは
●
テストの実行
●
テストケースをチェックする
●
まとめ

4. 自己紹介
● ID: yokkuns
●
名前 : 里 洋平
●
職業 : データマイニングエンジニア

5. 自己紹介
Tokyo.R の主催をやっています！

6. AGENDA
●
自己紹介
●
RUnit とは
●
テストの実行
●
テストケースをチェックする
●
まとめ

7. 目的
●
R のコードの信頼性を高める
●
バグの出にくいコードを書けるようになる

8. R の普及
●
統計解析やデータマイニングなどの需要
●
R を使う人が増えてきている

9. R の普及
R 使いの人材募集とか

10. R の普及
R 使いの人材募集とか

11. R の普及
R 使いの人材募集とか
yohei0511@gmail.com

12. コードの質
良い結果が出ました！

13. コードの質
良い結果が出ました！

14. コードの質
良い結果が出ました！
実はバグでした・・・
ってことになると、非常にまずい

15. ユニットテスト
通常の開発では、ユニットテストが行われている
● JUnit
● CppUnit
● PHPUnit
● ...

16. ユニットテスト
通常の開発では、ユニットテストが行われている
● JUnit
● CppUnit
● PHPUnit
● ...
RUnit は、これらの R 言語版

17. AGENDA
●
自己紹介
●
RUnit とは
●
テストの実行
●
テストケースをチェックする
●
まとめ

18. RUnit を使う準備
install.packages(“RUnit”)
library(RUnit)

19. ファイルの配置
●
ここでは、以下のように配置
● R/sample.R
● test/runit.sample.R

20. RUnit のやること
●
ある命名規則で定義されたテスト関数を実行
●
テストが成功したか否かを保存
●
最後に結果を出力

21. 命名規則
テスト関数は、 test.×× という関数名
c2f <- function(c) {
return(9/5 * c + 32)
}
test.c2f <- function() {
checkEquals(c2f(0), 32)
checkEquals(c2f(10), 50)
checkException(c2f("xx"))
}

22. チェック関数
● checkEquals
● checkEqualsNumeric
● checkTrue
● checkException
● checkIdentical
● ...

23. 意図していない挙動の例
hoge <- function(x) return( ifelse(x>20, "OK", "NG") )
> hoge(100)
[1] "OK"
> hoge("100")
[1] "NG"
> hoge("xx")
[1] "OK"

24. テストの実行
1 ファイルのテストを実行
runTestFile(absFileName)
● absFileName
●
テスト関数を書いてるファイル

25. テストの実行
1 ファイルのテストを実行
> runTestFile("../test/runit.sample.R")
Executing test function test.c2f ... Error in 9/5 * c : non-
numeric argument to binary operator
done successfully.
Number of test functions: 1
Number of errors: 0
Number of failures: 0

26. テストスイート
複数のファイルのテストを実行したい場合は
テストスイートを作成する
Testsuite ← defineTestSuite(name,
dirs,
testFileRegexp,
...
)
runTestSuite(testsuite)
printTextProtocol(testData)
printHTMLProtocol(testData)

27. テストスイート
> testsuite.c2f <- defineTestSuite(name = "c2f",
dirs = "../test",
testFileRegexp = "^runit.+.R"
)
> testResult <- runTestSuite(testsuite.c2f)

28. テストスイート
> printTextProtocol(testResult)
RUNIT TEST PROTOCOL -- Sat May 28 08:45:02 2011
***********************************************
Number of test functions: 1
Number of errors: 0
Number of failures: 0
1 Test Suite :
c2f - 1 test function, 0 errors, 0 failures
Details
***************************
Test Suite: c2f
Test function regexp: ^test.+
Test file regexp: ^runit.+.R
Involved directory:
../test
---------------------------
Test file: ../test/runit.sample.R
test.c2f: (3 checks) ... OK (0 seconds)

29. AGENDA
●
自己紹介
●
RUnit とは
●
テストの実行
●
テストケースをチェックする
●
まとめ

30. テストケースは十分か？
自分で書いたテストケースが
全ての組み合わせに対して網羅しているか？

31. tracker の初期化
コードをトラッキンングするオブジェクトを生成
track <- tracker()
track$init()
●
※ 変数名は、 track で無ければならない

32. コードの追跡
コードのどこを通ったかを追跡する
inspect(expr, track = track)
resTrack <- track$getTrackInfo()
printHTML.trackInfo(object, baseDir =
".")

33. 出力結果
●
実行された回数が出力
●
1 回も呼ばれてない行は赤色になる

34. テストに組み込む
●
テストを呼び出す箇所で、 tracker を初期化
●
テスト完了後、結果を出力する
track <- tracker()
track$init()
testsuite.c2f <- defineTestSuite(name = "c2f",
dirs = "../test",
testFileRegexp = "^runit.+.R"
)
testResult <- runTestSuite(testsuite.c2f)
printTextProtocol(testResult)
printHTML.trackInfo(track$getTrackInfo(), "../test")

35. テストに組み込む
●
条件式がある例を作成
bar <- function(x, y = NULL)
{
if (is.null(y)) {
y <- x
}
if (all(y > 100)) {
y <- y - 100
}
res <- x^y
return(res)
}

36. テストに組み込む
●
check 関数のタイミングで組み込む
test.bar <- function() {
checkTrue(is.numeric(inspect(bar(1:100), track)))
}

37. 出力結果
漏れてるケースがないかが分かる

38. AGENDA
●
自己紹介
●
RUnit とは
●
テストの実行
●
テストケースをチェックする
●
まとめ

39. まとめ
●
RUnit でコードの信頼性を高めることが出来る
●
Code Inspector でテストの漏れを発見出来る

40. AGENDA
●
自己紹介
●
RUnit とは
●
テストの実行
●
テストケースをチェックする
●
まとめ

41. 次回以降の
発表者を募集しています！