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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.0.1a4
+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
@@ -16,10 +16,10 @@ Kea2 is an easy-to-use Python library for supporting, customizing and improving
 
 ### Kea2 has three important features:
 - **Feature 1**(查找稳定性问题): coming with the full capability of [Fastbot](https://github.com/bytedance/Fastbot_Android) for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
-- **Feature 2**(自定义测试场景或事件序列[^1]): customizing testing scenarios when running Fastbot (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app states) with the full capability and flexibility powered by *python* language and [uiautomator2](https://github.com/openatx/uiautomator2);
+- **Feature 2**(自定义测试场景或事件序列[^1]): customizing testing scenarios when running Fastbot (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app states, blacklisting specific UI widgets) with the full capability and flexibility powered by *python* language and [uiautomator2](https://github.com/openatx/uiautomator2);
 - **Feature 3**(支持断言机制[^2]): supporting auto-assertions when running Fastbot, based on the idea of [property-based testing](https://en.wikipedia.org/wiki/Software_testing#Property_testing) inheritted from [Kea](https://github.com/ecnusse/Kea), for finding *logic bugs* (i.e., *non-crashing bugs*)
 
-These three features can be combined to customize and improve automated UI testing.
+These three features can be combined to support, customize and improve automated UI testing.
 
 <div align="center">
     <div style="max-width:80%; max-height:80%">
@@ -46,7 +46,7 @@ In the future, Kea2 will be extended to support
 - [Appium](https://github.com/appium/appium), [Hypium]() (for HarmonyOS)
 - other automated UI testing tools (not limited to Fastbot)
 
-> Kea2 is inspired by many valuable insights, advices and lessons shared by experienced industrial practitioners from Bytedance (Zhao Zhang, Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu), Huawei, Xiaomi and etc. Kudos!
+> Kea2 is inspired by many valuable insights, advices and lessons shared by experienced industrial practitioners from Bytedance (Zhao Zhang, Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
 ## Installation
 
@@ -56,24 +56,33 @@ Running requirements/environment:
 - Android SDK installed
 - **VPN closed** (Features 2 and 3 required)
 
+
+Install Kea2 by `pip`:
 ```bash
 python3 -m pip install Kea2-python
+```
 
+Find Kea2's additional options by running 
+```bash
 kea2 -h
 ```
 
-
 ## Quick Test
 
 Kea2 connects to and runs on Android devices. We recommend you to do a quick test to ensure that Kea2 is compatible with your devices.
 
 1. Connect to an Android device and make sure you can see the connected device by running `adb devices`. 
 
-2. Run `quickstart.py` to test a sample app `omninotes` (released as `omninotes.apk` in Kea2's repository). The script `quickstart.py` will automatically install and test this sample app for a short time.
+2. Run `quicktest.py` to test a sample app `omninotes` (released as `omninotes.apk` in Kea2's repository). The script `quicktest.py` will automatically install and test this sample app for a short time.
 
+Initialize Kea2 under your preferred working directory:
 ```python
 kea2 init
-python3 quickstart.py native
+```
+
+Run the quick test:
+```python
+python3 quicktest.py
 ```
 
 If you can see the app `omninotes` is successfully running and tested, Kea2 works. Otherwise, please help [file a bug report](https://github.com/ecnusse/Kea2/issues) with the error message to us. Thank you!
@@ -87,20 +96,23 @@ avdmanager create avd --force --name Android12 --package 'system-images;android-
 emulator -avd Android12 -port 5554 &
 ```
 
-> [quickstart.py](https://github.com/XixianLiang/KeaPlus/blob/main/quickstart.py) is a dead simple script which is ready-to-go with Fastbot. You can customize this script for testing your apps.
+> [quicktest.py](https://github.com/ecnusse/Kea2/blob/main/kea2/assets/quicktest.py) is a dead simple script which is ready-to-go with Fastbot. You can customize this script for testing your own apps.
 
 ## Feature 1(查找稳定性问题): running Fastbot
 
-Test your app with the full capability of [Fastbot](https://github.com/bytedance/Fastbot_Android) for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
+Test your app with the full capability of Fastbot for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
 
 
 ```bash
 kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent native --running-minutes 10 --throttle 200
 ```
 
-The usage is similar to the the original [Fastbot](https://github.com/bytedance/Fastbot_Android?tab=readme-ov-file#run-fastbot-with-shell-command)'s shell commands. 
-See more options by `kea2 run -h`
+The usage is similar to the the original Fastbot's [shell commands](https://github.com/bytedance/Fastbot_Android?tab=readme-ov-file#run-fastbot-with-shell-command). 
 
+See more options by 
+```bash
+kea2 run -h
+```
 
 ## Feature 2(自定义测试场景或事件序列): customizing testing scenarios by scripts
 
@@ -116,13 +128,13 @@ When running any automated UI testing tools like Fastbot to test your apps, you
     <img src="docs/stage2.png" style="border-radius: 14px; width: 80%; height: 80%;"/> 
 </div>
 
-Kea2 can support you to test your app by customizing testing scenarios (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app states) with the full capability and flexibility powered by `python` language and [uiautomator2](https://github.com/openatx/uiautomator2);
+Kea2 can support you to test your app by customizing testing scenarios (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app, blacklisting specific UI widgets) with the full capability and flexibility powered by `python` language and [uiautomator2](https://github.com/openatx/uiautomator2);
 
 In Kea2, a script is composed of two elements:
 -  **Precondition:** When to execute the script.
 - **Interaction scenario:** The interaction logic (specified in the script's test method) to reach where we want.
 
-### Example
+### Example 1: reaching specific UI pages
 
 Assuming `Privacy` is a hard-to-reach UI page during automated UI testing. Kea2 can easily guide Fastbot to reach this page.
 
@@ -147,17 +159,48 @@ In this case, the `Home` page is the entry page of the `Privacy` page and the `H
 - In script's test method `test_goToPrivacy`, we specify the interaction logic (i.e., opening `Drawer`, clicking the option `Setting` and clicking `Privacy`) to guide Fastbot to reach the `Privacy` page.
 - By the decorator `@prob`, we specify the probability (50% in this example) to do the guidance when we are at the `Home` page. As a result, Kea2 still allows Fastbot to explore other pages.
 
-You can find the full example in script `quickstart.py` and run it by executing:
+You can find the full example in script `quicktest.py`, and run this script with Fastbot by the command `kea2 run`:
 
-```python
-python3 quickstart.py u2
+```bash
+# Launch Kea2 and load one single script quicktest.py.
+kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quicktest.py
 ```
 
-In real use, you can use `kea2 run` to launch the customizing script.
+### Example 2: blacklisting specific UI widgets
 
-```bash
-# Launch Kea2 and load one single script quickstart.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quickstart.py
+We support blacklisting specific widgets so that Fastbot can avoid interacting with these widgets during fuzzing. We support (1) `Global Block List` (always taking effective), and (2) `Conditional Block List` (only taking effective when some conditions are met).
+
+The list of blocked widgets are specified in Kea2's config file `configs/widget.block.py` (generated when running `kea2 init`). 
+The widgets needed to be blocked can be flexibly specified by u2 selector (e.g., `text`, `description`) or `xpath`, etc.
+
+#### Global Block List
+We can define the function `global_block_widgets` to specify which UI widgets should be blocked globally. The blocking always takes effect. 
+
+```python
+# file: configs/widget.block.py
+
+    def global_block_widgets(d: "Device"):
+    """
+    global block list.
+    return the widgets which should be blocked globally
+    """
+    return [d(text="widgets to block"), 
+            d.xpath(".//node[@text='widget to block']"),
+            d(description="widgets to block")]
+```
+#### Conditional Block List
+We can define any reserved function whose name starts with "block_" and decorate such function by `@precondition` to allow conditional block list.
+In this case, the blocking only takes effect when the precondition is satisfied.
+```python
+# file: configs/widget.block.py
+
+# conditional block list
+@precondition(lambda d: d(text="In the home page").exists)
+def block_sth(d: "Device"):
+    # Important: the function name should start with "block_"
+    return [d(text="widgets to block"), 
+            d.xpath(".//node[@text='widget to block']"),
+            d(description="widgets to block")]
 ```
 
 ## Feature 3(支持断言机制): Supporting auto-assertions by scripts.
@@ -205,9 +248,16 @@ For the preceding always-holding property, we can write the following script to
 ```
 >  We use [hypothesis](https://github.com/HypothesisWorks/hypothesis), a property-based testing library for Python, to generate random texts according to the given rules.
 
+You can run this example by using the similar command line in Feature 2.
+
 # Documentation
 
-## Write scripts
+## Kea2's tutorials 
+
+1. A small tutorial of applying Kea2's Feature 2 and 3 on [WeChat](docs/Scenario_Examples_zh.md).
+
+
+## Kea2's scripts
 
 Kea2 uses [Unittest](https://docs.python.org/3/library/unittest.html) to manage scripts. All the Kea2's scripts can be found in unittest's rules (i.e., the test methods should start with `test_`, the test classes should extend `unittest.TestCase`).
 
@@ -246,8 +296,19 @@ 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.
 
-## Launch Kea2
+
+| | **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.
+
+
+## Launching Kea2
 
 We offer two ways to launch Kea2.
 
@@ -263,8 +324,8 @@ kea2 run <Kea2 cmds> unittest <unittest cmds>
 Sample shell commands:
 
 ```bash
-# Launch Kea2 and load one single script quickstart.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest quickstart.py
+# Launch Kea2 and load one single script quicktest.py.
+kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quicktest.py
 
 # Launch Kea2 and load multiple scripts from the directory mytests/omni_notes
 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
@@ -274,6 +335,7 @@ kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --runn
 | --- | --- |
 | -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`) | 
@@ -339,9 +401,10 @@ maxStep: int # default "inf"
 running_mins: int = 10
 # time(ms) to wait when exploring the app
 throttle: int = 200
+# the output_dir for saving logs and results
+output_dir: str = "output"
 ```
 
-
 ## Examining the running statistics of scripts .
 
 If you want to examine whether your scripts have been executed or how many times they have been executed during testing. Open the file `result.json` after the testing is finished.
@@ -369,13 +432,10 @@ executed | During UI testing, how many times the test method has been executed?
 fail | How many times did the test method fail the assertions during UI testing? | When failed, the test method found a likely functional bug. 
 error | How many times does the test method abort during UI tsting due to some unexpected errors (e.g. some UI widgets used in the test method cannot be found) | When some error happens, the script needs to be updated/fixed because the script leads to some unexpected errors.
 
-### Appendix: Install Kea2 in global environment
+## Configuration File
 
-```bash
-# In the working directory of Kea2
-python3 -m pip install --upgrade pip
-python3 -m pip install .
-```
+After executing `Kea2 init`, some configuration files will be generated in the `configs` directory. 
+These configuration files belong to `Fastbot`, and their specific introductions are provided in [Introduction to configuration files](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E4%B8%93%E5%AE%B6%E7%B3%BB%E7%BB%9F).
 
 ## Contributors/Maintainers
 

{kea2_python-0.0.1a4 → kea2_python-0.0.1a6}/Kea2_python.egg-info/SOURCES.txt

@@ -19,7 +19,7 @@ kea2/utils.py
 kea2/assets/fastbot-thirdpart.jar
 kea2/assets/framework.jar
 kea2/assets/monkeyq.jar
-kea2/assets/quickstart.py
+kea2/assets/quicktest.py
 kea2/assets/u2.jar
 kea2/assets/fastbot_configs/ADBKeyBoard.apk
 kea2/assets/fastbot_configs/abl.strings

{kea2_python-0.0.1a4 → kea2_python-0.0.1a6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.0.1a4
+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
@@ -16,10 +16,10 @@ Kea2 is an easy-to-use Python library for supporting, customizing and improving
 
 ### Kea2 has three important features:
 - **Feature 1**(查找稳定性问题): coming with the full capability of [Fastbot](https://github.com/bytedance/Fastbot_Android) for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
-- **Feature 2**(自定义测试场景或事件序列[^1]): customizing testing scenarios when running Fastbot (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app states) with the full capability and flexibility powered by *python* language and [uiautomator2](https://github.com/openatx/uiautomator2);
+- **Feature 2**(自定义测试场景或事件序列[^1]): customizing testing scenarios when running Fastbot (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app states, blacklisting specific UI widgets) with the full capability and flexibility powered by *python* language and [uiautomator2](https://github.com/openatx/uiautomator2);
 - **Feature 3**(支持断言机制[^2]): supporting auto-assertions when running Fastbot, based on the idea of [property-based testing](https://en.wikipedia.org/wiki/Software_testing#Property_testing) inheritted from [Kea](https://github.com/ecnusse/Kea), for finding *logic bugs* (i.e., *non-crashing bugs*)
 
-These three features can be combined to customize and improve automated UI testing.
+These three features can be combined to support, customize and improve automated UI testing.
 
 <div align="center">
     <div style="max-width:80%; max-height:80%">
@@ -46,7 +46,7 @@ In the future, Kea2 will be extended to support
 - [Appium](https://github.com/appium/appium), [Hypium]() (for HarmonyOS)
 - other automated UI testing tools (not limited to Fastbot)
 
-> Kea2 is inspired by many valuable insights, advices and lessons shared by experienced industrial practitioners from Bytedance (Zhao Zhang, Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu), Huawei, Xiaomi and etc. Kudos!
+> Kea2 is inspired by many valuable insights, advices and lessons shared by experienced industrial practitioners from Bytedance (Zhao Zhang, Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
 ## Installation
 
@@ -56,24 +56,33 @@ Running requirements/environment:
 - Android SDK installed
 - **VPN closed** (Features 2 and 3 required)
 
+
+Install Kea2 by `pip`:
 ```bash
 python3 -m pip install Kea2-python
+```
 
+Find Kea2's additional options by running 
+```bash
 kea2 -h
 ```
 
-
 ## Quick Test
 
 Kea2 connects to and runs on Android devices. We recommend you to do a quick test to ensure that Kea2 is compatible with your devices.
 
 1. Connect to an Android device and make sure you can see the connected device by running `adb devices`. 
 
-2. Run `quickstart.py` to test a sample app `omninotes` (released as `omninotes.apk` in Kea2's repository). The script `quickstart.py` will automatically install and test this sample app for a short time.
+2. Run `quicktest.py` to test a sample app `omninotes` (released as `omninotes.apk` in Kea2's repository). The script `quicktest.py` will automatically install and test this sample app for a short time.
 
+Initialize Kea2 under your preferred working directory:
 ```python
 kea2 init
-python3 quickstart.py native
+```
+
+Run the quick test:
+```python
+python3 quicktest.py
 ```
 
 If you can see the app `omninotes` is successfully running and tested, Kea2 works. Otherwise, please help [file a bug report](https://github.com/ecnusse/Kea2/issues) with the error message to us. Thank you!
@@ -87,20 +96,23 @@ avdmanager create avd --force --name Android12 --package 'system-images;android-
 emulator -avd Android12 -port 5554 &
 ```
 
-> [quickstart.py](https://github.com/XixianLiang/KeaPlus/blob/main/quickstart.py) is a dead simple script which is ready-to-go with Fastbot. You can customize this script for testing your apps.
+> [quicktest.py](https://github.com/ecnusse/Kea2/blob/main/kea2/assets/quicktest.py) is a dead simple script which is ready-to-go with Fastbot. You can customize this script for testing your own apps.
 
 ## Feature 1(查找稳定性问题): running Fastbot
 
-Test your app with the full capability of [Fastbot](https://github.com/bytedance/Fastbot_Android) for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
+Test your app with the full capability of Fastbot for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
 
 
 ```bash
 kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent native --running-minutes 10 --throttle 200
 ```
 
-The usage is similar to the the original [Fastbot](https://github.com/bytedance/Fastbot_Android?tab=readme-ov-file#run-fastbot-with-shell-command)'s shell commands. 
-See more options by `kea2 run -h`
+The usage is similar to the the original Fastbot's [shell commands](https://github.com/bytedance/Fastbot_Android?tab=readme-ov-file#run-fastbot-with-shell-command). 
 
+See more options by 
+```bash
+kea2 run -h
+```
 
 ## Feature 2(自定义测试场景或事件序列): customizing testing scenarios by scripts
 
@@ -116,13 +128,13 @@ When running any automated UI testing tools like Fastbot to test your apps, you
     <img src="docs/stage2.png" style="border-radius: 14px; width: 80%; height: 80%;"/> 
 </div>
 
-Kea2 can support you to test your app by customizing testing scenarios (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app states) with the full capability and flexibility powered by `python` language and [uiautomator2](https://github.com/openatx/uiautomator2);
+Kea2 can support you to test your app by customizing testing scenarios (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app, blacklisting specific UI widgets) with the full capability and flexibility powered by `python` language and [uiautomator2](https://github.com/openatx/uiautomator2);
 
 In Kea2, a script is composed of two elements:
 -  **Precondition:** When to execute the script.
 - **Interaction scenario:** The interaction logic (specified in the script's test method) to reach where we want.
 
-### Example
+### Example 1: reaching specific UI pages
 
 Assuming `Privacy` is a hard-to-reach UI page during automated UI testing. Kea2 can easily guide Fastbot to reach this page.
 
@@ -147,17 +159,48 @@ In this case, the `Home` page is the entry page of the `Privacy` page and the `H
 - In script's test method `test_goToPrivacy`, we specify the interaction logic (i.e., opening `Drawer`, clicking the option `Setting` and clicking `Privacy`) to guide Fastbot to reach the `Privacy` page.
 - By the decorator `@prob`, we specify the probability (50% in this example) to do the guidance when we are at the `Home` page. As a result, Kea2 still allows Fastbot to explore other pages.
 
-You can find the full example in script `quickstart.py` and run it by executing:
+You can find the full example in script `quicktest.py`, and run this script with Fastbot by the command `kea2 run`:
 
-```python
-python3 quickstart.py u2
+```bash
+# Launch Kea2 and load one single script quicktest.py.
+kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quicktest.py
 ```
 
-In real use, you can use `kea2 run` to launch the customizing script.
+### Example 2: blacklisting specific UI widgets
 
-```bash
-# Launch Kea2 and load one single script quickstart.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quickstart.py
+We support blacklisting specific widgets so that Fastbot can avoid interacting with these widgets during fuzzing. We support (1) `Global Block List` (always taking effective), and (2) `Conditional Block List` (only taking effective when some conditions are met).
+
+The list of blocked widgets are specified in Kea2's config file `configs/widget.block.py` (generated when running `kea2 init`). 
+The widgets needed to be blocked can be flexibly specified by u2 selector (e.g., `text`, `description`) or `xpath`, etc.
+
+#### Global Block List
+We can define the function `global_block_widgets` to specify which UI widgets should be blocked globally. The blocking always takes effect. 
+
+```python
+# file: configs/widget.block.py
+
+    def global_block_widgets(d: "Device"):
+    """
+    global block list.
+    return the widgets which should be blocked globally
+    """
+    return [d(text="widgets to block"), 
+            d.xpath(".//node[@text='widget to block']"),
+            d(description="widgets to block")]
+```
+#### Conditional Block List
+We can define any reserved function whose name starts with "block_" and decorate such function by `@precondition` to allow conditional block list.
+In this case, the blocking only takes effect when the precondition is satisfied.
+```python
+# file: configs/widget.block.py
+
+# conditional block list
+@precondition(lambda d: d(text="In the home page").exists)
+def block_sth(d: "Device"):
+    # Important: the function name should start with "block_"
+    return [d(text="widgets to block"), 
+            d.xpath(".//node[@text='widget to block']"),
+            d(description="widgets to block")]
 ```
 
 ## Feature 3(支持断言机制): Supporting auto-assertions by scripts.
@@ -205,9 +248,16 @@ For the preceding always-holding property, we can write the following script to
 ```
 >  We use [hypothesis](https://github.com/HypothesisWorks/hypothesis), a property-based testing library for Python, to generate random texts according to the given rules.
 
+You can run this example by using the similar command line in Feature 2.
+
 # Documentation
 
-## Write scripts
+## Kea2's tutorials 
+
+1. A small tutorial of applying Kea2's Feature 2 and 3 on [WeChat](docs/Scenario_Examples_zh.md).
+
+
+## Kea2's scripts
 
 Kea2 uses [Unittest](https://docs.python.org/3/library/unittest.html) to manage scripts. All the Kea2's scripts can be found in unittest's rules (i.e., the test methods should start with `test_`, the test classes should extend `unittest.TestCase`).
 
@@ -246,8 +296,19 @@ 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.
 
-## Launch Kea2
+
+| | **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.
+
+
+## Launching Kea2
 
 We offer two ways to launch Kea2.
 
@@ -263,8 +324,8 @@ kea2 run <Kea2 cmds> unittest <unittest cmds>
 Sample shell commands:
 
 ```bash
-# Launch Kea2 and load one single script quickstart.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest quickstart.py
+# Launch Kea2 and load one single script quicktest.py.
+kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quicktest.py
 
 # Launch Kea2 and load multiple scripts from the directory mytests/omni_notes
 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
@@ -274,6 +335,7 @@ kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --runn
 | --- | --- |
 | -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`) | 
@@ -339,9 +401,10 @@ maxStep: int # default "inf"
 running_mins: int = 10
 # time(ms) to wait when exploring the app
 throttle: int = 200
+# the output_dir for saving logs and results
+output_dir: str = "output"
 ```
 
-
 ## Examining the running statistics of scripts .
 
 If you want to examine whether your scripts have been executed or how many times they have been executed during testing. Open the file `result.json` after the testing is finished.
@@ -369,13 +432,10 @@ executed | During UI testing, how many times the test method has been executed?
 fail | How many times did the test method fail the assertions during UI testing? | When failed, the test method found a likely functional bug. 
 error | How many times does the test method abort during UI tsting due to some unexpected errors (e.g. some UI widgets used in the test method cannot be found) | When some error happens, the script needs to be updated/fixed because the script leads to some unexpected errors.
 
-### Appendix: Install Kea2 in global environment
+## Configuration File
 
-```bash
-# In the working directory of Kea2
-python3 -m pip install --upgrade pip
-python3 -m pip install .
-```
+After executing `Kea2 init`, some configuration files will be generated in the `configs` directory. 
+These configuration files belong to `Fastbot`, and their specific introductions are provided in [Introduction to configuration files](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E4%B8%93%E5%AE%B6%E7%B3%BB%E7%BB%9F).
 
 ## Contributors/Maintainers
 

{kea2_python-0.0.1a4 → kea2_python-0.0.1a6}/README.md

@@ -4,10 +4,10 @@ Kea2 is an easy-to-use Python library for supporting, customizing and improving
 
 ### Kea2 has three important features:
 - **Feature 1**(查找稳定性问题): coming with the full capability of [Fastbot](https://github.com/bytedance/Fastbot_Android) for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
-- **Feature 2**(自定义测试场景或事件序列[^1]): customizing testing scenarios when running Fastbot (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app states) with the full capability and flexibility powered by *python* language and [uiautomator2](https://github.com/openatx/uiautomator2);
+- **Feature 2**(自定义测试场景或事件序列[^1]): customizing testing scenarios when running Fastbot (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app states, blacklisting specific UI widgets) with the full capability and flexibility powered by *python* language and [uiautomator2](https://github.com/openatx/uiautomator2);
 - **Feature 3**(支持断言机制[^2]): supporting auto-assertions when running Fastbot, based on the idea of [property-based testing](https://en.wikipedia.org/wiki/Software_testing#Property_testing) inheritted from [Kea](https://github.com/ecnusse/Kea), for finding *logic bugs* (i.e., *non-crashing bugs*)
 
-These three features can be combined to customize and improve automated UI testing.
+These three features can be combined to support, customize and improve automated UI testing.
 
 <div align="center">
     <div style="max-width:80%; max-height:80%">
@@ -34,7 +34,7 @@ In the future, Kea2 will be extended to support
 - [Appium](https://github.com/appium/appium), [Hypium]() (for HarmonyOS)
 - other automated UI testing tools (not limited to Fastbot)
 
-> Kea2 is inspired by many valuable insights, advices and lessons shared by experienced industrial practitioners from Bytedance (Zhao Zhang, Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu), Huawei, Xiaomi and etc. Kudos!
+> Kea2 is inspired by many valuable insights, advices and lessons shared by experienced industrial practitioners from Bytedance (Zhao Zhang, Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
 ## Installation
 
@@ -44,24 +44,33 @@ Running requirements/environment:
 - Android SDK installed
 - **VPN closed** (Features 2 and 3 required)
 
+
+Install Kea2 by `pip`:
 ```bash
 python3 -m pip install Kea2-python
+```
 
+Find Kea2's additional options by running 
+```bash
 kea2 -h
 ```
 
-
 ## Quick Test
 
 Kea2 connects to and runs on Android devices. We recommend you to do a quick test to ensure that Kea2 is compatible with your devices.
 
 1. Connect to an Android device and make sure you can see the connected device by running `adb devices`. 
 
-2. Run `quickstart.py` to test a sample app `omninotes` (released as `omninotes.apk` in Kea2's repository). The script `quickstart.py` will automatically install and test this sample app for a short time.
+2. Run `quicktest.py` to test a sample app `omninotes` (released as `omninotes.apk` in Kea2's repository). The script `quicktest.py` will automatically install and test this sample app for a short time.
 
+Initialize Kea2 under your preferred working directory:
 ```python
 kea2 init
-python3 quickstart.py native
+```
+
+Run the quick test:
+```python
+python3 quicktest.py
 ```
 
 If you can see the app `omninotes` is successfully running and tested, Kea2 works. Otherwise, please help [file a bug report](https://github.com/ecnusse/Kea2/issues) with the error message to us. Thank you!
@@ -75,20 +84,23 @@ avdmanager create avd --force --name Android12 --package 'system-images;android-
 emulator -avd Android12 -port 5554 &
 ```
 
-> [quickstart.py](https://github.com/XixianLiang/KeaPlus/blob/main/quickstart.py) is a dead simple script which is ready-to-go with Fastbot. You can customize this script for testing your apps.
+> [quicktest.py](https://github.com/ecnusse/Kea2/blob/main/kea2/assets/quicktest.py) is a dead simple script which is ready-to-go with Fastbot. You can customize this script for testing your own apps.
 
 ## Feature 1(查找稳定性问题): running Fastbot
 
-Test your app with the full capability of [Fastbot](https://github.com/bytedance/Fastbot_Android) for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
+Test your app with the full capability of Fastbot for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
 
 
 ```bash
 kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent native --running-minutes 10 --throttle 200
 ```
 
-The usage is similar to the the original [Fastbot](https://github.com/bytedance/Fastbot_Android?tab=readme-ov-file#run-fastbot-with-shell-command)'s shell commands. 
-See more options by `kea2 run -h`
+The usage is similar to the the original Fastbot's [shell commands](https://github.com/bytedance/Fastbot_Android?tab=readme-ov-file#run-fastbot-with-shell-command). 
 
+See more options by 
+```bash
+kea2 run -h
+```
 
 ## Feature 2(自定义测试场景或事件序列): customizing testing scenarios by scripts
 
@@ -104,13 +116,13 @@ When running any automated UI testing tools like Fastbot to test your apps, you
     <img src="docs/stage2.png" style="border-radius: 14px; width: 80%; height: 80%;"/> 
 </div>
 
-Kea2 can support you to test your app by customizing testing scenarios (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app states) with the full capability and flexibility powered by `python` language and [uiautomator2](https://github.com/openatx/uiautomator2);
+Kea2 can support you to test your app by customizing testing scenarios (e.g., testing specific app functionalities, executing specific event traces, entering specifc UI pages, reaching specific app, blacklisting specific UI widgets) with the full capability and flexibility powered by `python` language and [uiautomator2](https://github.com/openatx/uiautomator2);
 
 In Kea2, a script is composed of two elements:
 -  **Precondition:** When to execute the script.
 - **Interaction scenario:** The interaction logic (specified in the script's test method) to reach where we want.
 
-### Example
+### Example 1: reaching specific UI pages
 
 Assuming `Privacy` is a hard-to-reach UI page during automated UI testing. Kea2 can easily guide Fastbot to reach this page.
 
@@ -135,17 +147,48 @@ In this case, the `Home` page is the entry page of the `Privacy` page and the `H
 - In script's test method `test_goToPrivacy`, we specify the interaction logic (i.e., opening `Drawer`, clicking the option `Setting` and clicking `Privacy`) to guide Fastbot to reach the `Privacy` page.
 - By the decorator `@prob`, we specify the probability (50% in this example) to do the guidance when we are at the `Home` page. As a result, Kea2 still allows Fastbot to explore other pages.
 
-You can find the full example in script `quickstart.py` and run it by executing:
+You can find the full example in script `quicktest.py`, and run this script with Fastbot by the command `kea2 run`:
 
-```python
-python3 quickstart.py u2
+```bash
+# Launch Kea2 and load one single script quicktest.py.
+kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quicktest.py
 ```
 
-In real use, you can use `kea2 run` to launch the customizing script.
+### Example 2: blacklisting specific UI widgets
 
-```bash
-# Launch Kea2 and load one single script quickstart.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quickstart.py
+We support blacklisting specific widgets so that Fastbot can avoid interacting with these widgets during fuzzing. We support (1) `Global Block List` (always taking effective), and (2) `Conditional Block List` (only taking effective when some conditions are met).
+
+The list of blocked widgets are specified in Kea2's config file `configs/widget.block.py` (generated when running `kea2 init`). 
+The widgets needed to be blocked can be flexibly specified by u2 selector (e.g., `text`, `description`) or `xpath`, etc.
+
+#### Global Block List
+We can define the function `global_block_widgets` to specify which UI widgets should be blocked globally. The blocking always takes effect. 
+
+```python
+# file: configs/widget.block.py
+
+    def global_block_widgets(d: "Device"):
+    """
+    global block list.
+    return the widgets which should be blocked globally
+    """
+    return [d(text="widgets to block"), 
+            d.xpath(".//node[@text='widget to block']"),
+            d(description="widgets to block")]
+```
+#### Conditional Block List
+We can define any reserved function whose name starts with "block_" and decorate such function by `@precondition` to allow conditional block list.
+In this case, the blocking only takes effect when the precondition is satisfied.
+```python
+# file: configs/widget.block.py
+
+# conditional block list
+@precondition(lambda d: d(text="In the home page").exists)
+def block_sth(d: "Device"):
+    # Important: the function name should start with "block_"
+    return [d(text="widgets to block"), 
+            d.xpath(".//node[@text='widget to block']"),
+            d(description="widgets to block")]
 ```
 
 ## Feature 3(支持断言机制): Supporting auto-assertions by scripts.
@@ -193,9 +236,16 @@ For the preceding always-holding property, we can write the following script to
 ```
 >  We use [hypothesis](https://github.com/HypothesisWorks/hypothesis), a property-based testing library for Python, to generate random texts according to the given rules.
 
+You can run this example by using the similar command line in Feature 2.
+
 # Documentation
 
-## Write scripts
+## Kea2's tutorials 
+
+1. A small tutorial of applying Kea2's Feature 2 and 3 on [WeChat](docs/Scenario_Examples_zh.md).
+
+
+## Kea2's scripts
 
 Kea2 uses [Unittest](https://docs.python.org/3/library/unittest.html) to manage scripts. All the Kea2's scripts can be found in unittest's rules (i.e., the test methods should start with `test_`, the test classes should extend `unittest.TestCase`).
 
@@ -234,8 +284,19 @@ 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.
 
-## Launch Kea2
+
+| | **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.
+
+
+## Launching Kea2
 
 We offer two ways to launch Kea2.
 
@@ -251,8 +312,8 @@ kea2 run <Kea2 cmds> unittest <unittest cmds>
 Sample shell commands:
 
 ```bash
-# Launch Kea2 and load one single script quickstart.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest quickstart.py
+# Launch Kea2 and load one single script quicktest.py.
+kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quicktest.py
 
 # Launch Kea2 and load multiple scripts from the directory mytests/omni_notes
 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
@@ -262,6 +323,7 @@ kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --runn
 | --- | --- |
 | -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`) | 
@@ -327,9 +389,10 @@ maxStep: int # default "inf"
 running_mins: int = 10
 # time(ms) to wait when exploring the app
 throttle: int = 200
+# the output_dir for saving logs and results
+output_dir: str = "output"
 ```
 
-
 ## Examining the running statistics of scripts .
 
 If you want to examine whether your scripts have been executed or how many times they have been executed during testing. Open the file `result.json` after the testing is finished.
@@ -357,13 +420,10 @@ executed | During UI testing, how many times the test method has been executed?
 fail | How many times did the test method fail the assertions during UI testing? | When failed, the test method found a likely functional bug. 
 error | How many times does the test method abort during UI tsting due to some unexpected errors (e.g. some UI widgets used in the test method cannot be found) | When some error happens, the script needs to be updated/fixed because the script leads to some unexpected errors.
 
-### Appendix: Install Kea2 in global environment
+## Configuration File
 
-```bash
-# In the working directory of Kea2
-python3 -m pip install --upgrade pip
-python3 -m pip install .
-```
+After executing `Kea2 init`, some configuration files will be generated in the `configs` directory. 
+These configuration files belong to `Fastbot`, and their specific introductions are provided in [Introduction to configuration files](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E4%B8%93%E5%AE%B6%E7%B3%BB%E7%BB%9F).
 
 ## Contributors/Maintainers
 

{kea2_python-0.0.1a4 → kea2_python-0.0.1a6}/kea2/assets/fastbot_configs/widget.block.py

@@ -14,5 +14,5 @@ def global_block_widgets(d: "Device"):
 # conditional block list
 @precondition(lambda d: d(text="In the home page").exists)
 def block_sth(d: "Device"):
-    # Important: function shold starts with "block"
+    # Important: function shold starts with "block_"
     return [d(text="widgets to block"), d.xpath(".//node[@text='widget to block']")]

kea2_python-0.0.1a4/kea2/assets/quickstart.py → kea2_python-0.0.1a6/kea2/assets/quicktest.py

@@ -73,17 +73,7 @@ def check_installation():
     d.stop_uiautomator()
 
 
-def _get_agent():
-    import sys
-    if len(sys.argv) == 0 or sys.argv[1] == "u2":
-        sys.argv=sys.argv[:1]
-        return "u2"
-    sys.argv=sys.argv[:1]
-    return "native"
-
 if __name__ == "__main__":
-    
-    AGENT=_get_agent()
     check_installation()
     KeaTestRunner.setOptions(
         Options(
@@ -94,7 +84,7 @@ if __name__ == "__main__":
             maxStep=5000,
             # running_mins=10,  # specify the maximal running time in minutes, default value is 10m
             # throttle=200,   # specify the throttle in milliseconds, default value is 200ms
-            agent=AGENT  # 'native' for running the vanilla Fastbot, 'u2' for running Kea2
+            agent="u2"  # 'native' for running the vanilla Fastbot, 'u2' for running Kea2
         )
     )
     unittest.main(testRunner=KeaTestRunner)

{kea2_python-0.0.1a4 → kea2_python-0.0.1a6}/kea2/cli.py

@@ -13,6 +13,12 @@ from pathlib import Path
 
 logger = getLogger(__name__)
 
+
+def cmd_version(args):
+    from importlib.metadata import version
+    print(version("Kea2-python"), flush=True)
+
+
 def cmd_init(args):
     cwd = Path(os.getcwd())
     configs_dir = cwd / "configs"
@@ -27,8 +33,8 @@ def cmd_init(args):
         shutil.copytree(src, dst)
 
     def copy_samples():
-        src = Path(__file__).parent / "assets" / "quickstart.py"
-        dst = cwd / "quickstart.py"
+        src = Path(__file__).parent / "assets" / "quicktest.py"
+        dst = cwd / "quicktest.py"
         shutil.copyfile(src, dst)
 
     copy_configs()
@@ -39,6 +45,7 @@ def cmd_init(args):
 def cmd_load_configs(args):
     pass
 
+
 def cmd_run(args):
     base_dir = getProjectRoot()
     if base_dir is None:
@@ -47,83 +54,13 @@ def cmd_run(args):
     run(args)
 
 
-def cmd_install(args):
-    pass
-
-
-def cmd_uninstall(args):
-    pass
-
-
-def cmd_start(args):
-    pass
-
-
-def cmd_stop(args):
-    pass
-
-
-def cmd_current(args):
-    pass
-
-
-def cmd_doctor(args):
-    pass
-
-
-# def cmd_version(args):
-#     print(__version__)
-
-
 _commands = [
-    # dict(action=cmd_version, command="version", help="show version"),
+    dict(action=cmd_version, command="version", help="show version"),
     dict(
         action=cmd_init,
         command="init",
         help="init the Kea2 project in current directory",
-    ),
-    # dict(
-    #     action=cmd_run,
-    #     command="run",
-    #     help="run kea2",
-    #     flags=[
-    #         dict(args=["args"], nargs=argparse.REMAINDER),
-    #     ],
-    # ),
-    # dict(
-    #     action=cmd_install,
-    #     command="",
-    #     help="install packages",
-    #     flags=[
-    #         dict(args=["url"], help="package url"),
-    #     ],
-    # ),
-    # dict(
-    #     action=cmd_uninstall,
-    #     command="uninstall",
-    #     help="uninstall packages",
-    #     flags=[
-    #         dict(args=["--all"], action="store_true", help="uninstall all packages"),
-    #         dict(args=["package_name"], nargs="*", help="package name"),
-    #     ],
-    # ),
-    # dict(
-    #     action=cmd_start,
-    #     command="start",
-    #     help="start application",
-    #     flags=[dict(args=["package_name"], type=str, nargs=None, help="package name")],
-    # ),
-    # dict(
-    #     action=cmd_stop,
-    #     command="stop",
-    #     help="stop application",
-    #     flags=[
-    #         dict(args=["--all"], action="store_true", help="stop all"),
-    #         dict(args=["package_name"], nargs="*", help="package name"),
-    #     ],
-    # ),
-    # dict(action=cmd_current, command="current", help="show current application"),
-    # dict(action=cmd_doctor, command="doctor", help="detect connect problem"),
+    )
 ]
 
 
@@ -132,9 +69,7 @@ def main():
         formatter_class=argparse.ArgumentDefaultsHelpFormatter
     )
     parser.add_argument("-d", "--debug", action="store_true",
-                        help="show log")
-    parser.add_argument('-s', '--serial', type=str,
-                        help='device serial number')
+                        help="show detail log")
 
     subparser = parser.add_subparsers(dest='subparser')
 

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

@@ -4,7 +4,7 @@ from pathlib import Path
 import subprocess
 import threading
 import traceback
-from typing import IO, Callable, Any, Dict, List, Literal, NewType, Optional, Union
+from typing import IO, Callable, Any, Dict, List, Literal, NewType, Union
 from unittest import TextTestRunner, registerResult, TestSuite, TestCase, TextTestResult
 import random
 import warnings
@@ -223,6 +223,7 @@ def startFastbotService(options: Options) -> threading.Thread:
         "reuseq",
         "--running-minutes", f"{options.running_mins}",
         "--throttle", f"{options.throttle}",
+        "--bugreport", "--output-directory", "/sdcard/fastbot_report"
         "-v", "-v", "-v"
     ]
 
@@ -265,7 +266,7 @@ class KeaTestRunner(TextTestRunner):
 
     def _setOuputDir(self):
         output_dir = Path(self.options.output_dir).absolute()
-        os.mkdir(output_dir, parents=True, exist_ok=True)
+        output_dir.mkdir(parents=True, exist_ok=True)
         global LOGFILE, RESFILE
         LOGFILE = output_dir / Path(LOGFILE)
         RESFILE = output_dir / Path(RESFILE)

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

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