Kea2-python 0.1.0b0__py3-none-any.whl → 0.1.2__py3-none-any.whl

kea2/utils.py

@@ -47,14 +47,10 @@ d = Device
 
 
 def getProjectRoot():
-    root = Path("/")
+    root = Path(Path.cwd().anchor)
     cur_dir = Path.absolute(Path(os.curdir))
     while not os.path.isdir(cur_dir / "configs"):
         if cur_dir == root:
             return None
         cur_dir = cur_dir.parent
     return cur_dir
-
-
-
- 

{kea2_python-0.1.0b0.dist-info → kea2_python-0.1.2.dist-info}/METADATA

@@ -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.dist-info → kea2_python-0.1.2.dist-info}/RECORD

@@ -1,17 +1,20 @@
 kea2/__init__.py,sha256=JFJjqgf5KB4bXUFQ3upkEug0cFMFIk9p3OHV9vzulHw,75
 kea2/absDriver.py,sha256=X99d-OP77EIiDwTLvWVkgDUtqscoxmWeOb-EcaOPWGI,1294
 kea2/adbUtils.py,sha256=j6goAAzV1Ikmv26DZEE0Oi8S1PrejcV1Io3u_Xw4ws4,9910
+kea2/bug_report_generator.py,sha256=G5h9nI1w1UaksjF3gkMC8UrXgiNmtU1D5VIuPiciOak,22792
 kea2/cli.py,sha256=YgWOe5JB0_WBTKyBShBEymhLIqj6K5gNR4Aaj6Pbtn0,2796
-kea2/keaUtils.py,sha256=iV82-aUB8Wc0VkIUTDAk2lxsfr-RAABzTcb0igQYXbo,27037
-kea2/kea_launcher.py,sha256=Kj49TBJ8aRRJQI24y3vwbBMyTenJpL1HAqgv4ETRT9E,4986
-kea2/logWatcher.py,sha256=RQp9b6yF24Vh6_dUgx-nrSjiz-mP4uXjyVz7_HfYQ28,2029
+kea2/fastbotManager.py,sha256=Ru7Aitcjlem52npJJLg-3KX5ctCoflaaLG4N0IgQ2QU,4828
+kea2/keaUtils.py,sha256=civETbAJaRJsVf7hb-ZKqcDRAaRfpxIdj0frBwyvsjk,25175
+kea2/kea_launcher.py,sha256=xDMHAzD2Ig2Dug9K4MzkTPwieKvLASmjUahEst8aaVU,5291
+kea2/logWatcher.py,sha256=qpIsflbP37eX5b4EaWnrqyPbGP9lzQhRr3ainGFfZeI,2211
 kea2/resultSyncer.py,sha256=f3qfne8WQCo1AA3cwx9IZzLdenjjMWbEpAqPdvddAqk,1984
 kea2/u2Driver.py,sha256=1uViwhQAkBFu69XFR5i8dSgG8SL3v7wZ68-t0E0Xlpw,14876
-kea2/utils.py,sha256=bLS8SokdLffOnRrncDn6JBNrnYzAQ-pIOsE4uLirwbA,1374
+kea2/utils.py,sha256=8b4y-_B7knKRN_HqpWZM900IdRiZXwmzQnduVVN0GxQ,1384
 kea2/assets/fastbot-thirdpart.jar,sha256=0SZ_OoZFWDGMnazgXKceHgKvXdUDoIa3Gb2bcifaikk,85664
 kea2/assets/framework.jar,sha256=rTluOJJKj2DFwh7ascXso1udYdWv00BxBwSQ3Vmv-fw,1149240
-kea2/assets/monkeyq.jar,sha256=6eio4sDwd9F2w0CTwROP7RmbbC1a6ghVKKljxVE8w4g,463163
-kea2/assets/quicktest.py,sha256=j-fIryvspXObaNm3kWzgM0LMFes4h7EXT5C9xUWGUVo,2887
+kea2/assets/kea2-thirdpart.jar,sha256=HYdtG2gqDLuLb72dpK3lX-Y6QUNTrJ-bfQopU5aWpfo,359346
+kea2/assets/monkeyq.jar,sha256=EU8aF9S3N1SiZ_RGxP2etPeNBLr9tVPwj0XcCwGNcjc,111988
+kea2/assets/quicktest.py,sha256=TJj9GaRioFrijU9PMLpyZY8S07db67UZFBr5G-aQY80,3000
 kea2/assets/fastbot_configs/abl.strings,sha256=Rn8_YEbVGOJqndIY_-kWnR5NaoFI-cuB-ij10Ddhl90,75
 kea2/assets/fastbot_configs/awl.strings,sha256=-j4980GoWQxGOM9ijAwXPQmziCwFBZJFmuiv2tOEaYI,101
 kea2/assets/fastbot_configs/max.config,sha256=rBgR4mdgBzqVPQ2lZaXqx2WN6tDzhe-FNizm4Y7tyA8,226
