Kea2-python 0.0.1b1__tar.gz → 0.0.1b2__tar.gz

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.0.1b1
+Version: 0.0.1b2
 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
@@ -61,13 +61,14 @@ In the future, Kea2 will be extended to support
 Running requirements/environment:
 - support Windows, MacOS and Linux
 - python 3.8+
+- Android 4.4+
 - Android SDK installed
 - **VPN closed** (Features 2 and 3 required)
 
 
 Install Kea2 by `pip`:
 ```bash
-python3 -m pip install Kea2-python
+python3 -m pip install kea2-python
 ```
 
 Find Kea2's additional options by running 
@@ -304,31 +305,6 @@ 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) 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` |
-
-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
 
@@ -353,16 +329,17 @@ kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --runn
 kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -s mytests/omni_notes
 ```
 
-| arg | meaning |
-| --- | --- |
-| -s | The serial of your device, which can be found by `adb devices` |
-| -p | The tested app's package name (e.g., com.example.app) | 
-| -o | The ouput directory for logs and results |
-| --agent |  {native, u2}. By default, `u2` is used and supports all the three important features of Kea2. If you hope to run the orignal Fastbot, please use `native`.|
-| --running-minutes | The time (m) to run Kea2 | 
-| --max-step | The maxium number of monkey events to send (only available in `--agent u2`) | 
-| --throttle | The delay time (ms) between two monkey events |
+| arg | meaning | default | 
+| --- | --- | --- |
+| -s | The serial of your device, which can be found by `adb devices` | |
+| -p | *The tested app's package name (e.g., com.example.app) | 
+| -o | The ouput directory for logs and results | `output` |
+| --agent |  {native, u2}. By default, `u2` is used and supports all the three important features of Kea2. If you hope to run the orignal Fastbot, please use `native`.| `u2` |
+| --running-minutes | The time (m) to run Kea2 | `10` |
+| --max-step | The maxium number of monkey events to send (only available in `--agent u2`) | `inf` |
+| --throttle | The delay time (ms) between two monkey events | `200` |
 | --driver-name | The name of driver used in the script. If `--driver-name d` is specified, you should use `d` to interact with a device, e..g, `self.d(..).click()`. |
+| --log-stamp | the stamp for log file and result file, default: current time stamp | |
 | unittest | Specify to load which scripts. This  sub-command `unittest` is fully compatible with unittest. See `python3 -m unittest -h` for more options of unittest. This option is only available in `--agent u2`.
 
 
@@ -425,6 +402,8 @@ running_mins: int = 10
 throttle: int = 200
 # the output_dir for saving logs and results
 output_dir: str = "output"
+# the stamp for log file and result file, default: current time stamp
+log_stamp: str = None
 ```
 
 ## Examining the running statistics of scripts .
@@ -469,6 +448,17 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 - [uiautomator2](https://github.com/openatx/uiautomator2)
 - [hypothesis](https://github.com/HypothesisWorks/hypothesis)
 
+### Relevant papers of Kea2
+
+> General and Practical Property-based Testing for Android Apps. ASE 2024. [pdf](https://dl.acm.org/doi/10.1145/3691620.3694986)
+
+> An Empirical Study of Functional Bugs in Android Apps. ISSTA 2023. [pdf](https://dl.acm.org/doi/10.1145/3597926.3598138)
+
+> Fastbot2: Reusable Automated Model-based GUI Testing for Android Enhanced by Reinforcement Learning. ASE 2022. [pdf](https://dl.acm.org/doi/10.1145/3551349.3559505)
+
+> Guided, Stochastic Model-Based GUI Testing of Android Apps. ESEC/FSE 2017.  [pdf](https://dl.acm.org/doi/10.1145/3106237.3106298)
+
+
 [^1]: 不少UI自动化测试工具提供了“自定义事件序列”能力（如[Fastbot](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E5%BA%8F%E5%88%97) 和[AppCrawler](https://github.com/seveniruby/AppCrawler)），但在实际使用中存在不少问题，如自定义能力有限、使用不灵活等。此前不少Fastbot用户抱怨过其“自定义事件序列”在使用中的问题，如[#209](https://github.com/bytedance/Fastbot_Android/issues/209), [#225](https://github.com/bytedance/Fastbot_Android/issues/225), [#286](https://github.com/bytedance/Fastbot_Android/issues/286)等。
 
 [^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/Kea2_python.egg-info/SOURCES.txt

@@ -21,7 +21,6 @@ kea2/assets/framework.jar
 kea2/assets/monkeyq.jar
 kea2/assets/quicktest.py
 kea2/assets/u2.jar
-kea2/assets/fastbot_configs/ADBKeyBoard.apk
 kea2/assets/fastbot_configs/abl.strings
 kea2/assets/fastbot_configs/awl.strings
 kea2/assets/fastbot_configs/max.config

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.0.1b1
+Version: 0.0.1b2
 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
@@ -61,13 +61,14 @@ In the future, Kea2 will be extended to support
 Running requirements/environment:
 - support Windows, MacOS and Linux
 - python 3.8+
+- Android 4.4+
 - Android SDK installed
 - **VPN closed** (Features 2 and 3 required)
 
 
 Install Kea2 by `pip`:
 ```bash
