Add appium collection condition and appium condition classes

README.md

@@ -86,6 +86,34 @@ boolean isAndroid = AppiumDriverRunner.isAndroidDriver();
 boolean isIos = AppiumDriverRunner.isIosDriver();
 ```
 
+4. Rich Assertions
+
+In Appium, it is common that we want to extract values from different attributes.
+
+_Appium way:_
+```java
+public String getAttribute(){
+  return driver instance of AndroidDriver 
+    ? mobileELement.getAttribute("content-desc")
+    : mobileELement.getAttribute("name")
+  }
+
+//Assertion in test
+Assertions.assertThat(getAttribute()).isEqualTo("expected-value")  
+```
+_Selenide-Appium way:_
+```
+$(mobileElement)
+      .shouldHave(AppiumCondition.attributeWithValue("content-desc", "name", "expected-value"));
+```
+
+We can also assert collection
+```java
+List<String> expectedList = Arrays.asList("API Demos", "KeyEventText", "Linkify", "LogTextBox", "Marquee", "Unicode");
+
+$$(AppiumBy.xpath("//android.widget.TextView"))
+      .shouldHave(AppiumCollectionCondition.exactAttributes("text", "name", expectedList));
+```
 ### Changelog
 
 Here is [CHANGELOG](https://github.com/selenide/selenide-appium/blob/main/CHANGELOG)

src/main/java/com/codeborne/selenide/appium/AppiumCollectionCondition.java

@@ -0,0 +1,22 @@
+package com.codeborne.selenide.appium;
+
+import com.codeborne.selenide.CollectionCondition;
+import com.codeborne.selenide.appium.conditions.AppiumAttributeValues;
+
+import java.util.List;
+
+public class AppiumCollectionCondition {
+
+  private AppiumCollectionCondition() {
+  }
+
+  public static CollectionCondition exactAttributes(String androidAttributeName, String iosAttributeName,
+                                                    String... expectedAttributeValues) {
+    return new AppiumAttributeValues(androidAttributeName, iosAttributeName, expectedAttributeValues);
+  }
+
+  public static CollectionCondition exactAttributes(String androidAttributeName, String iosAttributeName,
+                                                    List<String> expectedAttributeValues) {
+    return new AppiumAttributeValues(androidAttributeName, iosAttributeName, expectedAttributeValues);
+  }
+}

src/main/java/com/codeborne/selenide/appium/AppiumCondition.java

@@ -0,0 +1,24 @@
+package com.codeborne.selenide.appium;
+
+import com.codeborne.selenide.Condition;
+import com.codeborne.selenide.conditions.AttributeWithValue;
+
+public class AppiumCondition {
+
+  private AppiumCondition() {
+  }
+
+  public static Condition attributeWithValue(String androidAttributeName, String iosAttributeName, String expectedAttributeValue) {
+    return AppiumDriverRunner.isAndroidDriver()
+      ? androidAttributeWithValue(androidAttributeName, expectedAttributeValue)
+      : iosAttributeWithValue(iosAttributeName, expectedAttributeValue);
+  }
+
+  public static Condition androidAttributeWithValue(String androidAttributeName, String expectedAttributeValue) {
+    return new AttributeWithValue(androidAttributeName, expectedAttributeValue);
+  }
+
+  public static Condition iosAttributeWithValue(String iosAttributeName, String expectedAttributeValue) {
+    return new AttributeWithValue(iosAttributeName, expectedAttributeValue);
+  }
+}

src/main/java/com/codeborne/selenide/appium/conditions/AppiumAttributeValues.java

@@ -0,0 +1,59 @@
+package com.codeborne.selenide.appium.conditions;
+
+import com.codeborne.selenide.appium.AppiumDriverRunner;
+import com.codeborne.selenide.collections.ExactTexts;
+import org.openqa.selenium.WebElement;
+
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+
+public class AppiumAttributeValues extends ExactTexts {
+
+  protected String androidAttributeName;
+  protected String iosAttributeName;
+
+  public AppiumAttributeValues(String androidAttributeName, String iosAttributeName, String... expectedAttributeValues) {
+    super(expectedAttributeValues);
+    this.androidAttributeName = androidAttributeName;
+    this.iosAttributeName = iosAttributeName;
+  }
+
+  public AppiumAttributeValues(String androidAttributeName, String iosAttributeName, List<String> expectedAttributeValues) {
+    super(expectedAttributeValues);
+    this.androidAttributeName = androidAttributeName;
+    this.iosAttributeName = iosAttributeName;
+  }
+
+  @Override
+  public boolean test(List<WebElement> elements) {
+
+    if (elements.size() != this.expectedTexts.size()) {
+      return false;
+    } else {
+      List<String> actualAttributeValues = getActualAttributeValuesToCompare(elements);
+      for (int i = 0; i < this.expectedTexts.size(); ++i) {
+        String expectedText = this.expectedTexts.get(i);
+        String actualAttributeValue = actualAttributeValues.get(i);
+        if (!expectedText.equals(actualAttributeValue)) {
+          return false;
+        }
+      }
+
+      return true;
+    }
+  }
+
+  private List<String> getActualAttributeValuesToCompare(List<WebElement> elements) {
+    return elements.stream().map(getFunctionBasedOnMobileOs()).collect(Collectors.toList());
+  }
+
+  private Function<WebElement, String> getFunctionBasedOnMobileOs() {
+    Map<Boolean, Function<WebElement, String>> map = new HashMap<>();
+    map.put(true, element -> element.getAttribute(androidAttributeName));
+    map.put(false, element -> element.getAttribute(iosAttributeName));
+    return map.get(AppiumDriverRunner.isAndroidDriver());
+  }
+}

src/test/java/integration/android/AndroidAppiumConditionsTest.java

@@ -0,0 +1,43 @@
+package integration.android;
+
+import com.codeborne.selenide.appium.AppiumCollectionCondition;
+import com.codeborne.selenide.appium.AppiumCondition;
+import com.codeborne.selenide.appium.SelenideAppium;
+import io.appium.java_client.AppiumBy;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+import org.openqa.selenium.By;
+
+import java.util.Arrays;
+import java.util.List;
+
+import static com.codeborne.selenide.Selenide.$;
+import static com.codeborne.selenide.Selenide.$$;
+import static com.codeborne.selenide.WebDriverRunner.closeWebDriver;
+
+class AndroidAppiumConditionsTest extends BaseApiDemosTest {
+
+  @BeforeEach
+  void setUp() {
+    closeWebDriver();
+    SelenideAppium.launchApp();
+  }
+
+  @Test
+  void testAppiumCollectionConditionAttribute() {
+
+    List<String> expectedList =
+      Arrays.asList("API Demos", "KeyEventText", "Linkify", "LogTextBox", "Marquee", "Unicode");
+
+    $(By.xpath(".//*[@text='Text']")).click();
+    $$(AppiumBy.xpath("//android.widget.TextView"))
+      .shouldHave(AppiumCollectionCondition.exactAttributes("text", "name", expectedList));
+  }
+
+  @Test
+  void testAppiumConditionAttribute() {
+
+    $(AppiumBy.accessibilityId("Accessibility"))
+      .shouldHave(AppiumCondition.attributeWithValue("content-desc", "name", "Accessibility"));
+  }
+}

src/test/java/integration/ios/IosAppiumConditionsTest.java

@@ -0,0 +1,31 @@
+package integration.ios;
+
+import com.codeborne.selenide.CollectionCondition;
+import com.codeborne.selenide.appium.AppiumCollectionCondition;
+import com.codeborne.selenide.appium.AppiumCondition;
+import com.codeborne.selenide.appium.AppiumSelectors;
+import com.codeborne.selenide.appium.SelenideAppium;
+import org.junit.jupiter.api.Test;
+
+import static com.codeborne.selenide.Selenide.$$;
+import static com.codeborne.selenide.Selenide.$;
+
+class IosAppiumConditionsTest extends BaseSwagLabsAppIosTest {
+
+  @Test
+  void testAppiumCollectionConditionAttribute() {
+    SelenideAppium.openIOSDeepLink("mydemoapprn://login");
+    $$(AppiumSelectors.byAttribute("type", "XCUIElementTypeTextField"))
+      .shouldBe(CollectionCondition.size(1))
+      .shouldHave(AppiumCollectionCondition
+                    .exactAttributes("text", "name", "Username input field"));
+  }
+
+  @Test
+  void testAppiumConditionAttribute() {
+    SelenideAppium.openIOSDeepLink("mydemoapprn://login");
+    $(AppiumSelectors.byAttribute("type", "XCUIElementTypeTextField"))
+      .shouldHave(AppiumCondition.iosAttributeWithValue("name", "Username input field"))
+      .shouldHave(AppiumCondition.attributeWithValue("", "name", "Username input field"));
+  }
+}