Kea2-python 1.0.1__tar.gz → 1.0.3__tar.gz

{kea2_python-1.0.1 → kea2_python-1.0.3}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 1.0.1
+Version: 1.0.3
 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
@@ -24,7 +24,7 @@ Dynamic: license-file
     <img src="https://github.com/user-attachments/assets/84e47b87-2dd2-4d7e-91d1-e8c1d1db0cf4" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
-The group has reached its capacity. Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn) with your Wechat ID / QR code to be invited to the WeChat group.
+Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn) with your Wechat ID / QR code to be invited to the WeChat discussion group. Of course, we are also ready on GitHub to answer your questions/feedback.
 
 ### Github repo link
 [https://github.com/ecnusse/Kea2](https://github.com/ecnusse/Kea2)
@@ -43,7 +43,7 @@ The group has reached its capacity. Please contact Xixian Liang at [xixian@stu.e
 
 Kea2 is an easy-to-use tool for fuzzing mobile apps. Its key *novelty* is able to fuse automated UI testing with scripts (usually written by human), thus empowering automated UI testing with human intelligence for effectively finding *crashing bugs* as well as *non-crashing functional (logic) bugs*. 
 
-Kea2 is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android), *an industrial-strength automated UI testing tool*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*.
+Kea2 is currently built on top of [Fastbot](https://github.com/ecnusse/Fastbot_Android) 3.0 (a modified/enhanced version of the original [FastBot](https://github.com/bytedance/Fastbot_Android) 2.0), *an industrial-strength automated UI testing tool from ByteDance*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*. 
 Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps. 
 
 ## Novelty & Important features
@@ -76,11 +76,11 @@ Kea2 (and its idea) has been used/integrated by
 
 - [OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app. OPay uses Kea2 for regression testing on POS machines and mobile devices.
 
-- [WeChat's iExplorer]() --- WeChat's in-house testing platform
+- [WeChat's iExplorer]() --- WeChat's in-house testing platform (coming with an interactive UI-based tool to ease writing scripts)
 
-- [WeChat Payment's UAT]() --- WeChat Payment's in-house testing platform
+- [WeChat Payment's UAT]() --- WeChat Payment's in-house testing platform (fully automated property-based testing by synthesizing properties from the system specifications)
 
-- [DevEco Testing](https://developer.huawei.com/consumer/cn/deveco-testing/) --- Huawei's Official Testing Platform for HarmonyOS 
+- [DevEco Testing](https://developer.huawei.com/consumer/cn/deveco-testing/) --- Huawei's Official Testing Platform for HarmonyOS (Kea2 is built upon Hypium)
 
 - [ByteDance's Fastbot](https://github.com/bytedance/Fastbot_Android)
 
@@ -90,7 +90,7 @@ Please let us know and willing to hear your feedback/questions if you are also u
 Kea2 currently works with:
 - [unittest](https://docs.python.org/3/library/unittest.html) as the testing framework to manage the scripts;
 - [uiautomator2](https://github.com/openatx/uiautomator2) as the UI test driver; 
-- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool.
+- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool. 
 
 In the future, Kea2 will be extended to support
 - [pytest](https://docs.pytest.org/en/stable/), another popular python testing framework;
@@ -121,34 +121,34 @@ python3 -m pip install -U kea2-python
 ```
 > If you're using mirror sites like Tsinghua or USTC, you may fail to upgrade. Because these sites may not have the latest version yet. In this case, you can try to install Kea2 by specifying the latest version manually, or use `pypi.org` directly by `pip install kea2-python -i https://pypi.org/simple`.
 
-Upgrade Kea2 to the specifc latest version (e.g., 0.3.6) if you already installed Kea2 before:
+Upgrade Kea2 to the specifc latest version (e.g., 1.0.0) if you already installed Kea2 before:
 ```bash
-python3 -m pip install -U kea2-python==0.3.6
+python3 -m pip install -U kea2-python==1.0.0
 ```
 
+Initialize Kea2 under your preferred working directory:
+```python
+kea2 init
+```
 
+> This initialization step is always needed if it is your first time to run Kea2. If you have upgraded Kea2, you are also recommended to rerun this step to ensure any potential new configurations of Kea2 would take effect.
 
 
 ## 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 a real Android device or an Android emulator (only one device is enough) and make sure you can see the connected device by running `adb devices`. 
+1. Connect to a real Android device or an Android emulator and make sure you can see the connected device by running `adb devices`. 
 
 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
-```
-
-> This step is always needed if it is your first time to run Kea2.
-
 Run the quick test:
-```python
+```bash
 python3 quicktest.py
 ```
 
+> This quick test would automatically download `omninotes.apk`. If the download fails, please copy `omninotes.apk` from Kea2's repository (top-level) to your working directory and execute the quick test command again.
+
 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!
 
@@ -162,7 +162,7 @@ Test your app with the full capability of Fastbot for stress testing and finding
 kea2 run -p it.feio.android.omninotes.alpha --running-minutes 10 --throttle 200
 ```
 
-To understand the meanings of the options, you can see our [manual](docs/manual_en.md#launching-kea2).
+To understand the meanings of the options, you can see our [user manual](docs/manual_en.md#launching-kea2).
 
 > 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). 
 
@@ -242,13 +242,19 @@ For the preceding always-holding property, we can write the following script to
         lambda self: self.d(description="input_box").exists
     )
     def test_input_box(self):
+
+        # genenerate a random non-empty string (this is also property-based testing by feeding random text inputs!)
         from hypothesis.strategies import text, ascii_letters
         random_str = text(alphabet=ascii_letters).example()
+
+        # input this non-empty string into the input box 
         self.d(description="input_box").set_text(random_str)
+
+        # check whether the send button exists
         assert self.d(description="send_button").exist
 
         # we can even do more assertions, e.g.,
-        #       the input string should exist on the message sending page
+        #       the input string should successfully appear on the message sending page
         assert self.d(text=random_str).exist
 ```
 >  We use [hypothesis](https://github.com/HypothesisWorks/hypothesis) to generate random texts.
@@ -283,13 +289,14 @@ kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --th
 
 ## Test Reports（测试报告）
 
-Kea2 automatically generates comprehensive HTML test reports after each testing session.(The location is in the output/ directory)
+Kea2 automatically generates a HTML test report after each testing session. You can find the report in `output/` under your working directory.
 
-If automatic generation fails, you can also manually generate the test report using the command "kea2 report -p 'the path to the folder containing the test data'"
+You can also manually generate the test report by `kea2 report` (see `kea2 report -h` for details).
 
-The reports support both single test runs and merged analysis of multiple test sessions, making it easy to track testing progress and identify issues.
+You can also merge the test report from multiple testing sessions by `kea2 merge` (see `kea2 merge -h` for details).
+The merged test report is quite useful if you would test your apps for multiple sessions.
 
-- [View detailed test report documentation](docs/test_report_introduction.md)
+You can find a sample [test report](https://ecnusse.github.io/Kea2_sample_report/) from Opay (Thank you!). You can find more details on the test report in [this documentation](docs/test_report_introduction.md).
 
 ## Documentations（更多文档）
 
@@ -305,7 +312,8 @@ You can find the [user manual](docs/manual_en.md), which includes:
 ### Other resources about Kea2 (in Chinese)
 - [Q&A for Kea2 and PBT (对Kea2和PBT技术的常见问题和回答)](https://sy8pzmhmun.feishu.cn/wiki/SLGwwqgzIiEuC3kwmV8cSZY0nTg?from=from_copylink) 
 - [Kea2 101 (Kea2 从0到1 的入门教程与最佳实践，建议新手阅读)](https://sy8pzmhmun.feishu.cn/wiki/EwaWwPCitiUJoBkIgALcHtglnDK?from=from_copylink)
-- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/?vd_source=ab7968b8d764666d85d24af49d9b8891)
+- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/)
+- [Kea2 工具快速介绍 (2025.11, bilibili 录播)](https://www.bilibili.com/video/BV1WAyUBDEMw/)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -343,7 +351,7 @@ kea2的核心作用：
 
     提供了条件触发器。 在FB跑路的时候，会不停遍历条件触发器，一旦触发，挂起FB，开始执行触发器指定的 ui test 及 assert。执行完毕，继续切回FB跑路。
 
-hea2做了什么：
+kea2做了什么：
 
     替换了FB的条件触发功能。
     替换了FB的黑名单，黑控件功能。
@@ -371,7 +379,7 @@ hea2做了什么：
 
 > Guided, Stochastic Model-Based GUI Testing of Android Apps. ESEC/FSE 2017.  [pdf](https://dl.acm.org/doi/10.1145/3106237.3106298)
 
-### Maintainers/Contributors
+## Maintainers/Contributors
 
 Kea2 has been actively developed and maintained by the people in [ecnusse](https://github.com/ecnusse):
 
@@ -389,7 +397,13 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 
 Kea2 has also received many valuable insights, advices, feedbacks and lessons shared by several industrial people from Bytedance ([Zhao Zhang](https://github.com/zhangzhao4444), Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
-### Star History
+### Become a Contributor!
+
+Kea2 is an open-source project and we are calling for more contributors to join us!
+
+See [Developer guide](DEVELOP.md) for more details.
+
+## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=ecnusse/Kea2&type=Date)](https://www.star-history.com/#ecnusse/Kea2&Date)
 

{kea2_python-1.0.1 → kea2_python-1.0.3}/Kea2_python.egg-info/SOURCES.txt

@@ -10,14 +10,12 @@ Kea2_python.egg-info/top_level.txt
 kea2/__init__.py
 kea2/absDriver.py
 kea2/adbUtils.py
-kea2/bug_report_generator.py
 kea2/cli.py
 kea2/fastbotManager.py
 kea2/keaUtils.py
 kea2/kea_launcher.py
 kea2/logWatcher.py
 kea2/mixin.py
-kea2/report_merger.py
 kea2/resultSyncer.py
 kea2/u2Driver.py
 kea2/utils.py
@@ -41,6 +39,11 @@ kea2/assets/fastbot_libs/arm64-v8a/libfastbot_native.so
 kea2/assets/fastbot_libs/armeabi-v7a/libfastbot_native.so
 kea2/assets/fastbot_libs/x86/libfastbot_native.so
 kea2/assets/fastbot_libs/x86_64/libfastbot_native.so
-kea2/templates/bug_report_template.html
-kea2/templates/merged_bug_report_template.html
+kea2/report/__init__.py
+kea2/report/bug_report_generator.py
+kea2/report/mixin.py
+kea2/report/report_merger.py
+kea2/report/utils.py
+kea2/report/templates/bug_report_template.html
+kea2/report/templates/merged_bug_report_template.html
 tests/test_u2Selector.py

{kea2_python-1.0.1 → kea2_python-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 1.0.1
+Version: 1.0.3
 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
@@ -24,7 +24,7 @@ Dynamic: license-file
     <img src="https://github.com/user-attachments/assets/84e47b87-2dd2-4d7e-91d1-e8c1d1db0cf4" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
-The group has reached its capacity. Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn) with your Wechat ID / QR code to be invited to the WeChat group.
+Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn) with your Wechat ID / QR code to be invited to the WeChat discussion group. Of course, we are also ready on GitHub to answer your questions/feedback.
 
 ### Github repo link
 [https://github.com/ecnusse/Kea2](https://github.com/ecnusse/Kea2)
@@ -43,7 +43,7 @@ The group has reached its capacity. Please contact Xixian Liang at [xixian@stu.e
 
 Kea2 is an easy-to-use tool for fuzzing mobile apps. Its key *novelty* is able to fuse automated UI testing with scripts (usually written by human), thus empowering automated UI testing with human intelligence for effectively finding *crashing bugs* as well as *non-crashing functional (logic) bugs*. 
 
-Kea2 is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android), *an industrial-strength automated UI testing tool*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*.
+Kea2 is currently built on top of [Fastbot](https://github.com/ecnusse/Fastbot_Android) 3.0 (a modified/enhanced version of the original [FastBot](https://github.com/bytedance/Fastbot_Android) 2.0), *an industrial-strength automated UI testing tool from ByteDance*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*. 
 Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps. 
 
 ## Novelty & Important features
@@ -76,11 +76,11 @@ Kea2 (and its idea) has been used/integrated by
 
 - [OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app. OPay uses Kea2 for regression testing on POS machines and mobile devices.
 
-- [WeChat's iExplorer]() --- WeChat's in-house testing platform
+- [WeChat's iExplorer]() --- WeChat's in-house testing platform (coming with an interactive UI-based tool to ease writing scripts)
 
-- [WeChat Payment's UAT]() --- WeChat Payment's in-house testing platform
+- [WeChat Payment's UAT]() --- WeChat Payment's in-house testing platform (fully automated property-based testing by synthesizing properties from the system specifications)
 
-- [DevEco Testing](https://developer.huawei.com/consumer/cn/deveco-testing/) --- Huawei's Official Testing Platform for HarmonyOS 
+- [DevEco Testing](https://developer.huawei.com/consumer/cn/deveco-testing/) --- Huawei's Official Testing Platform for HarmonyOS (Kea2 is built upon Hypium)
 
 - [ByteDance's Fastbot](https://github.com/bytedance/Fastbot_Android)
 
@@ -90,7 +90,7 @@ Please let us know and willing to hear your feedback/questions if you are also u
 Kea2 currently works with:
 - [unittest](https://docs.python.org/3/library/unittest.html) as the testing framework to manage the scripts;
 - [uiautomator2](https://github.com/openatx/uiautomator2) as the UI test driver; 
-- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool.
+- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool. 
 
 In the future, Kea2 will be extended to support
 - [pytest](https://docs.pytest.org/en/stable/), another popular python testing framework;
@@ -121,34 +121,34 @@ python3 -m pip install -U kea2-python
 ```
 > If you're using mirror sites like Tsinghua or USTC, you may fail to upgrade. Because these sites may not have the latest version yet. In this case, you can try to install Kea2 by specifying the latest version manually, or use `pypi.org` directly by `pip install kea2-python -i https://pypi.org/simple`.
 
-Upgrade Kea2 to the specifc latest version (e.g., 0.3.6) if you already installed Kea2 before:
+Upgrade Kea2 to the specifc latest version (e.g., 1.0.0) if you already installed Kea2 before:
 ```bash
-python3 -m pip install -U kea2-python==0.3.6
+python3 -m pip install -U kea2-python==1.0.0
 ```
 
+Initialize Kea2 under your preferred working directory:
+```python
+kea2 init
+```
 
+> This initialization step is always needed if it is your first time to run Kea2. If you have upgraded Kea2, you are also recommended to rerun this step to ensure any potential new configurations of Kea2 would take effect.
 
 
 ## 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 a real Android device or an Android emulator (only one device is enough) and make sure you can see the connected device by running `adb devices`. 
+1. Connect to a real Android device or an Android emulator and make sure you can see the connected device by running `adb devices`. 
 
 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
-```
-
-> This step is always needed if it is your first time to run Kea2.
-
 Run the quick test:
-```python
+```bash
 python3 quicktest.py
 ```
 
+> This quick test would automatically download `omninotes.apk`. If the download fails, please copy `omninotes.apk` from Kea2's repository (top-level) to your working directory and execute the quick test command again.
+
 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!
 
@@ -162,7 +162,7 @@ Test your app with the full capability of Fastbot for stress testing and finding
 kea2 run -p it.feio.android.omninotes.alpha --running-minutes 10 --throttle 200
 ```
 
-To understand the meanings of the options, you can see our [manual](docs/manual_en.md#launching-kea2).
+To understand the meanings of the options, you can see our [user manual](docs/manual_en.md#launching-kea2).
 
 > 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). 
 
@@ -242,13 +242,19 @@ For the preceding always-holding property, we can write the following script to
         lambda self: self.d(description="input_box").exists
     )
     def test_input_box(self):
+
+        # genenerate a random non-empty string (this is also property-based testing by feeding random text inputs!)
         from hypothesis.strategies import text, ascii_letters
         random_str = text(alphabet=ascii_letters).example()
+
+        # input this non-empty string into the input box 
         self.d(description="input_box").set_text(random_str)
+
+        # check whether the send button exists
         assert self.d(description="send_button").exist
 
         # we can even do more assertions, e.g.,
-        #       the input string should exist on the message sending page
+        #       the input string should successfully appear on the message sending page
         assert self.d(text=random_str).exist
 ```
 >  We use [hypothesis](https://github.com/HypothesisWorks/hypothesis) to generate random texts.
@@ -283,13 +289,14 @@ kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --th
 
 ## Test Reports（测试报告）
 
-Kea2 automatically generates comprehensive HTML test reports after each testing session.(The location is in the output/ directory)
+Kea2 automatically generates a HTML test report after each testing session. You can find the report in `output/` under your working directory.
 
-If automatic generation fails, you can also manually generate the test report using the command "kea2 report -p 'the path to the folder containing the test data'"
+You can also manually generate the test report by `kea2 report` (see `kea2 report -h` for details).
 
-The reports support both single test runs and merged analysis of multiple test sessions, making it easy to track testing progress and identify issues.
+You can also merge the test report from multiple testing sessions by `kea2 merge` (see `kea2 merge -h` for details).
+The merged test report is quite useful if you would test your apps for multiple sessions.
 
-- [View detailed test report documentation](docs/test_report_introduction.md)
+You can find a sample [test report](https://ecnusse.github.io/Kea2_sample_report/) from Opay (Thank you!). You can find more details on the test report in [this documentation](docs/test_report_introduction.md).
 
 ## Documentations（更多文档）
 
@@ -305,7 +312,8 @@ You can find the [user manual](docs/manual_en.md), which includes:
 ### Other resources about Kea2 (in Chinese)
 - [Q&A for Kea2 and PBT (对Kea2和PBT技术的常见问题和回答)](https://sy8pzmhmun.feishu.cn/wiki/SLGwwqgzIiEuC3kwmV8cSZY0nTg?from=from_copylink) 
 - [Kea2 101 (Kea2 从0到1 的入门教程与最佳实践，建议新手阅读)](https://sy8pzmhmun.feishu.cn/wiki/EwaWwPCitiUJoBkIgALcHtglnDK?from=from_copylink)
-- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/?vd_source=ab7968b8d764666d85d24af49d9b8891)
+- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/)
+- [Kea2 工具快速介绍 (2025.11, bilibili 录播)](https://www.bilibili.com/video/BV1WAyUBDEMw/)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -343,7 +351,7 @@ kea2的核心作用：
 
     提供了条件触发器。 在FB跑路的时候，会不停遍历条件触发器，一旦触发，挂起FB，开始执行触发器指定的 ui test 及 assert。执行完毕，继续切回FB跑路。
 
-hea2做了什么：
+kea2做了什么：
 
     替换了FB的条件触发功能。
     替换了FB的黑名单，黑控件功能。
@@ -371,7 +379,7 @@ hea2做了什么：
 
 > Guided, Stochastic Model-Based GUI Testing of Android Apps. ESEC/FSE 2017.  [pdf](https://dl.acm.org/doi/10.1145/3106237.3106298)
 
-### Maintainers/Contributors
+## Maintainers/Contributors
 
 Kea2 has been actively developed and maintained by the people in [ecnusse](https://github.com/ecnusse):
 
@@ -389,7 +397,13 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 
 Kea2 has also received many valuable insights, advices, feedbacks and lessons shared by several industrial people from Bytedance ([Zhao Zhang](https://github.com/zhangzhao4444), Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
-### Star History
+### Become a Contributor!
+
+Kea2 is an open-source project and we are calling for more contributors to join us!
+
+See [Developer guide](DEVELOP.md) for more details.
+
+## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=ecnusse/Kea2&type=Date)](https://www.star-history.com/#ecnusse/Kea2&Date)
 

{kea2_python-1.0.1 → kea2_python-1.0.3}/README.md

@@ -9,7 +9,7 @@
     <img src="https://github.com/user-attachments/assets/84e47b87-2dd2-4d7e-91d1-e8c1d1db0cf4" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
-The group has reached its capacity. Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn) with your Wechat ID / QR code to be invited to the WeChat group.
+Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn) with your Wechat ID / QR code to be invited to the WeChat discussion group. Of course, we are also ready on GitHub to answer your questions/feedback.
 
 ### Github repo link
 [https://github.com/ecnusse/Kea2](https://github.com/ecnusse/Kea2)
@@ -28,7 +28,7 @@ The group has reached its capacity. Please contact Xixian Liang at [xixian@stu.e
 
 Kea2 is an easy-to-use tool for fuzzing mobile apps. Its key *novelty* is able to fuse automated UI testing with scripts (usually written by human), thus empowering automated UI testing with human intelligence for effectively finding *crashing bugs* as well as *non-crashing functional (logic) bugs*. 
 
-Kea2 is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android), *an industrial-strength automated UI testing tool*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*.
+Kea2 is currently built on top of [Fastbot](https://github.com/ecnusse/Fastbot_Android) 3.0 (a modified/enhanced version of the original [FastBot](https://github.com/bytedance/Fastbot_Android) 2.0), *an industrial-strength automated UI testing tool from ByteDance*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*. 
 Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps. 
 
 ## Novelty & Important features
@@ -61,11 +61,11 @@ Kea2 (and its idea) has been used/integrated by
 
 - [OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app. OPay uses Kea2 for regression testing on POS machines and mobile devices.
 
-- [WeChat's iExplorer]() --- WeChat's in-house testing platform
+- [WeChat's iExplorer]() --- WeChat's in-house testing platform (coming with an interactive UI-based tool to ease writing scripts)
 
-- [WeChat Payment's UAT]() --- WeChat Payment's in-house testing platform
+- [WeChat Payment's UAT]() --- WeChat Payment's in-house testing platform (fully automated property-based testing by synthesizing properties from the system specifications)
 
-- [DevEco Testing](https://developer.huawei.com/consumer/cn/deveco-testing/) --- Huawei's Official Testing Platform for HarmonyOS 
+- [DevEco Testing](https://developer.huawei.com/consumer/cn/deveco-testing/) --- Huawei's Official Testing Platform for HarmonyOS (Kea2 is built upon Hypium)
 
 - [ByteDance's Fastbot](https://github.com/bytedance/Fastbot_Android)
 
@@ -75,7 +75,7 @@ Please let us know and willing to hear your feedback/questions if you are also u
 Kea2 currently works with:
 - [unittest](https://docs.python.org/3/library/unittest.html) as the testing framework to manage the scripts;
 - [uiautomator2](https://github.com/openatx/uiautomator2) as the UI test driver; 
-- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool.
+- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool. 
 
 In the future, Kea2 will be extended to support
 - [pytest](https://docs.pytest.org/en/stable/), another popular python testing framework;
@@ -106,34 +106,34 @@ python3 -m pip install -U kea2-python
 ```
 > If you're using mirror sites like Tsinghua or USTC, you may fail to upgrade. Because these sites may not have the latest version yet. In this case, you can try to install Kea2 by specifying the latest version manually, or use `pypi.org` directly by `pip install kea2-python -i https://pypi.org/simple`.
 
-Upgrade Kea2 to the specifc latest version (e.g., 0.3.6) if you already installed Kea2 before:
+Upgrade Kea2 to the specifc latest version (e.g., 1.0.0) if you already installed Kea2 before:
 ```bash
-python3 -m pip install -U kea2-python==0.3.6
+python3 -m pip install -U kea2-python==1.0.0
 ```
 
+Initialize Kea2 under your preferred working directory:
+```python
+kea2 init
+```
 
+> This initialization step is always needed if it is your first time to run Kea2. If you have upgraded Kea2, you are also recommended to rerun this step to ensure any potential new configurations of Kea2 would take effect.
 
 
 ## 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 a real Android device or an Android emulator (only one device is enough) and make sure you can see the connected device by running `adb devices`. 
+1. Connect to a real Android device or an Android emulator and make sure you can see the connected device by running `adb devices`. 
 
 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
-```
-
-> This step is always needed if it is your first time to run Kea2.
-
 Run the quick test:
-```python
+```bash
 python3 quicktest.py
 ```
 
+> This quick test would automatically download `omninotes.apk`. If the download fails, please copy `omninotes.apk` from Kea2's repository (top-level) to your working directory and execute the quick test command again.
+
 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!
 
@@ -147,7 +147,7 @@ Test your app with the full capability of Fastbot for stress testing and finding
 kea2 run -p it.feio.android.omninotes.alpha --running-minutes 10 --throttle 200
 ```
 
-To understand the meanings of the options, you can see our [manual](docs/manual_en.md#launching-kea2).
+To understand the meanings of the options, you can see our [user manual](docs/manual_en.md#launching-kea2).
 
 > 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). 
 
@@ -227,13 +227,19 @@ For the preceding always-holding property, we can write the following script to
         lambda self: self.d(description="input_box").exists
     )
     def test_input_box(self):
+
+        # genenerate a random non-empty string (this is also property-based testing by feeding random text inputs!)
         from hypothesis.strategies import text, ascii_letters
         random_str = text(alphabet=ascii_letters).example()
+
+        # input this non-empty string into the input box 
         self.d(description="input_box").set_text(random_str)
+
+        # check whether the send button exists
         assert self.d(description="send_button").exist
 
         # we can even do more assertions, e.g.,
-        #       the input string should exist on the message sending page
+        #       the input string should successfully appear on the message sending page
         assert self.d(text=random_str).exist
 ```
 >  We use [hypothesis](https://github.com/HypothesisWorks/hypothesis) to generate random texts.
@@ -268,13 +274,14 @@ kea2 run -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --th
 
 ## Test Reports（测试报告）
 
-Kea2 automatically generates comprehensive HTML test reports after each testing session.(The location is in the output/ directory)
+Kea2 automatically generates a HTML test report after each testing session. You can find the report in `output/` under your working directory.
 
-If automatic generation fails, you can also manually generate the test report using the command "kea2 report -p 'the path to the folder containing the test data'"
+You can also manually generate the test report by `kea2 report` (see `kea2 report -h` for details).
 
-The reports support both single test runs and merged analysis of multiple test sessions, making it easy to track testing progress and identify issues.
+You can also merge the test report from multiple testing sessions by `kea2 merge` (see `kea2 merge -h` for details).
+The merged test report is quite useful if you would test your apps for multiple sessions.
 
-- [View detailed test report documentation](docs/test_report_introduction.md)
+You can find a sample [test report](https://ecnusse.github.io/Kea2_sample_report/) from Opay (Thank you!). You can find more details on the test report in [this documentation](docs/test_report_introduction.md).
 
 ## Documentations（更多文档）
 
@@ -290,7 +297,8 @@ You can find the [user manual](docs/manual_en.md), which includes:
 ### Other resources about Kea2 (in Chinese)
 - [Q&A for Kea2 and PBT (对Kea2和PBT技术的常见问题和回答)](https://sy8pzmhmun.feishu.cn/wiki/SLGwwqgzIiEuC3kwmV8cSZY0nTg?from=from_copylink) 
 - [Kea2 101 (Kea2 从0到1 的入门教程与最佳实践，建议新手阅读)](https://sy8pzmhmun.feishu.cn/wiki/EwaWwPCitiUJoBkIgALcHtglnDK?from=from_copylink)
-- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/?vd_source=ab7968b8d764666d85d24af49d9b8891)
+- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/)
+- [Kea2 工具快速介绍 (2025.11, bilibili 录播)](https://www.bilibili.com/video/BV1WAyUBDEMw/)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -328,7 +336,7 @@ kea2的核心作用：
 
     提供了条件触发器。 在FB跑路的时候，会不停遍历条件触发器，一旦触发，挂起FB，开始执行触发器指定的 ui test 及 assert。执行完毕，继续切回FB跑路。
 
-hea2做了什么：
+kea2做了什么：
 
     替换了FB的条件触发功能。
     替换了FB的黑名单，黑控件功能。
@@ -356,7 +364,7 @@ hea2做了什么：
 
 > Guided, Stochastic Model-Based GUI Testing of Android Apps. ESEC/FSE 2017.  [pdf](https://dl.acm.org/doi/10.1145/3106237.3106298)
 
-### Maintainers/Contributors
+## Maintainers/Contributors
 
 Kea2 has been actively developed and maintained by the people in [ecnusse](https://github.com/ecnusse):
 
@@ -374,7 +382,13 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 
 Kea2 has also received many valuable insights, advices, feedbacks and lessons shared by several industrial people from Bytedance ([Zhao Zhang](https://github.com/zhangzhao4444), Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
-### Star History
+### Become a Contributor!
+
+Kea2 is an open-source project and we are calling for more contributors to join us!
+
+See [Developer guide](DEVELOP.md) for more details.
+
+## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=ecnusse/Kea2&type=Date)](https://www.star-history.com/#ecnusse/Kea2&Date)
 

{kea2_python-1.0.1 → kea2_python-1.0.3}/kea2/adbUtils.py

@@ -1,11 +1,12 @@
 import sys
 import subprocess
 import threading
-from typing import List, Optional, Set, Tuple
 
-from kea2.utils import getLogger
+from typing import IO, Generator, Optional, List, Union, List, Optional, Set, Tuple
+
 from adbutils import AdbDevice, adb
-from typing import IO, TYPE_CHECKING, Generator, Optional, List, Union
+
+from .utils import getLogger
 
 logger = getLogger(__name__)