-python3 -m pip install Kea2-python
+python3 -m pip install kea2-python
 ```
 
 Find Kea2's additional options by running 
@@ -304,31 +305,6 @@ 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) 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` |
-
-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
 
@@ -353,16 +329,17 @@ kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --runn
 kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -s mytests/omni_notes
 ```
 
-| arg | meaning |
-| --- | --- |
-| -s | The serial of your device, which can be found by `adb devices` |
-| -p | The tested app's package name (e.g., com.example.app) | 
-| -o | The ouput directory for logs and results |
-| --agent |  {native, u2}. By default, `u2` is used and supports all the three important features of Kea2. If you hope to run the orignal Fastbot, please use `native`.|
-| --running-minutes | The time (m) to run Kea2 | 
-| --max-step | The maxium number of monkey events to send (only available in `--agent u2`) | 
-| --throttle | The delay time (ms) between two monkey events |
+| arg | meaning | default | 
+| --- | --- | --- |
+| -s | The serial of your device, which can be found by `adb devices` | |
+| -p | *The tested app's package name (e.g., com.example.app) | 
+| -o | The ouput directory for logs and results | `output` |
+| --agent |  {native, u2}. By default, `u2` is used and supports all the three important features of Kea2. If you hope to run the orignal Fastbot, please use `native`.| `u2` |
+| --running-minutes | The time (m) to run Kea2 | `10` |
+| --max-step | The maxium number of monkey events to send (only available in `--agent u2`) | `inf` |
+| --throttle | The delay time (ms) between two monkey events | `200` |
 | --driver-name | The name of driver used in the script. If `--driver-name d` is specified, you should use `d` to interact with a device, e..g, `self.d(..).click()`. |
+| --log-stamp | the stamp for log file and result file, default: current time stamp | |
 | unittest | Specify to load which scripts. This  sub-command `unittest` is fully compatible with unittest. See `python3 -m unittest -h` for more options of unittest. This option is only available in `--agent u2`.
 
 
@@ -425,6 +402,8 @@ running_mins: int = 10
 throttle: int = 200
 # the output_dir for saving logs and results
 output_dir: str = "output"
+# the stamp for log file and result file, default: current time stamp
+log_stamp: str = None
 ```
 
 ## Examining the running statistics of scripts .
