Kea2-python 1.0.0__tar.gz → 1.0.2__tar.gz

{kea2_python-1.0.0 → kea2_python-1.0.2}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 1.0.0
+Version: 1.0.2
 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)
@@ -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)
 
@@ -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的黑名单，黑控件功能。

{kea2_python-1.0.0 → kea2_python-1.0.2}/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.0 → kea2_python-1.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 1.0.0
+Version: 1.0.2
 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)
@@ -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)
 
@@ -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的黑名单，黑控件功能。

{kea2_python-1.0.0 → kea2_python-1.0.2}/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)
@@ -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)
 
@@ -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的黑名单，黑控件功能。

{kea2_python-1.0.0 → kea2_python-1.0.2}/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__)
 

{kea2_python-1.0.0 → kea2_python-1.0.2}/kea2/assets/quicktest.py

@@ -72,21 +72,36 @@ class Omni_Notes_Sample(unittest.TestCase):
 
 
 URL = "https://github.com/federicoiosue/Omni-Notes/releases/download/6.2.0_alpha/OmniNotes-alphaRelease-6.2.0.apk"
+FALL_BACK_URL = "https://gitee.com/XixianLiang/Kea2/raw/main/omninotes.apk"
 PACKAGE_NAME = "it.feio.android.omninotes.alpha"
 FILE_NAME = "omninotes.apk"
 
 
-def check_installation(serial=None):
-    import os
-    from pathlib import Path
-    if not os.path.exists(Path(".") / FILE_NAME):
-        print(f"[INFO] omninote.apk not exists. Downloading from {URL}", flush=True)
+def download_omninotes():
+    import socket
+    socket.setdefaulttimeout(30)
+    try:
         import urllib.request
         urllib.request.urlretrieve(URL, FILE_NAME)
+    except Exception as e:
+        print(f"[WARN] Download from {URL} failed: {e}. Try to download from fallback URL {FALL_BACK_URL}", flush=True)
+        try:
+            urllib.request.urlretrieve(FALL_BACK_URL, FILE_NAME)
+        except Exception as e2:
+            print(f"[ERROR] Download from fallback URL {FALL_BACK_URL} also failed: {e2}", flush=True)
+            raise e2
+
 
+def check_installation(serial=None):
+    import os
+    from pathlib import Path
+    
     d = u2.connect(serial)
     # automatically install omni-notes
     if PACKAGE_NAME not in d.app_list():
+        if not os.path.exists(Path(".") / FILE_NAME):
+            print(f"[INFO] omninote.apk not exists. Downloading from {URL}", flush=True)
+            download_omninotes()
         print("[INFO] Installing omninotes.", flush=True)
         d.app_install(FILE_NAME)
     d.stop_uiautomator()

{kea2_python-1.0.0 → kea2_python-1.0.2}/kea2/cli.py

@@ -55,42 +55,23 @@ def cmd_load_configs(args):
 
 
 def cmd_report(args):
-    from .bug_report_generator import BugReportGenerator
-    try:
-        report_dir = args.path
-        if not report_dir:
-            logger.error("Report directory path is required. Use -p to specify the path.")
-            return
-
-        if Path(report_dir).is_absolute():
-            report_path = Path(report_dir)
-        else:
-            report_path = Path.cwd() / report_dir
-
-        report_path = report_path.resolve()
+    from .report.bug_report_generator import BugReportGenerator
+    report_dirs = args.path
+    
+    for report_dir in report_dirs:
+        report_dir = Path(report_dir).resolve()
 
-        if not report_path.exists():
-            logger.error(f"Report directory does not exist: {report_path}")
-            return
+        if not report_dir.exists():
+            logger.error(f"Report directory does not exist: {str(report_dir)}, Skipped.")
+            continue
         
         logger.debug(f"Generating test report from directory: {report_dir}")
-
-        generator = BugReportGenerator()
-        report_file = generator.generate_report(report_path)
-        
-        if report_file:
-            logger.debug(f"Test report generated successfully: {report_file}")
-            print(f"Report saved to: {report_file}", flush=True)
-        else:
-            logger.error("Failed to generate test report")
-
-    except Exception as e:
-        logger.error(f"Error generating test report: {e}")
+        BugReportGenerator(report_dir).generate_report()
 
 
 def cmd_merge(args):
     """Merge multiple test report directories and generate a combined report"""
-    from .report_merger import TestReportMerger
+    from .report.report_merger import TestReportMerger
 
     try:
         # Validate input paths
@@ -112,12 +93,11 @@ def cmd_merge(args):
         merger = TestReportMerger()
 
         # Merge test reports
-        merged_dir = merger.merge_reports(args.paths, args.output)
+        merged_report = merger.merge_reports(args.paths, args.output)
 
         # Print results
         print(f"✅ Test reports merged successfully!", flush=True)
-        print(f"📁 Merged report directory: {merged_dir}", flush=True)
-        print(f"📊 Merged report: {merged_dir}/merged_report.html", flush=True)
+        print(f"📊 Merged report: {merged_report}", flush=True)
 
         # Get merge summary
         merge_summary = merger.get_merge_summary()
@@ -154,8 +134,9 @@ _commands = [
                 name=["report_dir"],
                 args=["-p", "--path"],
                 type=str,
+                nargs="+",
                 required=True,
-                help="Path to the directory containing test results"
+                help="Root directory path of the test results to generate report from"
             )
         ]
     ),

{kea2_python-1.0.0 → kea2_python-1.0.2}/kea2/fastbotManager.py

@@ -1,15 +1,17 @@
 import itertools
-from retry import retry
-from retry.api import retry_call
-from dataclasses import asdict
 import requests
-from packaging.version import parse as parse_version
+
 from time import sleep
+from dataclasses import asdict
+from pathlib import Path
 
+from retry import retry
+from retry.api import retry_call
 from uiautomator2.core import HTTPResponse, _http_request
-from kea2.adbUtils import ADBDevice, ADBStreamShell_V2
-from pathlib import Path
-from kea2.utils import getLogger, getProjectRoot
+from packaging.version import parse as parse_version
+
+from .utils import getLogger, getProjectRoot
+from .adbUtils import ADBDevice, ADBStreamShell_V2
 
 
 from typing import IO, TYPE_CHECKING, Dict
@@ -117,6 +119,7 @@ class FastbotManager:
         post_data = {
             "takeScreenshots": options.take_screenshots,
             "preFailureScreenshots": options.pre_failure_screenshots,
+            "postFailureScreenshots": options.post_failure_screenshots,
             "logStamp": stamp,
             "deviceOutputRoot": options.device_output_root,
         }