【Kotlin】モックライブラリMockKでCoroutinesのユニットテストをしてみる

普段TDDまではできていませんが、ちょっとずつテストを充実させていきたい気持ちがあり、勉強がてらCoroutinesのユニットテストをしてみたときのメモです。

# MockKとは
Kotlin向けモックライブラリ。今回はこれを使います。
[MockK | mocking library for Kotlin](https://mockk.io/#installation)

有名なMockitoのKotlin版で[mockito-kotlin](https://github.com/nhaarman/mockito-kotlin/wiki/Mocking-and-verifying)というライブラリもあるようですが、
MockKは[Coroutinesをサポート](https://mockk.io/#coroutines)しており、Mockitoより使いやすいという評判もある、いい感じのライブラリです:ok_hand:
強いて言うなら参考になるような記事がMockitoに比べると少ないことがネックではありますが、公式ドキュメントがしっかりしているのであまり気にならない印象です。

# 実装
今回対象となるプロジェクトはMVVMにレイヤーの概念（プレゼンテーション層、ドメイン層、データ層）を加えた形で設計していたので、UseCase・ViewModelそれぞれについて簡単なテストをしてみます。
※アーキテクチャについては本題とずれるのでこれ以上の説明を省きますが、下記記事の図が参考になるかなと思います。
[Android開発でMVVMを採用してみて - Qiita](https://qiita.com/rmakiyama/items/779cf6407f70b40e4ee7#mvvm--layered-architecture%E3%82%82%E3%81%A9%E3%81%8D%E3%82%92%E6%8E%A1%E7%94%A8%E3%81%97%E3%81%A6%E3%81%BF%E3%81%A6)

今回のコードを含んだリポジトリを公開しているので、詳細はそちらをご覧ください。
https://github.com/orimomo/my-qiita-app

## MockKの導入
build.gradleに下記を追加します。

```:build.gradle
testImplementation ‘io.mockk:mockk:1.9.3’ //追加
```

## UseCaseのテスト
コードがこちら。

```kotlin:ArticleUseCaseTest.kt
class ArticleUseCaseTest {
    // Repositoryのモックインスタンスの生成
    private val mockRepository = mockk<ArticleRepository> {
        // パターンの設定
        coEvery { getArticles(any(), any()) } returns listOf(ArticleEntity(), ArticleEntity())
    }

    // モックインスタンスをuseCaseに注入
    private val useCase = ArticleUseCase(mockRepository)

    @Test
    fun getArticles() = runBlocking {
        // メソッドを呼び出してlistに格納
        val list = useCase.getArticles("555", "kotlin")

        // メソッドが正しく呼び出されたことのチェック
        coVerify { mockRepository.getArticles("555", "kotlin") }
        // 正しい結果が得られたことのチェック
        assertEquals(2, list.size)
    }
}
```

やっていることはコメントを入れている通りなのですが、ポイントを挙げておきます。

* テスト対象クラスである`ArticleUseCase`は`ArticleRepository`に依存しているので、それをMockに置き換える
* `coEvery`で、生成したRepositoryのモックインスタンスにパターンを定義する
    * 引数の型を特に意識しない場合は`any()`を使う
* `useCase.getArticles()`はsuspend functionなので、`runBlocking`を使う
* `coVerify`でメソッドが正しく呼ばれたことのチェックをする
* `assertEquals`で狙い通りの結果が得られたことのチェックをする

Runしてみると、無事にテストが通りました！
<img width="741" alt="スクリーンショット 2019-10-14 21.20.03.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/112818/b006f94a-b5f9-1721-7893-9d2cefce76f3.png">

## ViewModelのテスト
先ほどと似ているコードですが、UseCaseのテストと比べると少しだけ厄介です。

```kotlin:ListViewModelTest.kt
class ListViewModelTest {
    // LiveDataをテストするために必要
    @get:Rule
    val rule = InstantTaskExecutorRule()

    // UseCaseのモックインスタンスの生成
    private val mockUseCase = mockk<ArticleUseCase> {
        // パターンの設定
        coEvery { getArticles(any(), any()) } returns listOf(ArticleEntity(), ArticleEntity())
    }

    // モックインスタンスをviewModelに注入
    private val viewModel = ListViewModel(mockUseCase)

    @Test
    fun load() = runBlocking {
        // メソッドの呼び出し
        viewModel.load()

        // メソッドが正しく呼び出されたことのチェック
        coVerify { mockUseCase.getArticles(any(), any()) }
        // 正しい結果が得られたことのチェック
        assertEquals(2, viewModel.kotlinArticles.value?.size)
        assertEquals(ListViewModel.Status.COMPLETED, viewModel.status.value)
    }
}
```

class名の下に、UseCaseのテストにはなかった2行が追加されているのがわかるかと思います。

>    @get:Rule
    val rule = InstantTaskExecutorRule()

これはLiveDataをテストするときに必要となるコードで、その定義をするためにはcore-testingというライブラリを別途追加する必要があります。

```:build.gradle
testImplementation ‘androidx.arch.core:core-testing:2.1.0’ //追加
```

これを定義せずにRunすると、下記エラーが出てテストが失敗します。
> java.lang.RuntimeException: Method getMainLooper in android.os.Looper not mocked.

改めてポイントを挙げます。

* テスト対象クラスである`ListViewModel`は`ArticleUseCase`に依存しているので、それをMockに置き換える
* `coEvery`で、生成したuseCaseのモックインスタンスにパターンを定義する
* `useCase.load()`はsuspend functionなので、`runBlocking`を使う
* `coVerify`でメソッドが正しく呼ばれたことのチェックをする
* `assertEquals`で狙い通りの結果が得られたことのチェックをする
    * **`viewModel.kotlinArticles`と`viewModel.status`はViewModel内でLiveDataとして定義されているので、それらをテストするためには`InstantTaskExecutorRule`をruleに指定する必要がある**


```kotlin:ListViewModel
class ListViewModel(private val useCase: ArticleUseCase) : ViewModel(), LifecycleObserver {
    val kotlinArticles = MutableLiveData<List<ArticleEntity>>() //LiveDataとして定義
    val status = MutableLiveData<Status>() //LiveDataとして定義
    ...
}
```

Runしてみると、無事にテストが通りました！
<img width="742" alt="スクリーンショット 2019-10-14 21.56.23.png" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/112818/ded513ff-8205-13ef-542f-fc9215194c60.png">

# おわりに
今回は簡単なテストをしてみましたが、今後は色々なシナリオを作って、テストを充実させていけたらと思います:muscle:
手探りでやっておりますので、もし間違っている点や改善できる点などあればコメントいただければ幸いですmm

## 参考
* [MockKの使い方 - Qiita](https://qiita.com/sadashi/items/81c64583a0112cfe6f8d)
* [Mockk逆引きチートシート - Qiita](https://qiita.com/k_keisuke/items/4f8988acd9051ca432fd)
* [Y.A.M の 雑記帳: LiveData を UnitTest でテストする](http://y-anz-m.blogspot.com/2018/06/livedata-unittest.html)