Kea2-python 0.0.1a6__tar.gz → 0.0.1b0__tar.gz

{kea2_python-0.0.1a6 → kea2_python-0.0.1b0/Kea2_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.0.1a6
+Version: 0.0.1b0
 Summary: A python library for supporting and customizing automated UI testing for mobile apps
 Author-email: Xixian Liang <xixian@stu.ecnu.edu.cn>
 Requires-Python: >=3.8
@@ -12,6 +12,10 @@ Dynamic: license-file
 
 # Introduction 
 
+[![PyPI](https://img.shields.io/pypi/v/kea2-python.svg)](https://pypi.python.org/pypi/kea2-python)
+[![PyPI Downloads](https://static.pepy.tech/badge/kea2-python)](https://pepy.tech/projects/kea2-python)
+![Python](https://img.shields.io/badge/python-3.8%2B-blue)
+
 Kea2 is an easy-to-use Python library for supporting, customizing and improving automated UI testing for mobile apps. The library is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android) and [uiautomator2](https://github.com/openatx/uiautomator2), and targeting [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps.
 
 ### Kea2 has three important features:
@@ -297,16 +301,30 @@ class MyFirstTest(unittest.TestCase):
 You can read [Kea - Write your fisrt property](https://kea-docs.readthedocs.io/en/latest/part-keaUserManuel/first_property.html) for more details.
 
 ### Notes
-Currently, in `@precondition` decorator and `widgets.block.py`. We only support basic selector (No parent-child relationship) and basic xpath (No chain call like `.xpath().xpath()`) in uiautomator2. The Script body in the function fully support uiautomator2.
-
+Currently, in `@precondition` decorator and `widgets.block.py`. We only support basic selector (No parent-child relationship) in uiautomator2. The Script body in the function fully support uiautomator2.
 
 | | **Support** | **Not support** |
 | -- | -- | -- |
 | **Selctor** | `d(text="1").exist` | `d(text="1").child(text="2").exist` |
-| **XPath** | `d.xpath(".//[@text='1']")` | `d.xpath(".//[@text='1']").xpath(".//[@text]='2'")` |
 
 If you need to specify `parent-child` relation ship in `@precondition`, specify it in xpath.
 
+for example: 
+
+```python
+# Do not use:
+# @precondition(lambda self: 
+#      self.d(className="android.widget.ListView").child(text="Bluetooth")
+# ):
+# ...
+
+# Use
+@precondition(lambda self: 
+    self.d.xpath('//android.widget.ListView/*[@text="Bluetooth"]')
+):
+...
+```
+
 
 ## Launching Kea2
 

kea2_python-0.0.1a6/README.md → kea2_python-0.0.1b0/PKG-INFO

@@ -1,5 +1,21 @@
+Metadata-Version: 2.4
+Name: Kea2-python
+Version: 0.0.1b0
+Summary: A python library for supporting and customizing automated UI testing for mobile apps
+Author-email: Xixian Liang <xixian@stu.ecnu.edu.cn>
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rtree>=1.3.0
+Requires-Dist: uiautomator2>=3.2.9
+Dynamic: license-file
+
 # Introduction 
 
+[![PyPI](https://img.shields.io/pypi/v/kea2-python.svg)](https://pypi.python.org/pypi/kea2-python)
+[![PyPI Downloads](https://static.pepy.tech/badge/kea2-python)](https://pepy.tech/projects/kea2-python)
+![Python](https://img.shields.io/badge/python-3.8%2B-blue)
+
 Kea2 is an easy-to-use Python library for supporting, customizing and improving automated UI testing for mobile apps. The library is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android) and [uiautomator2](https://github.com/openatx/uiautomator2), and targeting [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps.
 
 ### Kea2 has three important features:
@@ -285,16 +301,30 @@ class MyFirstTest(unittest.TestCase):
 You can read [Kea - Write your fisrt property](https://kea-docs.readthedocs.io/en/latest/part-keaUserManuel/first_property.html) for more details.
 
 ### Notes
-Currently, in `@precondition` decorator and `widgets.block.py`. We only support basic selector (No parent-child relationship) and basic xpath (No chain call like `.xpath().xpath()`) in uiautomator2. The Script body in the function fully support uiautomator2.
-
+Currently, in `@precondition` decorator and `widgets.block.py`. We only support basic selector (No parent-child relationship) in uiautomator2. The Script body in the function fully support uiautomator2.
 
 | | **Support** | **Not support** |
 | -- | -- | -- |
 | **Selctor** | `d(text="1").exist` | `d(text="1").child(text="2").exist` |
-| **XPath** | `d.xpath(".//[@text='1']")` | `d.xpath(".//[@text='1']").xpath(".//[@text]='2'")` |
 
 If you need to specify `parent-child` relation ship in `@precondition`, specify it in xpath.
 
+for example: 
+
+```python
+# Do not use:
+# @precondition(lambda self: 
+#      self.d(className="android.widget.ListView").child(text="Bluetooth")
+# ):
+# ...
+
+# Use
+@precondition(lambda self: 
+    self.d.xpath('//android.widget.ListView/*[@text="Bluetooth"]')
+):
+...
+```
+
 
 ## Launching Kea2
 

kea2_python-0.0.1a6/Kea2_python.egg-info/PKG-INFO → kea2_python-0.0.1b0/README.md

@@ -1,17 +1,9 @@
-Metadata-Version: 2.4
-Name: Kea2-python
-Version: 0.0.1a6
-Summary: A python library for supporting and customizing automated UI testing for mobile apps
-Author-email: Xixian Liang <xixian@stu.ecnu.edu.cn>
-Requires-Python: >=3.8
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rtree>=1.3.0
-Requires-Dist: uiautomator2>=3.2.9
-Dynamic: license-file
-
 # Introduction 
 
+[![PyPI](https://img.shields.io/pypi/v/kea2-python.svg)](https://pypi.python.org/pypi/kea2-python)
+[![PyPI Downloads](https://static.pepy.tech/badge/kea2-python)](https://pepy.tech/projects/kea2-python)
+![Python](https://img.shields.io/badge/python-3.8%2B-blue)
+
 Kea2 is an easy-to-use Python library for supporting, customizing and improving automated UI testing for mobile apps. The library is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android) and [uiautomator2](https://github.com/openatx/uiautomator2), and targeting [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps.
 
 ### Kea2 has three important features:
@@ -297,16 +289,30 @@ class MyFirstTest(unittest.TestCase):
 You can read [Kea - Write your fisrt property](https://kea-docs.readthedocs.io/en/latest/part-keaUserManuel/first_property.html) for more details.
 
 ### Notes
-Currently, in `@precondition` decorator and `widgets.block.py`. We only support basic selector (No parent-child relationship) and basic xpath (No chain call like `.xpath().xpath()`) in uiautomator2. The Script body in the function fully support uiautomator2.
-
+Currently, in `@precondition` decorator and `widgets.block.py`. We only support basic selector (No parent-child relationship) in uiautomator2. The Script body in the function fully support uiautomator2.
 
 | | **Support** | **Not support** |
 | -- | -- | -- |
 | **Selctor** | `d(text="1").exist` | `d(text="1").child(text="2").exist` |
-| **XPath** | `d.xpath(".//[@text='1']")` | `d.xpath(".//[@text='1']").xpath(".//[@text]='2'")` |
 
 If you need to specify `parent-child` relation ship in `@precondition`, specify it in xpath.
 
+for example: 
+
+```python
+# Do not use:
+# @precondition(lambda self: 
+#      self.d(className="android.widget.ListView").child(text="Bluetooth")
+# ):
+# ...
+
+# Use
+@precondition(lambda self: 
+    self.d.xpath('//android.widget.ListView/*[@text="Bluetooth"]')
+):
+...
+```
+
 
 ## Launching Kea2
 

{kea2_python-0.0.1a6 → kea2_python-0.0.1b0}/kea2/keaUtils.py

@@ -97,6 +97,10 @@ class Options:
     # the output_dir for saving logs and results
     output_dir: str = "output"
 
+    def __post_init__(self):
+        if self.serial and self.Driver:
+            self.Driver.setDeviceSerial(self.serial)
+
 
 @dataclass
 class PropStatistic:

{kea2_python-0.0.1a6 → kea2_python-0.0.1b0}/kea2/kea_launcher.py

@@ -130,7 +130,6 @@ def run(args=None):
 
     from kea2 import KeaTestRunner, Options
     from kea2.u2Driver import U2Driver
-    U2Driver.setDeviceSerial(args.serial)
     options = Options(
         agent=args.agent,
         driverName=args.driver_name,

{kea2_python-0.0.1a6 → kea2_python-0.0.1b0}/kea2/u2Driver.py

@@ -88,7 +88,9 @@ class StaticU2UiObject(u2.UiObject):
     def _transferU2Keys(self, originKey):
         filterDict = {
             "resourceId": "resource-id",
-            "description": "content-desc"
+            "description": "content-desc",
+            "className": "class",
+            "longClickable": "long-clickable",
         }
         if filterDict.get(originKey, None):
             return filterDict[originKey]
@@ -237,6 +239,7 @@ class _XPathEntry(u2.xpath.XPathEntry):
         super().__init__(d)
         
     def __call__(self, xpath, source = None):
+        # TODO fully support xpath in widget.block.py
         self.xpath = xpath
         return super().__call__(xpath, source)
 

{kea2_python-0.0.1a6 → kea2_python-0.0.1b0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Kea2-python"
-version = "0.0.1a6"
+version = "0.0.1b0"
 description = "A python library for supporting and customizing automated UI testing for mobile apps"
 readme = "README.md"
 requires-python = ">=3.8"