support parent node selection

Author: adolli

poco/proxy.py

@@ -189,6 +189,25 @@ def sibling(self, name=None, **attrs):
         obj.query = query
         return obj
 
+    def parent(self):
+        """
+        Select the direct child(ren) from the UI element(s) given by the query expression, see ``QueryCondition`` for
+        more details about the selectors.
+
+        Warnings:
+            Experimental method, may not be available for all drivers.
+
+        Returns:
+            :py:class:`UIObjectProxy <poco.proxy.UIObjectProxy>`: a new UI proxy object representing the direct parent
+            of the first UI element.
+        """
+
+        sub_query = build_query(None)  # as placeholder
+        query = ('^', (self.query, sub_query))
+        obj = UIObjectProxy(self.poco)
+        obj.query = query
+        return obj
+
     def __getitem__(self, item):
         """
         Select the specific UI element by index. If this UI proxy represents a set of UI elements, then use this method

poco/proxy.pyi

@@ -30,6 +30,9 @@ class UIObjectProxy(object):
     def sibling(self, name: Text=None, **attrs) -> UIObjectProxy:
         ...
 
+    def parent(self) -> UIObjectProxy:
+        ...
+
     def __getitem__(self, item: int) -> UIObjectProxy:
         ...
 

poco/sdk/Selector.py

@@ -44,7 +44,8 @@ class Selector(ISelector):
         '>': offsprings, select all offsprings matched expr1 from all roots matched expr0.
         '/': children, select all children matched expr1 from all roots matched expr0.
         '-': siblings, select all siblings matched expr1 from all roots matched expr0.
-    
+        '^': parent, select the parent of 1st UI element matched expr0. expr1 is always None.
+
     - ``'index'``: select specific n-th UI element from the previous results
 
     - ``others``: passes the expression to matcher
@@ -137,6 +138,15 @@ def selectImpl(self, cond, multiple, root, maxDepth, onlyVisibleNode, includeRoo
             except IndexError:
                 raise NoSuchTargetException(
                     u'Query results index out of range. Index={} condition "{}" from root "{}".'.format(i, cond, root))
+        elif op == '^':
+            # parent
+            # only select parent of the first matched UI element
+            query1, _ = args
+            result1 = self.selectImpl(query1, False, root, maxDepth, onlyVisibleNode, includeRoot)
+            if result1:
+                parent_node = result1[0].getParent()
+                if parent_node is not None:
+                    result = [parent_node]
         else:
             self._selectTraverse(cond, root, result, multiple, maxDepth, onlyVisibleNode, includeRoot)
 

poco/utils/query_util.py

@@ -19,6 +19,7 @@
     '/': '/',
     '>': '>',
     '-': '-',
+    '^': '\'s parent',
 }
 
 
@@ -27,7 +28,7 @@
 
 def query_expr(query):
     op = query[0]
-    if op in ('/', '>', '-'):
+    if op in ('/', '>', '-', '^'):
         return TranslateOp[op].join([query_expr(q) for q in query[1]])
     elif op == 'index':
         return '{}[{}]'.format(query_expr(query[1][0]), query[1][1])

setup.py

@@ -10,7 +10,7 @@ def parse_requirements(filename='requirements.txt'):
 
 setup(
     name='pocoui',
-    version='1.0.72',
+    version='1.0.73',
     keywords="poco, automation test, ui automation",
     description='Poco cross-engine UI automated test framework.',
     long_description='Poco cross-engine UI automated test framework. 2018 present by NetEase Games',