Espresso and Robots

This is a walkthrough of implementing a Robot pattern in Espresso, using Kotlin and infix extension functions.

Transcript

2. ROBOTS ESPRESSO AND
3. ESPRESSO
4. VIEWINTERACTION interface ViewInteraction { fun check(viewAssertion: ViewAssertion): ViewInteraction fun perform(vararg viewActions: ViewAction): ViewInteraction fun inRoot(rootMatcher: Matcher<Root>): ViewInteraction fun noActivity(): ViewInteraction fun withFailureHandler(failureHandler: FailureHandler): ViewInteraction }
5. VIEWINTERACTION interface ViewInteraction { fun check(viewAssertion: ViewAssertion): ViewInteraction fun perform(vararg viewActions: ViewAction): ViewInteraction fun inRoot(rootMatcher: Matcher<Root>): ViewInteraction fun noActivity(): ViewInteraction fun withFailureHandler(failureHandler: FailureHandler): ViewInteraction }
6. VIEWINTERACTION interface ViewInteraction { fun check(viewAssertion: ViewAssertion): ViewInteraction fun perform(vararg viewActions: ViewAction): ViewInteraction fun inRoot(rootMatcher: Matcher<Root>): ViewInteraction fun noActivity(): ViewInteraction fun withFailureHandler(failureHandler: FailureHandler): ViewInteraction }
7. VIEWINTERACTION @Test fun myTest() { val interaction: ViewInteraction = Espresso.onView(myView) }
8. VIEWINTERACTION @Test fun myTest() { val interaction: ViewInteraction = Espresso.onView(myView) .check(…) }
9. VIEWINTERACTION @Test fun myTest() { val interaction: ViewInteraction = Espresso.onView(myView) .check(…) .perform(…) .check(…) }
10. TWO MOVES OF ESPRESSO ▸ ViewActions ▸ perform(), type(), click()
11. TWO MOVES OF ESPRESSO ▸ ViewActions ▸ perform(), type(), click() ▸ ViewAssertions ▸ isDisplayed(), isSelected(), isEnabled()
12. TWO MOVES OF ESPRESSO @Test fun emailField_displaysWhatIsTyped() { Espresso.onView(withId(R.id.email)) .check(isDisplayed()) .perform(typeText(“person@email.com")) .check(matches(withText("person@email.com"))) }
13. VIEW ASSERTIONS @Test fun emailField_displaysWhatIsTyped() { Espresso.onView(withId(R.id.email)) .check(isDisplayed()) .perform(typeText(“person@email")) .check(matches(withText("person@email.com"))) }
14. VIEW ACTIONS @Test fun emailField_displaysWhatIsTyped() { Espresso.onView(withId(R.id.email)) .check(isDisplayed()) .perform(typeText(“person@email.com")) .check(matches(withText("person@email.com"))) }
15. ESPRESSO IS BITTER
16. ESPRESSO NEEDS SUGAR
17. ESPRESSO NEEDS INFIX
18. ESPRESSO NEEDS INFIX
19. EspressoTest.kt interface EspressoTest { val click: ViewAction get() = ViewActions.click() val visible: ViewMatcher get() = ViewMatchers.isDisplayed() infix fun type(text: String): ViewAction = ViewActions.typeText(text) infix fun Int.shouldBe(viewMatcher: ViewMatcher): ViewInteraction = Espresso.onView(ViewMatchers.withId(this)) .check(ViewAssertions.matches(viewMatcher)) infix fun Int.shouldHaveText(text: String): ViewInteraction = Espresso.onView(ViewMatchers.withId(this)) .check(ViewAssertions.matches(withText(text))) }
20. PRE-INFIX @Test fun emailField_displaysWhatIsTyped() { Espresso.onView(withId(R.id.email)) .check(isDisplayed()) .perform(typeText(“person@email.com")) .check(matches(withText("person@email.com"))) }
21. @Test fun emailField_displaysWhatIsTyped() { R.id.email shouldBe displayed click on R.id.email type("person@email.com") in R.id.email R.id.email shouldHaveText “person@email.com" } INFIX
22. @Test fun emailField_displaysWhatIsTyped() { R.id.email shouldBe displayed click on R.id.email type("person@email.com") in R.id.email R.id.email shouldHaveText “person@email.com" } INFIX
23. @Test fun emailField_displaysWhatIsTyped() { click on R.id.email type("person@email.com") in R.id.email R.id.email shouldHaveText “person@email" } INFIX
24. ROBOTS
25. MODEL VIEWMODEL VIEW APPLICATION ARCHITECTURE
26. MODEL VIEWMODEL VIEW TEST ARCHITECTURE TESTS + VIEW ACCESS
27. MODEL VIEWMODEL VIEW TESTS TEST ARCHITECTURE VIEW ACCESS
28. Robot.kt abstract class Robot<ViewClass : Any> { @get:LayoutRes protected abstract val layout: Int fun setFailureHandler(context: Context) { Espresso.setFailureHandler { error, viewMatcher !-> takeScreenshot("test_failed") DefaultFailureHandler(context).handle(error, viewMatcher) } } fun takeScreenshot(description: String) { Timber.v("click click! "-- $description") } }
29. abstract class Robot<ViewClass : Any> { @get:LayoutRes protected abstract val layout: Int fun setFailureHandler(context: Context) { Espresso.setFailureHandler { error, viewMatcher !-> takeScreenshot("test_failed") DefaultFailureHandler(context).handle(error, viewMatcher) } } fun takeScreenshot(description: String) { Timber.v("click click! "-- $description") } } Robot.kt
30. abstract class Robot<ViewClass : Any> { @get:LayoutRes protected abstract val layout: Int fun setFailureHandler(context: Context) { Espresso.setFailureHandler { error, viewMatcher !-> takeScreenshot("test_failed") DefaultFailureHandler(context).handle(error, viewMatcher) } } fun takeScreenshot(description: String) { Timber.v("click click! "-- $description") } } Robot.kt
31. abstract class Robot<ViewClass : Any> { @get:LayoutRes protected abstract val layout: Int fun setFailureHandler(context: Context) { Espresso.setFailureHandler { error, viewMatcher !-> takeScreenshot("test_failed") DefaultFailureHandler(context).handle(error, viewMatcher) } } fun takeScreenshot(description: String) { Timber.v("click click! "-- $description") } } Robot.kt
32. LogInRobot.kt class LogInRobot : Robot<LogInActivity>(), EspressoTest { override val layout: Int = R.layout.activity_login object Ids { const val USERNAME = R.id.etUsername const val PASSWORD = R.id.etPassword const val SHOW_PASSWORD = R.id.btnShowPassword const val SIGN_IN = R.id.btnSignIn const val EULA = R.id.btnEula } … }
33. LogInRobot.kt class LogInRobot : Robot<LogInActivity>(), EspressoTest { fun typeUsername(userName: String = USERNAME) { click on Ids.USERNAME type(userName) on Ids.USERNAME Espresso.closeSoftKeyboard() takeScreenshot("type username $userName") } fun verifyUserName(userName: String) { Ids.USERNAME shouldHaveText userName takeScreenshot(“compare username $userName") } }
34. LogInRobot.kt fun EspressoTest.logIn(func: LogInRobot.() "-> Unit): LogInRobot = LogInRobot().apply { func() }
35. LogInActivityTest.kt fun EspressoTest.logIn(func: LogInRobot.() "-> Unit): LogInRobot = LogInRobot().apply { func() } @Test fun emailField_displaysWhatIsTyped() { logIn { typeUsername("person@email.com") verifyUserName("person@email.com") } }
36. LogInActivityTest.kt @Test fun demoThings() = runBlocking { landing { "//""... } logIn { typeUsername("person@email.com") typePassword("Start123") verifyUsername("person@email.com") clickSignIn() } }