Kea2-python 0.1.0b0__tar.gz → 0.1.2__tar.gz

{kea2_python-0.1.0b0 → kea2_python-0.1.2}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.1.0b0
+Version: 0.1.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
@@ -8,6 +8,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: rtree>=1.3.0
 Requires-Dist: uiautomator2>=3.2.9
+Requires-Dist: jinja2>=3.0.0
 Dynamic: license-file
 
 
@@ -17,7 +18,7 @@ Dynamic: license-file
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
 
 <div>
-    <img src="https://github.com/user-attachments/assets/dad0dbf5-b5d3-414b-a627-281a0fa40cf1" style="border-radius: 14px; width: 20%; height: 20%;"/> 
+    <img src="https://github.com/user-attachments/assets/1a64635b-a8f2-40f1-8f16-55e47b1d74e7" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
 ## About
@@ -66,7 +67,7 @@ In the future, Kea2 will be extended to support
 
 Running environment:
 - support Windows, MacOS and Linux
-- python 3.8+, Android 4.4+ (Android SDK installed)
+- python 3.8+, Android 5.0+ (Android SDK installed)
 - **VPN closed** (Features 2 and 3 required)
 
 Install Kea2 by `pip`:
@@ -203,28 +204,24 @@ For the preceding always-holding property, we can write the following script to
 ```
 >  We use [hypothesis](https://github.com/HypothesisWorks/hypothesis) to generate random texts.
 
-You can run this example by using the similar command line in Feature 2. `--take-screenshots` is recommanded to replay the functional bug.
-
-> Notes: `--take-screenshots` will need more disk space on PC.
-
-```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 --take-screenshots unittest discover -p quicktest.py
-```
+You can run this example by using the similar command line in Feature 2. 
 
 ## Documentations（更多文档）
 
-[更多文档](docs/manual_en.md)：如何定义Kea2脚本、如何启动Kea2、如何查看/理解Kea2的运行结果
-
-[如何黑白控件/区域](docs/blacklisting.md)
+[更多文档](docs/manual_en.md)，包括了：
+- Kea2的案例教程（基于微信介绍）、
+- Kea2脚本的定义方法，支持的脚本装饰器(如`@precondition`、`@prob`、`@max_tries`)、
+- Kea2的启动方式、命令行选项
+- 查看/理解Kea2的运行结果（如界面截图、测试覆盖率、脚本执行成功与否）。
+- [如何黑白控件/区域](docs/blacklisting.md)
 
-### Open-source projects used by Kea2
+## Open-source projects used by Kea2
 
 - [Fastbot](https://github.com/bytedance/Fastbot_Android)
 - [uiautomator2](https://github.com/openatx/uiautomator2)
 - [hypothesis](https://github.com/HypothesisWorks/hypothesis)
 
-### Relevant papers of Kea2
+## Relevant papers of Kea2
 
 > General and Practical Property-based Testing for Android Apps. ASE 2024. [pdf](https://dl.acm.org/doi/10.1145/3691620.3694986)
 
@@ -254,4 +251,4 @@ Kea2 has also received many valuable insights, advices, feedbacks and lessons sh
 
 [^1]: 不少UI自动化测试工具提供了“自定义事件序列”能力（如[Fastbot](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E5%BA%8F%E5%88%97) 和[AppCrawler](https://github.com/seveniruby/AppCrawler)），但在实际使用中存在不少问题，如自定义能力有限、使用不灵活等。此前不少Fastbot用户抱怨过其“自定义事件序列”在使用中的问题，如[#209](https://github.com/bytedance/Fastbot_Android/issues/209), [#225](https://github.com/bytedance/Fastbot_Android/issues/225), [#286](https://github.com/bytedance/Fastbot_Android/issues/286)等。
 
-[^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。
+[^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。 

{kea2_python-0.1.0b0 → kea2_python-0.1.2}/Kea2_python.egg-info/SOURCES.txt

@@ -10,7 +10,9 @@ 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
@@ -19,6 +21,7 @@ kea2/u2Driver.py
 kea2/utils.py
 kea2/assets/fastbot-thirdpart.jar
 kea2/assets/framework.jar
+kea2/assets/kea2-thirdpart.jar
 kea2/assets/monkeyq.jar
 kea2/assets/quicktest.py
 kea2/assets/fastbot_configs/abl.strings
@@ -32,4 +35,5 @@ kea2/assets/fastbot_configs/widget.block.py
 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/assets/fastbot_libs/x86_64/libfastbot_native.so
+kea2/templates/bug_report_template.html

{kea2_python-0.1.0b0 → kea2_python-0.1.2}/Kea2_python.egg-info/requires.txt

@@ -1,2 +1,3 @@
 rtree>=1.3.0
 uiautomator2>=3.2.9
+jinja2>=3.0.0

{kea2_python-0.1.0b0 → kea2_python-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.1.0b0
+Version: 0.1.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
@@ -8,6 +8,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: rtree>=1.3.0
 Requires-Dist: uiautomator2>=3.2.9
+Requires-Dist: jinja2>=3.0.0
 Dynamic: license-file
 
 
@@ -17,7 +18,7 @@ Dynamic: license-file
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
 
 <div>
-    <img src="https://github.com/user-attachments/assets/dad0dbf5-b5d3-414b-a627-281a0fa40cf1" style="border-radius: 14px; width: 20%; height: 20%;"/> 
+    <img src="https://github.com/user-attachments/assets/1a64635b-a8f2-40f1-8f16-55e47b1d74e7" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
 ## About
@@ -66,7 +67,7 @@ In the future, Kea2 will be extended to support
 
 Running environment:
 - support Windows, MacOS and Linux
-- python 3.8+, Android 4.4+ (Android SDK installed)
+- python 3.8+, Android 5.0+ (Android SDK installed)
 - **VPN closed** (Features 2 and 3 required)
 
 Install Kea2 by `pip`:
@@ -203,28 +204,24 @@ For the preceding always-holding property, we can write the following script to
 ```
 >  We use [hypothesis](https://github.com/HypothesisWorks/hypothesis) to generate random texts.
 
-You can run this example by using the similar command line in Feature 2. `--take-screenshots` is recommanded to replay the functional bug.
-
-> Notes: `--take-screenshots` will need more disk space on PC.
-
-```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 --take-screenshots unittest discover -p quicktest.py
-```
+You can run this example by using the similar command line in Feature 2. 
 
 ## Documentations（更多文档）
 
-[更多文档](docs/manual_en.md)：如何定义Kea2脚本、如何启动Kea2、如何查看/理解Kea2的运行结果
-
-[如何黑白控件/区域](docs/blacklisting.md)
+[更多文档](docs/manual_en.md)，包括了：
+- Kea2的案例教程（基于微信介绍）、
+- Kea2脚本的定义方法，支持的脚本装饰器(如`@precondition`、`@prob`、`@max_tries`)、
+- Kea2的启动方式、命令行选项
+- 查看/理解Kea2的运行结果（如界面截图、测试覆盖率、脚本执行成功与否）。
+- [如何黑白控件/区域](docs/blacklisting.md)
 
-### Open-source projects used by Kea2
+## Open-source projects used by Kea2
 
 - [Fastbot](https://github.com/bytedance/Fastbot_Android)
 - [uiautomator2](https://github.com/openatx/uiautomator2)
 - [hypothesis](https://github.com/HypothesisWorks/hypothesis)
 
-### Relevant papers of Kea2
+## Relevant papers of Kea2
 
 > General and Practical Property-based Testing for Android Apps. ASE 2024. [pdf](https://dl.acm.org/doi/10.1145/3691620.3694986)
 
@@ -254,4 +251,4 @@ Kea2 has also received many valuable insights, advices, feedbacks and lessons sh
 
 [^1]: 不少UI自动化测试工具提供了“自定义事件序列”能力（如[Fastbot](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E5%BA%8F%E5%88%97) 和[AppCrawler](https://github.com/seveniruby/AppCrawler)），但在实际使用中存在不少问题，如自定义能力有限、使用不灵活等。此前不少Fastbot用户抱怨过其“自定义事件序列”在使用中的问题，如[#209](https://github.com/bytedance/Fastbot_Android/issues/209), [#225](https://github.com/bytedance/Fastbot_Android/issues/225), [#286](https://github.com/bytedance/Fastbot_Android/issues/286)等。
 
-[^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。
+[^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。 

{kea2_python-0.1.0b0 → kea2_python-0.1.2}/README.md

@@ -5,7 +5,7 @@
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
 
 <div>
-    <img src="https://github.com/user-attachments/assets/dad0dbf5-b5d3-414b-a627-281a0fa40cf1" style="border-radius: 14px; width: 20%; height: 20%;"/> 
+    <img src="https://github.com/user-attachments/assets/1a64635b-a8f2-40f1-8f16-55e47b1d74e7" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
 ## About
@@ -54,7 +54,7 @@ In the future, Kea2 will be extended to support
 
 Running environment:
 - support Windows, MacOS and Linux
-- python 3.8+, Android 4.4+ (Android SDK installed)
+- python 3.8+, Android 5.0+ (Android SDK installed)
 - **VPN closed** (Features 2 and 3 required)
 
 Install Kea2 by `pip`:
@@ -191,28 +191,24 @@ For the preceding always-holding property, we can write the following script to
 ```
 >  We use [hypothesis](https://github.com/HypothesisWorks/hypothesis) to generate random texts.
 
-You can run this example by using the similar command line in Feature 2. `--take-screenshots` is recommanded to replay the functional bug.
-
-> Notes: `--take-screenshots` will need more disk space on PC.
-
-```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 --take-screenshots unittest discover -p quicktest.py
-```
+You can run this example by using the similar command line in Feature 2. 
 
 ## Documentations（更多文档）
 
-[更多文档](docs/manual_en.md)：如何定义Kea2脚本、如何启动Kea2、如何查看/理解Kea2的运行结果
-
-[如何黑白控件/区域](docs/blacklisting.md)
+[更多文档](docs/manual_en.md)，包括了：
+- Kea2的案例教程（基于微信介绍）、
+- Kea2脚本的定义方法，支持的脚本装饰器(如`@precondition`、`@prob`、`@max_tries`)、
+- Kea2的启动方式、命令行选项
+- 查看/理解Kea2的运行结果（如界面截图、测试覆盖率、脚本执行成功与否）。
+- [如何黑白控件/区域](docs/blacklisting.md)
 
-### Open-source projects used by Kea2
+## Open-source projects used by Kea2
 
 - [Fastbot](https://github.com/bytedance/Fastbot_Android)
 - [uiautomator2](https://github.com/openatx/uiautomator2)
 - [hypothesis](https://github.com/HypothesisWorks/hypothesis)
 
-### Relevant papers of Kea2
+## Relevant papers of Kea2
 
 > General and Practical Property-based Testing for Android Apps. ASE 2024. [pdf](https://dl.acm.org/doi/10.1145/3691620.3694986)
 
@@ -242,4 +238,4 @@ Kea2 has also received many valuable insights, advices, feedbacks and lessons sh
 
 [^1]: 不少UI自动化测试工具提供了“自定义事件序列”能力（如[Fastbot](https://github.com/bytedance/Fastbot_Android/blob/main/handbook-cn.md#%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E5%BA%8F%E5%88%97) 和[AppCrawler](https://github.com/seveniruby/AppCrawler)），但在实际使用中存在不少问题，如自定义能力有限、使用不灵活等。此前不少Fastbot用户抱怨过其“自定义事件序列”在使用中的问题，如[#209](https://github.com/bytedance/Fastbot_Android/issues/209), [#225](https://github.com/bytedance/Fastbot_Android/issues/225), [#286](https://github.com/bytedance/Fastbot_Android/issues/286)等。
 
-[^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。
+[^2]: 在UI自动化测试过程中支持自动断言是一个很重要的能力，但几乎没有测试工具提供这样的能力。我们注意到[AppCrawler](https://ceshiren.com/t/topic/15801/5)的开发者曾经希望提供一种断言机制，得到了用户的热切响应，不少用户从21年就开始催更，但始终未能实现。 

{kea2_python-0.1.0b0 → kea2_python-0.1.2}/kea2/assets/quicktest.py

@@ -81,7 +81,9 @@ if __name__ == "__main__":
             Driver=U2Driver,
             packageNames=[PACKAGE_NAME],
             # serial="emulator-5554",   # specify the serial
-            maxStep=5000,
+            maxStep=50,
+            profile_period=10,
+            take_screenshots=True,  # whether to take screenshots, default is False
             # 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="u2"  # 'native' for running the vanilla Fastbot, 'u2' for running Kea2