@@ -20,13 +23,14 @@ kea2/assets/fastbot_configs/max.schema.strings,sha256=zYupzvmTtnbPYomI2UCPk0s6PE
 kea2/assets/fastbot_configs/max.strings,sha256=k82GAAZZG7KbDI7bk7DUklp41WJJO7j-j8Ss1BcybUw,32
 kea2/assets/fastbot_configs/max.tree.pruning,sha256=dm0oesN75FFbVSkV7STDUmrNMpQUBEuO7Uymt6nEkBc,629
 kea2/assets/fastbot_configs/widget.block.py,sha256=r9Njm2xSBls3GMDIHTPMdmlFRiOjJWuVsq2KiieWFXA,1272
-kea2/assets/fastbot_libs/arm64-v8a/libfastbot_native.so,sha256=dA2Tf74-gDrCFdeClsf7qZAy0RqDZQOLlBZ-FViuorw,2005832
-kea2/assets/fastbot_libs/armeabi-v7a/libfastbot_native.so,sha256=GWcL8M8WfQAd9CfOM6pRYbOnxeycN-LiL7Mf59YIadE,1334420
+kea2/assets/fastbot_libs/arm64-v8a/libfastbot_native.so,sha256=tAFrG73pJi7XakRxSp9CavPHbexKvhC9NOMdt48IEuM,2006872
+kea2/assets/fastbot_libs/armeabi-v7a/libfastbot_native.so,sha256=UV8bhaiPoPKdd3q0vj3kSZqPR9anllai_tz_2QkMMbQ,1335372
 kea2/assets/fastbot_libs/x86/libfastbot_native.so,sha256=k-aw1gEXRWMKZRNHIggKNuZy0wC1y2BnveJGEIO6rbo,2036856
 kea2/assets/fastbot_libs/x86_64/libfastbot_native.so,sha256=tiofhlf4uMQcU5WAvrdLgTBME0lb83hVUoGtTwxmE8A,2121416
-kea2_python-0.1.0b0.dist-info/licenses/LICENSE,sha256=nM9PPjcsXVo5SzNsjRqWgA-gdJlwqZZcRDSC6Qf6bVE,2034
-kea2_python-0.1.0b0.dist-info/METADATA,sha256=akhVwN64y8HfDVvuifnxasVIqgMZgE-BqXx_Yar7Hfo,13356
-kea2_python-0.1.0b0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kea2_python-0.1.0b0.dist-info/entry_points.txt,sha256=mFX06TyxXiUAJQ6JZn8QHzfn8n5R8_KJ5W-pTm_fRCA,39
-kea2_python-0.1.0b0.dist-info/top_level.txt,sha256=TsgNH4PQoNOVhegpO7AcjutMVWp6Z4KDL1pBH9FnMmk,5
-kea2_python-0.1.0b0.dist-info/RECORD,,
+kea2/templates/bug_report_template.html,sha256=sQ0Uu8SPeOIiyX5vPPTZPVKxh9-9raAZcCjSRS8YFe0,40624
+kea2_python-0.1.2.dist-info/licenses/LICENSE,sha256=nM9PPjcsXVo5SzNsjRqWgA-gdJlwqZZcRDSC6Qf6bVE,2034
+kea2_python-0.1.2.dist-info/METADATA,sha256=uVrc81g1R20PPcsSn2cJg7tuAZ84GnGcL8kMI1Hfrys,13233
+kea2_python-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kea2_python-0.1.2.dist-info/entry_points.txt,sha256=mFX06TyxXiUAJQ6JZn8QHzfn8n5R8_KJ5W-pTm_fRCA,39
+kea2_python-0.1.2.dist-info/top_level.txt,sha256=TsgNH4PQoNOVhegpO7AcjutMVWp6Z4KDL1pBH9FnMmk,5
+kea2_python-0.1.2.dist-info/RECORD,,