@@ -469,6 +448,17 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 - [uiautomator2](https://github.com/openatx/uiautomator2)
 - [hypothesis](https://github.com/HypothesisWorks/hypothesis)
 
+### Relevant papers of Kea2
+
+> General and Practical Property-based Testing for Android Apps. ASE 2024. [pdf](https://dl.acm.org/doi/10.1145/3691620.3694986)
+
+> An Empirical Study of Functional Bugs in Android Apps. ISSTA 2023. [pdf](https://dl.acm.org/doi/10.1145/3597926.3598138)
+
+> Fastbot2: Reusable Automated Model-based GUI Testing for Android Enhanced by Reinforcement Learning. ASE 2022. [pdf](https://dl.acm.org/doi/10.1145/3551349.3559505)
+
+> Guided, Stochastic Model-Based GUI Testing of Android Apps. ESEC/FSE 2017.  [pdf](https://dl.acm.org/doi/10.1145/3106237.3106298)
+
+
 [^1]: 不少UI自动化测试工具提供了“自定义事件序列”能力（如[Fastbot](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E5%BA%8F%E5%88%97) 和[AppCrawler](https://github.com/seveniruby/AppCrawler)），但在实际使用中存在不少问题，如自定义能力有限、使用不灵活等。此前不少Fastbot用户抱怨过其“自定义事件序列”在使用中的问题，如[#209](https://github.com/bytedance/Fastbot_Android/issues/209), [#225](https://github.com/bytedance/Fastbot_Android/issues/225), [#286](https://github.com/bytedance/Fastbot_Android/issues/286)等。
 
 [^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/README.md

@@ -49,13 +49,14 @@ In the future, Kea2 will be extended to support
 Running requirements/environment:
 - support Windows, MacOS and Linux
 - python 3.8+
+- Android 4.4+
 - Android SDK installed
 - **VPN closed** (Features 2 and 3 required)
 
 
 Install Kea2 by `pip`:
 ```bash
-python3 -m pip install Kea2-python
+python3 -m pip install kea2-python
 ```
 
 Find Kea2's additional options by running 
@@ -292,31 +293,6 @@ 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) 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` |
-
-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
 
@@ -341,16 +317,17 @@ kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --runn
 kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -s mytests/omni_notes
 ```
 
-| arg | meaning |
-| --- | --- |
-| -s | The serial of your device, which can be found by `adb devices` |
-| -p | The tested app's package name (e.g., com.example.app) | 
-| -o | The ouput directory for logs and results |
-| --agent |  {native, u2}. By default, `u2` is used and supports all the three important features of Kea2. If you hope to run the orignal Fastbot, please use `native`.|
-| --running-minutes | The time (m) to run Kea2 | 
-| --max-step | The maxium number of monkey events to send (only available in `--agent u2`) | 
-| --throttle | The delay time (ms) between two monkey events |
+| arg | meaning | default | 
+| --- | --- | --- |
+| -s | The serial of your device, which can be found by `adb devices` | |
+| -p | *The tested app's package name (e.g., com.example.app) | 
+| -o | The ouput directory for logs and results | `output` |
+| --agent |  {native, u2}. By default, `u2` is used and supports all the three important features of Kea2. If you hope to run the orignal Fastbot, please use `native`.| `u2` |
+| --running-minutes | The time (m) to run Kea2 | `10` |
+| --max-step | The maxium number of monkey events to send (only available in `--agent u2`) | `inf` |
+| --throttle | The delay time (ms) between two monkey events | `200` |
 | --driver-name | The name of driver used in the script. If `--driver-name d` is specified, you should use `d` to interact with a device, e..g, `self.d(..).click()`. |
+| --log-stamp | the stamp for log file and result file, default: current time stamp | |
 | unittest | Specify to load which scripts. This  sub-command `unittest` is fully compatible with unittest. See `python3 -m unittest -h` for more options of unittest. This option is only available in `--agent u2`.
 
 
@@ -413,6 +390,8 @@ running_mins: int = 10
 throttle: int = 200
 # the output_dir for saving logs and results
 output_dir: str = "output"
+# the stamp for log file and result file, default: current time stamp
+log_stamp: str = None
 ```
 
 ## Examining the running statistics of scripts .
@@ -457,6 +436,17 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 - [uiautomator2](https://github.com/openatx/uiautomator2)
 - [hypothesis](https://github.com/HypothesisWorks/hypothesis)
 
+### Relevant papers of Kea2
+
+> General and Practical Property-based Testing for Android Apps. ASE 2024. [pdf](https://dl.acm.org/doi/10.1145/3691620.3694986)
+
+> An Empirical Study of Functional Bugs in Android Apps. ISSTA 2023. [pdf](https://dl.acm.org/doi/10.1145/3597926.3598138)
+
+> Fastbot2: Reusable Automated Model-based GUI Testing for Android Enhanced by Reinforcement Learning. ASE 2022. [pdf](https://dl.acm.org/doi/10.1145/3551349.3559505)
+
+> Guided, Stochastic Model-Based GUI Testing of Android Apps. ESEC/FSE 2017.  [pdf](https://dl.acm.org/doi/10.1145/3106237.3106298)
+
+
 [^1]: 不少UI自动化测试工具提供了“自定义事件序列”能力（如[Fastbot](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E5%BA%8F%E5%88%97) 和[AppCrawler](https://github.com/seveniruby/AppCrawler)），但在实际使用中存在不少问题，如自定义能力有限、使用不灵活等。此前不少Fastbot用户抱怨过其“自定义事件序列”在使用中的问题，如[#209](https://github.com/bytedance/Fastbot_Android/issues/209), [#225](https://github.com/bytedance/Fastbot_Android/issues/225), [#286](https://github.com/bytedance/Fastbot_Android/issues/286)等。
 
 [^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/kea2/adbUtils.py

@@ -1,5 +1,5 @@
 import subprocess
-from typing import List, Optional
+from typing import List, Optional, Set
 from .utils import getLogger
 
 logger = getLogger(__name__)
@@ -223,6 +223,34 @@ def remove_all_forwards(device: Optional[str] = None):
     return run_adb_command(["-s", device, "forward", "--remove-all"])
 
 
+@ensure_device
+def get_packages(device: Optional[str] = None) -> Set[str]:
+    """
+    Retrieves packages that match the specified regular expression pattern.
+    
+    Parameters:
+        pattern (str): Regular expression pattern to match package names.
+        device (str, optional): The device serial number. If None, it is resolved automatically.
+        
+    Returns:
+        set: A set of package names that match the pattern.
+    """
+    import re
+    
+    cmd = ["-s", device, "shell", "pm", "list", "packages"]
+    output = run_adb_command(cmd)
+    
+    packages = set()
+    if output:
+        compiled_pattern = re.compile(r"package:(.+)\n")
+        matches = compiled_pattern.findall(output)
+        for match in matches:
+            if match:
+                packages.add(match)
+    
+    return packages
+
+
 if __name__ == '__main__':
     # For testing: print the list of currently connected devices.
     devices = get_devices()

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/kea2/cli.py

@@ -99,6 +99,7 @@ def main():
     args = parser.parse_args()
 
     import logging
+    logging.basicConfig(level=logging.INFO)
     if args.debug:
         logging.basicConfig(level=logging.DEBUG)
         logger.debug("args: %s", args)

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/kea2/keaUtils.py

@@ -119,6 +119,13 @@ class Options:
     output_dir: str = "output"
     # the stamp for log file and result file, default: current time stamp
     log_stamp: str = None
+    # the profiling period to get the coverage result.
+    profile_period: int = None
+
+    def __setattr__(self, name, value):
+        if value is None:
+            return
+        super().__setattr__(name, value)
 
     def __post_init__(self):
         if self.serial and self.Driver:
@@ -127,6 +134,17 @@ class Options:
             global LOGFILE, RESFILE
             LOGFILE = f"fastbot_{self.log_stamp}.log"
             RESFILE = f"result_{self.log_stamp}.json"
+        _check_package_installation(self.serial, self.packageNames)
+
+
+def _check_package_installation(serial, packageNames):
+    from .adbUtils import get_packages
+    installed_packages = get_packages(device=serial)
+
+    for package in packageNames:
+        if package not in installed_packages:
+            logger.error(f"package {package} not installed. Abort.")
+            raise ValueError("package not installed")
 
 
 @dataclass
@@ -257,7 +275,7 @@ def startFastbotService(options: Options) -> threading.Thread:
         "reuseq",
         "--running-minutes", f"{options.running_mins}",
         "--throttle", f"{options.throttle}",
-        "--bugreport", "--output-directory", "/sdcard/fastbot_report"
+        "--bugreport", "--output-directory", "/sdcard/fastbot_report",
         "-v", "-v", "-v"
     ]
 
@@ -354,18 +372,20 @@ class KeaTestRunner(TextTestRunner):
                 check_alive(port=self.scriptDriver.lport)
 
                 end_by_remote = False
-                step = 0
-                while step < self.options.maxStep:
+                self.stepsCount = 0
+                while self.stepsCount < self.options.maxStep:
 
-                    step += 1
+                    self.stepsCount += 1
                     print("[INFO] Sending monkeyEvent {}".format(
-                        f"({step} / {self.options.maxStep})" if self.options.maxStep != float("inf")
-                        else f"({step})"
+                        f"({self.stepsCount} / {self.options.maxStep})" if self.options.maxStep != float("inf")
+                        else f"({self.stepsCount})"
                         )
                     , flush=True)
 
                     try:
-                        propsSatisfiedPrecond = self.getValidProperties(result)
+                        xml_raw = self.stepMonkey()
+                        stat = self._getStat()
+                        propsSatisfiedPrecond = self.getValidProperties(xml_raw, result)
                     except requests.ConnectionError:
                         print(
                             "[INFO] Exploration times up (--running-minutes)."
@@ -462,6 +482,7 @@ class KeaTestRunner(TextTestRunner):
         r = requests.post(
             url=URL,
             json={
+                "steps_count": self.stepsCount,
                 "block_widgets": block_widgets
             }
         )
@@ -481,9 +502,8 @@ class KeaTestRunner(TextTestRunner):
         res = r.content.decode(encoding="utf-8")
         print(f"[Server INFO] {res}", flush=True)
 
-    def getValidProperties(self, result: JsonResult) -> PropertyStore:
+    def getValidProperties(self, xml_raw: str, result: JsonResult) -> PropertyStore:
 
-        xml_raw = self.stepMonkey()
         staticCheckerDriver = self.options.Driver.getStaticChecker(hierarchy=xml_raw)
 
         validProps: PropertyStore = dict()
@@ -513,6 +533,15 @@ class KeaTestRunner(TextTestRunner):
                 validProps[propName] = test
         return validProps
 
+    def _getStat(self):
+        # profile when reaching the profile period
+        if (self.options.profile_period and 
+            self.stepsCount % self.options.profile_period == 0
+        ):
+            URL = f"http://localhost:{self.scriptDriver.lport}/getStat"
+            r = requests.get(URL)
+            res = json.loads(r.content)
+
     def collectAllProperties(self, test: TestSuite):
         """collect all the properties to prepare for PBT
         """

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/kea2/kea_launcher.py

@@ -83,6 +83,14 @@ def _set_runner_parser(subparsers: "argparse._SubParsersAction[argparse.Argument
         required=False,
         help="the stamp for log file and result file, default: current time stamp",
     )
+    
+    parser.add_argument(
+        "--profile-period",
+        dest="profile_period",
+        type=int,
+        required=False,
+        help="Steps to profile the testing statistics.",
+    )
 
     parser.add_argument(
         "extra",
@@ -120,6 +128,7 @@ def parse_args(argv: List):
     args = parser.parse_args(argv)
     return args
 
+
 def _sanitize_args(args):
     if args.agent == "u2" and not args.driver_name:
         if args.extra == []:
@@ -127,6 +136,7 @@ def _sanitize_args(args):
         else:
             raise ValueError("--driver-name should be specified when customizing script in --agent u2")
 
+
 def run(args=None):
     if args is None:
         args = parse_args(sys.argv[1:])
@@ -144,10 +154,11 @@ def run(args=None):
         Driver=U2Driver,
         packageNames=args.package_names,
         serial=args.serial,
-        running_mins=args.running_minutes if args.running_minutes else 10,
-        maxStep=args.max_step if args.max_step else 500,
-        throttle=args.throttle_ms if args.throttle_ms else 200,
-        log_stamp=args.log_stamp
+        running_mins=args.running_minutes,
+        maxStep=args.max_step,
+        throttle=args.throttle_ms,
+        log_stamp=args.log_stamp,
+        profile_period=args.profile_period,
     )
 
     KeaTestRunner.setOptions(options)

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/kea2/u2Driver.py

@@ -235,7 +235,7 @@ class U2StaticDevice(u2.Device):
     
     def __getattr__(self, attr):
         """Proxy other methods to script_driver"""
-        # logger.debug(f"{attr} not exists in static checker, proxy to script_driver.")
+        logger.debug(f"{attr} not exists in static checker, proxy to script_driver.")
         return getattr(self._script_driver, attr)
 
 class _XPathEntry(u2.xpath.XPathEntry):

{kea2_python-0.0.1b1 → kea2_python-0.0.1b2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Kea2-python"
-version = "0.0.1b1"
+version = "0.0.1b2"
 description = "A python library for supporting and customizing automated UI testing for mobile apps"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -19,4 +19,4 @@ kea2 = "kea2.cli:main"
 include = ["kea2"]
 
 [tool.setuptools.package-data]
-kea2 = ["assets/**/*"]
+kea2 = ["assets/**/*"]