1616
1717import json
1818
19- from selenium import webdriver
20- from selenium .webdriver .remote .webelement import \
21- WebElement as SeleniumWebElement
22-
2319from appium .webdriver .common .mobileby import MobileBy
2420
25-
26- class BaseSearchContext (object ):
27- """Used by each search context. Dummy find_element/s are for preventing pylint error"""
28-
29- def find_element (self , by = None , value = None ):
30- raise NotImplementedError
31-
32- def find_elements (self , by = None , value = None ):
33- raise NotImplementedError
21+ from .base_search_context import BaseSearchContext
3422
3523
3624class AndroidSearchContext (BaseSearchContext ):
@@ -58,6 +46,9 @@ def find_element_by_android_data_matcher(self, name=None, args=None, className=N
5846
5947 Usage:
6048 driver.find_element_by_android_data_matcher(name='hasEntry', args=['title', 'Animation'])
49+
50+ # To enable auto completion in PyCharm(IDE)
51+ :rtype: `appium.webdriver.webelement.WebElement`
6152 """
6253
6354 return self .find_element (
@@ -83,6 +74,8 @@ def find_elements_by_android_data_matcher(self, name=None, args=None, className=
8374
8475 Usage:
8576 driver.find_elements_by_android_data_matcher(name='hasEntry', args=['title', 'Animation'])
77+
78+ :rtype: `appium.webdriver.webelement.WebElement`
8679 """
8780
8881 return self .find_elements (
@@ -99,12 +92,70 @@ def _build_data_matcher(self, name=None, args=None, className=None):
9992
10093 return json .dumps (result )
10194
95+ def find_element_by_android_uiautomator (self , uia_string ):
96+ """Finds element by uiautomator in Android.
97+
98+ Args:
99+ uia_string: The element name in the Android UIAutomator library
100+
101+ Usage:
102+ driver.find_element_by_android_uiautomator('.elements()[1].cells()[2]')
103+
104+ Returns:
105+ `appium.webdriver.webelement.WebElement`
106+
107+ :rtype: `appium.webdriver.webelement.WebElement`
108+ """
109+ return self .find_element (by = MobileBy .ANDROID_UIAUTOMATOR , value = uia_string )
110+
111+ def find_elements_by_android_uiautomator (self , uia_string ):
112+ """Finds elements by uiautomator in Android.
113+
114+ Args:
115+ uia_string (str): The element name in the Android UIAutomator library
116+
117+ Usage:
118+ driver.find_elements_by_android_uiautomator('.elements()[1].cells()[2]')
119+
120+ Returns:
121+ :obj:`list` of :obj:`appium.webdriver.webelement.WebElement`
122+
123+ :rtype: list of `appium.webdriver.webelement.WebElement`
124+ """
125+ return self .find_elements (by = MobileBy .ANDROID_UIAUTOMATOR , value = uia_string )
126+
127+ def find_element_by_android_viewtag (self , tag ):
128+ """Finds element by [View#tags](https://developer.android.com/reference/android/view/View#tags) in Android.
102129
103- class AppiumSearchContext (webdriver .Remote ,
104- AndroidSearchContext ):
105- """Returns appium driver search conext"""
130+ It works with [Espresso Driver](https://github.com/appium/appium-espresso-driver).
131+
132+ Args:
133+ tag (str): The tag name of the view to look for
106134
135+ Usage:
136+ driver.find_element_by_android_viewtag('a tag name')
137+
138+ Returns:
139+ `appium.webdriver.webelement.WebElement`
140+
141+ :rtype: `appium.webdriver.webelement.WebElement`
142+ """
143+ return self .find_element (by = MobileBy .ANDROID_VIEWTAG , value = tag )
107144
108- class AppiumWebElementSearchContext (SeleniumWebElement ,
109- AndroidSearchContext ):
110- """Returns appium web element search context"""
145+ def find_elements_by_android_viewtag (self , tag ):
146+ """Finds element by [View#tags](https://developer.android.com/reference/android/view/View#tags) in Android.
147+
148+ It works with [Espresso Driver](https://github.com/appium/appium-espresso-driver).
149+
150+ Args:
151+ tag (str): The tag name of the view to look for
152+
153+ Usage:
154+ driver.find_elements_by_android_viewtag('a tag name')
155+
156+ Returns:
157+ :obj:`list` of :obj:`appium.webdriver.webelement.WebElement`
158+
159+ :rtype: list of `appium.webdriver.webelement.WebElement`
160+ """
161+ return self .find_elements (by = MobileBy .ANDROID_VIEWTAG , value = tag )
0 commit comments