appium-espresso-driver 1.46.0

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/EspressoServerRunnerTest.kt

@@ -0,0 +1,93 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver
+
+import org.junit.Assume
+import org.junit.Test
+
+import java.io.IOException
+
+import androidx.test.filters.LargeTest
+import io.appium.espressoserver.lib.drivers.DriverContext
+import io.appium.espressoserver.lib.handlers.exceptions.DuplicateRouteException
+import io.appium.espressoserver.lib.http.Server
+
+import org.junit.Assert.assertEquals
+import org.junit.Rule
+import org.junit.rules.TestRule
+import org.junit.runner.Description
+import org.junit.runners.model.Statement
+import androidx.compose.ui.test.junit4.AndroidComposeTestRule
+import io.appium.espressoserver.lib.drivers.ComposeDriver
+
+/**
+ * Instrumentation test, which will execute on an Android device.
+ *
+ * @see [Testing documentation](http://d.android.com/tools/testing)
+ */
+@LargeTest
+class EspressoServerRunnerTest {
+
+    @get:Rule
+    val composeRule = AndroidComposeTestRule(
+        activityRule = EmptyTestRule(),
+        activityProvider = { error("Can't provide current activity") }
+    ).also {
+        composeTestRule = it
+    }
+
+    private val syncComposeClock = Thread {
+        while (!Server.isStopRequestReceived) {
+            if (context.driverStrategy is ComposeDriver) {
+                composeTestRule.mainClock.advanceTimeByFrame()
+            }
+            // Let Android run measure, draw and in general any other async operations. AndroidComposeTestRule.android.kt:325
+            Thread.sleep(ANDROID_ASYNC_WAIT_TIME_MS)
+        }
+    }
+
+    @Test
+    @Throws(InterruptedException::class, IOException::class, DuplicateRouteException::class)
+    fun startEspressoServer() {
+        if (System.getProperty("skipespressoserver") != null) {
+            Assume.assumeTrue(true)
+            return
+        }
+        try {
+            Server.start()
+            syncComposeClock.start()
+            while (!Server.isStopRequestReceived) {
+                Thread.sleep(1000)
+            }
+        } finally {
+            Server.stop()
+            syncComposeClock.join()
+        }
+
+        assertEquals(true, true) // Keep Codacy happy
+    }
+
+    class EmptyTestRule : TestRule {
+        override fun apply(base: Statement, description: Description): Statement = base
+    }
+
+    companion object {
+        lateinit var composeTestRule: AndroidComposeTestRule<*, *>
+        val context = DriverContext()
+        const val ANDROID_ASYNC_WAIT_TIME_MS = 10L
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/drivers/AppDriver.kt

@@ -0,0 +1,29 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.drivers
+
+import io.appium.espressoserver.lib.model.AppiumParams
+import io.appium.espressoserver.lib.model.BaseElement
+import io.appium.espressoserver.lib.model.Locator
+
+interface AppDriver {
+    val name: DriverContext.StrategyType
+    fun findElement(params: Locator): BaseElement
+    fun click(params: AppiumParams): Unit
+    fun getText(params: AppiumParams): String
+    fun getDisplayed(params: AppiumParams): Boolean
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/drivers/ComposeDriver.kt

@@ -0,0 +1,73 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.drivers
+
+import androidx.compose.ui.semantics.SemanticsProperties
+import androidx.compose.ui.test.*
+import io.appium.espressoserver.EspressoServerRunnerTest
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidElementStateException
+import io.appium.espressoserver.lib.handlers.exceptions.NoSuchElementException
+import io.appium.espressoserver.lib.handlers.exceptions.StaleElementException
+import io.appium.espressoserver.lib.helpers.*
+import io.appium.espressoserver.lib.model.*
+
+class ComposeDriver : AppDriver {
+    override val name = DriverContext.StrategyType.COMPOSE
+
+    override fun findElement(params: Locator): BaseElement {
+        val parentNodeInteraction = params.elementId?.let { getNodeInteractionById(it) }
+
+        val nodeInteractions = parentNodeInteraction?.findDescendantNodeInteractions(params)
+            ?: EspressoServerRunnerTest.composeTestRule.onAllNodes(semanticsMatcherForLocator(params))
+
+        if (nodeInteractions.fetchSemanticsNodes(false).isEmpty()) {
+            throw NoSuchElementException(
+                String.format(
+                    "Could not find a compose element with strategy '%s' and selector '%s'",
+                    params.using, params.value
+                )
+            )
+        }
+        return ComposeElement(nodeInteractions[0])
+    }
+
+    override fun click(params: AppiumParams): Unit {
+        try {
+            getNodeInteractionById(params.elementId).performClick()
+        } catch (e: AssertionError) {
+            throw StaleElementException(params.elementId!!)
+        } catch (e: IllegalArgumentException) {
+            throw InvalidElementStateException("Click", params.elementId!!, e)
+        }
+    }
+
+
+    // https://developer.android.com/jetpack/compose/semantics#merged-vs-unmerged
+    override fun getText(params: AppiumParams): String {
+        val config = getSemanticsNode(params.elementId!!).config
+        if (!(config.contains(SemanticsProperties.Text) || config[SemanticsProperties.Text].isEmpty())) throw InvalidElementStateException()
+        return config[SemanticsProperties.Text][0].text
+    }
+
+    override fun getDisplayed(params: AppiumParams): Boolean =
+        try {
+            getNodeInteractionById(params.elementId).assertIsDisplayed()
+            true
+        } catch (e: AssertionError) {
+            false
+        }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/drivers/DriverContext.kt

@@ -0,0 +1,35 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.drivers
+
+class DriverContext {
+
+    private val composeDriver = ComposeDriver()
+    private val espressoDriver = EspressoDriver()
+    var driverStrategy: AppDriver = espressoDriver
+
+    fun setDriverStrategy(strategyType: StrategyType) {
+        when (strategyType) {
+            StrategyType.COMPOSE -> this.driverStrategy = composeDriver
+            StrategyType.ESPRESSO -> this.driverStrategy = espressoDriver
+        }
+    }
+
+    enum class StrategyType {
+        ESPRESSO, COMPOSE
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/drivers/EspressoDriver.kt

@@ -0,0 +1,70 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.drivers
+
+import androidx.test.espresso.PerformException
+import androidx.test.espresso.action.ViewActions
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidArgumentException
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidElementStateException
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidSelectorException
+import io.appium.espressoserver.lib.handlers.exceptions.NoSuchElementException
+import io.appium.espressoserver.lib.helpers.ViewFinder
+import io.appium.espressoserver.lib.model.*
+import io.appium.espressoserver.lib.viewaction.ViewGetter
+import io.appium.espressoserver.lib.viewaction.ViewTextGetter
+
+class EspressoDriver : AppDriver {
+    override val name = DriverContext.StrategyType.ESPRESSO
+
+    override fun findElement(params: Locator): BaseElement {
+        val parentView = params.elementId?.let {
+            ViewGetter().getView(EspressoElement.getViewInteractionById(it))
+        }
+        // Test the selector
+        val view = ViewFinder.findBy(
+            parentView,
+            params.using ?: throw InvalidSelectorException("Locator strategy cannot be empty"),
+            params.value ?: throw InvalidArgumentException()
+        )
+            ?: throw NoSuchElementException(
+                String.format(
+                    "Could not find espresso element with strategy %s and selector %s",
+                    params.using, params.value
+                )
+            )
+
+        // If we have a match, return success
+        return EspressoElement(view)
+    }
+
+    override fun click(params: AppiumParams): Unit {
+        try {
+            EspressoElement.getViewInteractionById(params.elementId).perform(ViewActions.click())
+        } catch (e: PerformException) {
+            throw InvalidElementStateException("click", params.elementId!!, e)
+        }
+    }
+
+    override fun getText(params: AppiumParams): String {
+        val viewInteraction = EspressoElement.getViewInteractionById(params.elementId)
+        return ViewTextGetter()[viewInteraction].rawText
+    }
+
+    override fun getDisplayed(params: AppiumParams): Boolean =
+        ViewElement(EspressoElement.getViewById(params.elementId, false)).isVisible
+
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/AcceptAlert.kt

@@ -0,0 +1,32 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.helpers.AlertHelpers
+import io.appium.espressoserver.lib.model.AlertParams
+
+class AcceptAlert : RequestHandler<AlertParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AlertParams): Void? {
+        // We use UIA2 here, since Espresso is limited to application sandbox
+        // and cannot handle security alerts
+        AlertHelpers.handle(AlertHelpers.AlertAction.ACCEPT, params.buttonLabel)
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/Back.kt

@@ -0,0 +1,31 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.model.AppiumParams
+
+import androidx.test.espresso.Espresso.pressBack
+
+class Back : RequestHandler<AppiumParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AppiumParams): Void? {
+        pressBack()
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/Clear.kt

@@ -0,0 +1,40 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import androidx.test.espresso.PerformException
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidElementStateException
+import io.appium.espressoserver.lib.model.AppiumParams
+import io.appium.espressoserver.lib.model.EspressoElement
+
+import androidx.test.espresso.action.ViewActions.clearText
+
+class Clear : RequestHandler<AppiumParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AppiumParams): Void? {
+        val viewInteraction = EspressoElement.getViewInteractionById(params.elementId)
+        try {
+            viewInteraction.perform(clearText())
+        } catch (e: PerformException) {
+            throw InvalidElementStateException("clear", params.elementId!!, e)
+        }
+
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/Click.kt

@@ -0,0 +1,27 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.model.AppiumParams
+import io.appium.espressoserver.EspressoServerRunnerTest.Companion.context
+
+class Click : RequestHandler<AppiumParams, Unit> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AppiumParams): Unit = context.driverStrategy.click(params)
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/CreateSession.kt

@@ -0,0 +1,58 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.handlers.exceptions.SessionNotCreatedException
+import io.appium.espressoserver.lib.helpers.ActivityHelpers.startActivity
+import io.appium.espressoserver.lib.helpers.NotificationListener
+import io.appium.espressoserver.lib.helpers.w3c.caps.parseCapabilities
+import io.appium.espressoserver.lib.model.GlobalSession
+import io.appium.espressoserver.lib.model.SessionParams
+import io.appium.espressoserver.lib.model.StartActivityParams
+
+
+class CreateSession : RequestHandler<SessionParams, GlobalSession>, NoSessionCommandHandler {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: SessionParams): GlobalSession {
+        val appiumSession = GlobalSession.create(params.capabilities
+                ?: throw SessionNotCreatedException("'capabilities' field is mandatory"))
+        try {
+            val parsedCaps = parseCapabilities(
+                    params.capabilities.firstMatch,
+                    params.capabilities.alwaysMatch
+            )
+            val shouldLaunchApp = (parsedCaps["autoLaunch"] ?: true) as Boolean
+            if (shouldLaunchApp) {
+                @Suppress("UNCHECKED_CAST")
+                startActivity(StartActivityParams(
+                        parsedCaps["appPackage"] as? String,
+                        parsedCaps["appActivity"] as? String,
+                        parsedCaps["appLocale"] as? Map<String, Any?>,
+                        parsedCaps["intentOptions"] as? Map<String, Any?>,
+                        parsedCaps["activityOptions"] as? Map<String, Any?>
+                ))
+            }
+            NotificationListener.start()
+        } catch (e: Exception) {
+            appiumSession.delete()
+            throw SessionNotCreatedException(e)
+        }
+        return appiumSession
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/DeleteSession.kt

@@ -0,0 +1,33 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.helpers.NotificationListener
+import io.appium.espressoserver.lib.http.Server
+import io.appium.espressoserver.lib.http.response.AppiumResponse
+import io.appium.espressoserver.lib.model.AppiumParams
+import io.appium.espressoserver.lib.model.GlobalSession
+
+class DeleteSession : RequestHandler<AppiumParams, AppiumResponse> {
+
+    override fun handleInternal(params: AppiumParams): AppiumResponse {
+        NotificationListener.stop()
+        GlobalSession.delete()
+        Server.makeRequestForServerToStop()
+        return AppiumResponse(null, null)
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/DismissAlert.kt

@@ -0,0 +1,32 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.helpers.AlertHelpers
+import io.appium.espressoserver.lib.model.AlertParams
+
+class DismissAlert : RequestHandler<AlertParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AlertParams): Void? {
+        // We use UIA2 here, since Espresso is limited to application sandbox
+        // and cannot handle security alerts
+        AlertHelpers.handle(AlertHelpers.AlertAction.DISMISS, params.buttonLabel)
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/DrawerActionHandler.kt

@@ -0,0 +1,45 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import androidx.test.espresso.EspressoException
+import androidx.test.espresso.contrib.DrawerActions
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.model.DrawerActionParams
+import io.appium.espressoserver.lib.model.EspressoElement
+
+class DrawerActionHandler(private val isOpenAction: Boolean) : RequestHandler<DrawerActionParams, Void?> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: DrawerActionParams): Void? {
+        val viewInteraction = EspressoElement.getViewInteractionById(params.elementId)
+        try {
+            params.gravity?.let {gravity ->
+                viewInteraction.perform(if (isOpenAction) DrawerActions.open(gravity) else DrawerActions.close(gravity))
+            } ?: run {
+                viewInteraction.perform(if (isOpenAction) DrawerActions.open() else DrawerActions.close())
+            }
+        } catch (e: Exception) {
+            if (e is EspressoException) {
+                throw AppiumException(String.format("Could not %s drawer. Reason: %s", if (isOpenAction) "open" else "close", e))
+            }
+            throw e
+        }
+
+        return null
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/ElementEquals.kt

@@ -0,0 +1,19 @@
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.handlers.exceptions.InvalidArgumentException
+import io.appium.espressoserver.lib.model.AppiumParams
+import io.appium.espressoserver.lib.model.EspressoElement
+
+class ElementEquals : RequestHandler<AppiumParams, Boolean> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AppiumParams): Boolean {
+        val elementId = params.elementId
+        val otherElementId = params.getUriParameterValue("otherId")
+                ?: throw InvalidArgumentException("'otherElementId' query parameter not found")
+        val viewOne = EspressoElement.getViewById(elementId)
+        val viewTwo = EspressoElement.getViewById(otherElementId)
+        return viewOne == viewTwo
+    }
+}

package/espresso-server/app/src/androidTest/java/io/appium/espressoserver/lib/handlers/ElementScreenshot.kt

@@ -0,0 +1,31 @@
+/*
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * See the NOTICE file distributed with this work for additional
+ * information regarding copyright ownership.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package io.appium.espressoserver.lib.handlers
+
+import io.appium.espressoserver.lib.handlers.exceptions.AppiumException
+import io.appium.espressoserver.lib.helpers.ScreenshotsHelper
+import io.appium.espressoserver.lib.model.AppiumParams
+import io.appium.espressoserver.lib.model.EspressoElement
+
+class ElementScreenshot : RequestHandler<AppiumParams, String> {
+
+    @Throws(AppiumException::class)
+    override fun handleInternal(params: AppiumParams): String {
+        val view = EspressoElement.getViewById(params.elementId)
+        return ScreenshotsHelper(view).screenshot
+    }
+}