Merge pull request #46 from novoda/page-object-chaining

Add user flows to test automation starter
novoda · Sep 28, 2018 · a17dbf2 · a17dbf2
2 parents f181d61 + 282dc09
commit a17dbf2
Show file tree

Hide file tree

Showing 8 changed files with 94 additions and 26 deletions.
diff --git a/...src/androidTest/java/com/novoda/androidstoreexample/pageobjects/MainActivityPageObject.kt b/...src/androidTest/java/com/novoda/androidstoreexample/pageobjects/MainActivityPageObject.kt
@@ -9,18 +9,20 @@ import android.support.test.espresso.matcher.ViewMatchers.withId
 import com.novoda.androidstoreexample.R
 import com.novoda.androidstoreexample.ViewMatchers
 
+fun mainPage(func: MainActivityPageObject.() -> Unit) = MainActivityPageObject().apply(func)
+
 class MainActivityPageObject {
 
     private val TITLE = onView(withId(R.id.titleTextView))
+    private val CATEGORY_LIST = onView(withId(R.id.categoryListView))
 
-    fun verifyTitle() {
+    fun verifyTitle() = apply {
         TITLE.check(matches(isDisplayed()))
     }
 
-    fun navigateToProductList() {
-        val categoryMatcher = ViewMatchers.withCategoryTitle("HATS")
+    fun navigateToProductList(category: String) = apply {
+        val categoryMatcher = ViewMatchers.withCategoryTitle(category)
 
-        onView(withId(R.id.categoryListView))
-                .perform(actionOnHolderItem(categoryMatcher, click()))
+        CATEGORY_LIST.perform(actionOnHolderItem(categoryMatcher, click()))
     }
 }
diff --git a/...c/androidTest/java/com/novoda/androidstoreexample/pageobjects/ProductDetailsPageObject.kt b/...c/androidTest/java/com/novoda/androidstoreexample/pageobjects/ProductDetailsPageObject.kt
@@ -6,9 +6,13 @@ import android.support.test.espresso.matcher.ViewMatchers.isDisplayed
 import android.support.test.espresso.matcher.ViewMatchers.withId
 import com.novoda.androidstoreexample.R
 
+fun productDetailsPage(func: ProductDetailsPageObject.() -> Unit) = ProductDetailsPageObject().apply(func)
+
 class ProductDetailsPageObject {
 
-    fun assertProductDetailsDisplayed() {
-        onView(withId(R.id.productDetailDescription)).check(matches(isDisplayed()))
+    private val PRODUCT_DESCRIPTION = onView(withId(R.id.productDetailDescription))
+
+    fun assertProductDetailsDisplayed() = apply {
+        PRODUCT_DESCRIPTION.check(matches(isDisplayed()))
     }
 }
diff --git a/.../src/androidTest/java/com/novoda/androidstoreexample/pageobjects/ProductListPageObject.kt b/.../src/androidTest/java/com/novoda/androidstoreexample/pageobjects/ProductListPageObject.kt
@@ -7,11 +7,17 @@ import android.support.test.espresso.matcher.ViewMatchers.withId
 import com.novoda.androidstoreexample.R
 import com.novoda.androidstoreexample.ViewMatchers
 
+fun productList(func: ProductListPageObject.() -> Unit) {
+    ProductListPageObject().apply(func)
+}
+
 class ProductListPageObject {
 
-    fun navigateToProductDetails() {
-        val productMatcher = ViewMatchers.withProductTitle("hat white")
+    private val PRODUCT_LIST = onView(withId(R.id.productListView))
+
+    fun navigateToProductDetails(product: String) = apply {
+        val productMatcher = ViewMatchers.withProductTitle(product)
 
-        onView(withId(R.id.productListView)).perform(RecyclerViewActions.actionOnHolderItem(productMatcher, ViewActions.click()))
+        PRODUCT_LIST.perform(RecyclerViewActions.actionOnHolderItem(productMatcher, ViewActions.click()))
     }
 }
diff --git a/...xample/tests/EspressoJavaTestExample.java → ...ressoJavaTestExampleWithoutFramework.java b/...xample/tests/EspressoJavaTestExample.java → ...ressoJavaTestExampleWithoutFramework.java
@@ -19,13 +19,13 @@
 import static android.support.test.espresso.matcher.ViewMatchers.isDisplayed;
 import static android.support.test.espresso.matcher.ViewMatchers.withId;
 
-public class EspressoJavaTestExample {
+public class EspressoJavaTestExampleWithoutFramework {
 
     @Rule
     public ActivityTestRule<MainActivity> activityTestRule = new ActivityTestRule<MainActivity>(MainActivity.class);
 
     @Test
-    public void firstNavigationTest() {
+    public void firstNavigationTestWithoutFramework() {
         Matcher<RecyclerView.ViewHolder> categoryMatcher = ViewMatchers.withCategoryTitle("HATS");
 
         onView(android.support.test.espresso.matcher.ViewMatchers.withId(R.id.categoryListView)).perform(scrollToHolder(categoryMatcher), actionOnHolderItem(categoryMatcher, click()));

diff --git a/...oreexample/tests/MockServerTestExample.kt → ...ests/EspressoTestExampleWithMockServer.kt b/...oreexample/tests/MockServerTestExample.kt → ...ests/EspressoTestExampleWithMockServer.kt
@@ -19,7 +19,7 @@ import org.junit.Rule
 import org.junit.Test
 import java.io.InputStream
 
-class MockServerTestExample {
+class EspressoTestExampleWithMockServer {
 
     private val activityTestRule = ActivityTestRule<MainActivity>(MainActivity::class.java, false, false)
     private val mockWebServer = MockWebServer()

diff --git a/...droidTest/java/com/novoda/androidstoreexample/tests/EspressoTestExampleWithPageObjects.kt b/...droidTest/java/com/novoda/androidstoreexample/tests/EspressoTestExampleWithPageObjects.kt
@@ -0,0 +1,31 @@
+package com.novoda.androidstoreexample.tests
+
+import android.support.test.rule.ActivityTestRule
+import com.novoda.androidstoreexample.activities.MainActivity
+import com.novoda.androidstoreexample.pageobjects.*
+import org.junit.Rule
+import org.junit.Test
+
+class EspressoTestExampleWithPageObjects {
+
+    private val activityTestRule = ActivityTestRule<MainActivity>(MainActivity::class.java)
+
+    @get:Rule
+    var activityRule: ActivityTestRule<MainActivity> = activityTestRule
+
+    @Test
+    fun firstNavigationTestWithPageObjects() {
+
+        mainPage {
+            navigateToProductList("HATS")
+        }
+
+        productList {
+            navigateToProductDetails("hat white")
+        }
+
+        productDetailsPage {
+            assertProductDetailsDisplayed()
+        }
+    }
+}
diff --git a/...oreexample/tests/EspressoUserFlowTests.kt → ...tests/EspressoTestExampleWithUserFlows.kt b/...oreexample/tests/EspressoUserFlowTests.kt → ...tests/EspressoTestExampleWithUserFlows.kt
@@ -5,27 +5,25 @@ import com.novoda.androidstoreexample.activities.MainActivity
 import com.novoda.androidstoreexample.pageobjects.MainActivityPageObject
 import com.novoda.androidstoreexample.pageobjects.ProductDetailsPageObject
 import com.novoda.androidstoreexample.pageobjects.ProductListPageObject
+import com.novoda.androidstoreexample.userflows.productUserFlow
 import org.junit.Rule
 import org.junit.Test
 
-class EspressoUserFlowTests {
-
-    private val mainActivityPageObject = MainActivityPageObject()
-    private val productListPageObject = ProductListPageObject()
-    private val productDetailsPageObject = ProductDetailsPageObject()
-
+class EspressoTestExampleWithUserFlows {
     private val activityTestRule = ActivityTestRule<MainActivity>(MainActivity::class.java)
 
     @get:Rule
     var activityRule: ActivityTestRule<MainActivity> = activityTestRule
 
     @Test
-    fun navigateToProductDetailsTest() {
-
-        mainActivityPageObject.navigateToProductList()
-
-        productListPageObject.navigateToProductDetails()
-
-        productDetailsPageObject.assertProductDetailsDisplayed()
+    fun firstNavigationTestWithUserFlows() {
+        val category = "HATS"
+        val product = "hat white"
+
+        productUserFlow {
+            navigateToCategory(category)
+            openItemFromProductlist(product)
+            checkThatCorrectProductIsDisplayed()
+        }
     }
 }
diff --git a/...rter/app/src/androidTest/java/com/novoda/androidstoreexample/userflows/ProductUserFlow.kt b/...rter/app/src/androidTest/java/com/novoda/androidstoreexample/userflows/ProductUserFlow.kt
@@ -0,0 +1,27 @@
+package com.novoda.androidstoreexample.userflows
+
+import com.novoda.androidstoreexample.pageobjects.mainPage
+import com.novoda.androidstoreexample.pageobjects.productDetailsPage
+import com.novoda.androidstoreexample.pageobjects.productList
+
+fun productUserFlow(func: ItemUserFlow.() -> Unit) { ItemUserFlow().apply(func) }
+
+class ItemUserFlow {
+    fun navigateToCategory(category: String) = apply {
+        mainPage {
+            navigateToProductList(category)
+        }
+    }
+
+    fun openItemFromProductlist(product: String) = apply {
+        productList {
+            navigateToProductDetails(product)
+        }
+    }
+
+    fun checkThatCorrectProductIsDisplayed() = apply {
+        productDetailsPage {
+            assertProductDetailsDisplayed()
+        }
+    }
+}