Kea2-python 0.3.3__tar.gz → 0.3.5__tar.gz

{kea2_python-0.3.3 → kea2_python-0.3.5/Kea2_python.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.3.3
+Version: 0.3.5
 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
@@ -10,7 +10,7 @@ Requires-Dist: rtree>=1.3.0
 Requires-Dist: jinja2>=3.0.0
 Requires-Dist: uiautomator2>=3.3.3
 Requires-Dist: adbutils>=2.9.3
-Requires-Dist: setuptools>=75.3.2
+Requires-Dist: packaging>=25.0
 Dynamic: license-file
 
 
@@ -39,6 +39,7 @@ The group has reached its capacity. Please contact Xixian Liang at [xixian@stu.e
 <div align="center">
     <a href="https://en.wikipedia.org/wiki/Kea">Kea2's logo: A large parrot skilled in finding "bugs"</a>
 </div>
+</br>
 
 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*. 
 
@@ -110,9 +111,10 @@ Find Kea2's options by running
 kea2 -h
 ```
 
-> Upgrade Kea2 by `pip`:
-> 
-> `python3 -m pip install -U kea2-python`
+Upgrade Kea2 to its latest version if you already installed Kea2 before:
+```bash
+python3 -m pip install -U kea2-python
+```
 
 ## Quick Test
 
@@ -239,7 +241,15 @@ 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. 
+You can run this example by using the similar command line in Feature 2.
+
+## Test Reports（测试报告）
+
+Kea2 automatically generates comprehensive HTML test reports after each testing session.
+
+The reports support both single test runs and merged analysis of multiple test sessions, making it easy to track testing progress and identify issues.
+
+- [View detailed test report documentation](docs/test_report_introduction.md)
 
 ## Documentations（更多文档）
 
@@ -250,6 +260,7 @@ You can find the [user manual](docs/manual_en.md), which includes:
 - How to find and understand Kea2's testing results
 - How to [whitelist or blacklist](docs/blacklisting.md) specific activities, UI widgets and UI regions during fuzzing
 - [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)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -329,7 +340,7 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 [@Drifterpc]: https://github.com/Drifterpc
 [@tingsu]: https://github.com/tingsu
 
-[Zhendong Su](https://people.inf.ethz.ch/suz/), [Yiheng Xiong](https://xyiheng.github.io/), [Xiangchen Shen](https://xiangchenshen.github.io/), [Mengqian Xu](https://mengqianx.github.io/), [Haiying Sun](https://faculty.ecnu.edu.cn/_s43/shy/main.psp), [Jingling Sun](https://jinglingsun.github.io/), [Jue Wang](https://cv.juewang.info/) have also been actively participated in this project and contributed a lot!
+[Zhendong Su](https://people.inf.ethz.ch/suz/), [Yiheng Xiong](https://xyiheng.github.io/), [Xiangchen Shen](https://xiangchenshen.github.io/), [Mengqian Xu](https://mengqianx.github.io/), [Haiying Sun](https://faculty.ecnu.edu.cn/_s43/shy/main.psp), [Jingling Sun](https://jinglingsun.github.io/), [Jue Wang](https://cv.juewang.info/), [Geguang Pu]() have also been actively participated in this project and contributed a lot!
 
 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!
 

{kea2_python-0.3.3 → kea2_python-0.3.5}/Kea2_python.egg-info/requires.txt

@@ -2,4 +2,4 @@ rtree>=1.3.0
 jinja2>=3.0.0
 uiautomator2>=3.3.3
 adbutils>=2.9.3
-setuptools>=75.3.2
+packaging>=25.0

kea2_python-0.3.3/README.md → kea2_python-0.3.5/PKG-INFO

@@ -1,3 +1,18 @@
+Metadata-Version: 2.4
+Name: Kea2-python
+Version: 0.3.5
+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
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rtree>=1.3.0
+Requires-Dist: jinja2>=3.0.0
+Requires-Dist: uiautomator2>=3.3.3
+Requires-Dist: adbutils>=2.9.3
+Requires-Dist: packaging>=25.0
+Dynamic: license-file
+
 
 
 [![PyPI](https://img.shields.io/pypi/v/kea2-python.svg)](https://pypi.python.org/pypi/kea2-python)
@@ -24,6 +39,7 @@ The group has reached its capacity. Please contact Xixian Liang at [xixian@stu.e
 <div align="center">
     <a href="https://en.wikipedia.org/wiki/Kea">Kea2's logo: A large parrot skilled in finding "bugs"</a>
 </div>
+</br>
 
 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*. 
 
@@ -95,9 +111,10 @@ Find Kea2's options by running
 kea2 -h
 ```
 
-> Upgrade Kea2 by `pip`:
-> 
-> `python3 -m pip install -U kea2-python`
+Upgrade Kea2 to its latest version if you already installed Kea2 before:
+```bash
+python3 -m pip install -U kea2-python
+```
 
 ## Quick Test
 
@@ -224,7 +241,15 @@ 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. 
+You can run this example by using the similar command line in Feature 2.
+
+## Test Reports（测试报告）
+
+Kea2 automatically generates comprehensive HTML test reports after each testing session.
+
+The reports support both single test runs and merged analysis of multiple test sessions, making it easy to track testing progress and identify issues.
+
+- [View detailed test report documentation](docs/test_report_introduction.md)
 
 ## Documentations（更多文档）
 
@@ -235,6 +260,7 @@ You can find the [user manual](docs/manual_en.md), which includes:
 - How to find and understand Kea2's testing results
 - How to [whitelist or blacklist](docs/blacklisting.md) specific activities, UI widgets and UI regions during fuzzing
 - [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)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -314,7 +340,7 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 [@Drifterpc]: https://github.com/Drifterpc
 [@tingsu]: https://github.com/tingsu
 
-[Zhendong Su](https://people.inf.ethz.ch/suz/), [Yiheng Xiong](https://xyiheng.github.io/), [Xiangchen Shen](https://xiangchenshen.github.io/), [Mengqian Xu](https://mengqianx.github.io/), [Haiying Sun](https://faculty.ecnu.edu.cn/_s43/shy/main.psp), [Jingling Sun](https://jinglingsun.github.io/), [Jue Wang](https://cv.juewang.info/) have also been actively participated in this project and contributed a lot!
+[Zhendong Su](https://people.inf.ethz.ch/suz/), [Yiheng Xiong](https://xyiheng.github.io/), [Xiangchen Shen](https://xiangchenshen.github.io/), [Mengqian Xu](https://mengqianx.github.io/), [Haiying Sun](https://faculty.ecnu.edu.cn/_s43/shy/main.psp), [Jingling Sun](https://jinglingsun.github.io/), [Jue Wang](https://cv.juewang.info/), [Geguang Pu]() have also been actively participated in this project and contributed a lot!
 
 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!
 

kea2_python-0.3.3/Kea2_python.egg-info/PKG-INFO → kea2_python-0.3.5/README.md

@@ -1,18 +1,3 @@
-Metadata-Version: 2.4
-Name: Kea2-python
-Version: 0.3.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
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: rtree>=1.3.0
-Requires-Dist: jinja2>=3.0.0
-Requires-Dist: uiautomator2>=3.3.3
-Requires-Dist: adbutils>=2.9.3
-Requires-Dist: setuptools>=75.3.2
-Dynamic: license-file
-
 
 
 [![PyPI](https://img.shields.io/pypi/v/kea2-python.svg)](https://pypi.python.org/pypi/kea2-python)
@@ -39,6 +24,7 @@ The group has reached its capacity. Please contact Xixian Liang at [xixian@stu.e
 <div align="center">
     <a href="https://en.wikipedia.org/wiki/Kea">Kea2's logo: A large parrot skilled in finding "bugs"</a>
 </div>
+</br>
 
 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*. 
 
@@ -110,9 +96,10 @@ Find Kea2's options by running
 kea2 -h
 ```
 
-> Upgrade Kea2 by `pip`:
-> 
-> `python3 -m pip install -U kea2-python`
+Upgrade Kea2 to its latest version if you already installed Kea2 before:
+```bash
+python3 -m pip install -U kea2-python
+```
 
 ## Quick Test
 
@@ -239,7 +226,15 @@ 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. 
+You can run this example by using the similar command line in Feature 2.
+
+## Test Reports（测试报告）
+
+Kea2 automatically generates comprehensive HTML test reports after each testing session.
+
+The reports support both single test runs and merged analysis of multiple test sessions, making it easy to track testing progress and identify issues.
+
+- [View detailed test report documentation](docs/test_report_introduction.md)
 
 ## Documentations（更多文档）
 
@@ -250,6 +245,7 @@ You can find the [user manual](docs/manual_en.md), which includes:
 - How to find and understand Kea2's testing results
 - How to [whitelist or blacklist](docs/blacklisting.md) specific activities, UI widgets and UI regions during fuzzing
 - [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)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -329,7 +325,7 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 [@Drifterpc]: https://github.com/Drifterpc
 [@tingsu]: https://github.com/tingsu
 
-[Zhendong Su](https://people.inf.ethz.ch/suz/), [Yiheng Xiong](https://xyiheng.github.io/), [Xiangchen Shen](https://xiangchenshen.github.io/), [Mengqian Xu](https://mengqianx.github.io/), [Haiying Sun](https://faculty.ecnu.edu.cn/_s43/shy/main.psp), [Jingling Sun](https://jinglingsun.github.io/), [Jue Wang](https://cv.juewang.info/) have also been actively participated in this project and contributed a lot!
+[Zhendong Su](https://people.inf.ethz.ch/suz/), [Yiheng Xiong](https://xyiheng.github.io/), [Xiangchen Shen](https://xiangchenshen.github.io/), [Mengqian Xu](https://mengqianx.github.io/), [Haiying Sun](https://faculty.ecnu.edu.cn/_s43/shy/main.psp), [Jingling Sun](https://jinglingsun.github.io/), [Jue Wang](https://cv.juewang.info/), [Geguang Pu]() have also been actively participated in this project and contributed a lot!
 
 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!
 

{kea2_python-0.3.3 → kea2_python-0.3.5}/kea2/assets/quicktest.py

@@ -52,7 +52,7 @@ class Omni_Notes_Sample(unittest.TestCase):
         assert self.d(resourceId="it.feio.android.omninotes.alpha:id/search_src_text").exists()
 
 
-URL = "https://raw.githubusercontent.com/ecnusse/Kea2/refs/heads/dev_test_hidden_algorithm/omninotes.apk"
+URL = "https://github.com/federicoiosue/Omni-Notes/releases/download/6.2.0_alpha/OmniNotes-alphaRelease-6.2.0.apk"
 PACKAGE_NAME = "it.feio.android.omninotes.alpha"
 FILE_NAME = "omninotes.apk"
 

{kea2_python-0.3.3 → kea2_python-0.3.5}/kea2/fastbotManager.py

@@ -2,8 +2,7 @@ from retry import retry
 from retry.api import retry_call
 from dataclasses import asdict
 import requests
-from time import sleep
-from pkg_resources import parse_version
+from packaging.version import parse as parse_version
 
 from uiautomator2.core import HTTPResponse, _http_request
 from kea2.adbUtils import ADBDevice, ADBStreamShell_V2

{kea2_python-0.3.3 → kea2_python-0.3.5}/kea2/templates/bug_report_template.html

@@ -229,14 +229,14 @@
         }
 
         .table-custom tr.collapse pre {
-            max-height: 300px;
-            overflow-y: auto;
             font-size: 0.85rem;
             line-height: 1.4;
             background-color: #f8f9fa;
             border: 1px solid #e9ecef;
             border-radius: 4px;
             padding: 0.75rem;
+            white-space: pre-wrap;
+            word-wrap: break-word;
         }
 
         .table-custom tr.collapse details {

{kea2_python-0.3.3 → kea2_python-0.3.5}/kea2/u2Driver.py

@@ -220,7 +220,7 @@ class StaticXpathUiObject(u2.xpath.XPathSelector):
         source = self.session.get_page_source()
         return len(self.selector.all(source)) > 0
 
-    def __and__(self, value) -> 'StaticXpathUiObjectr':
+    def __and__(self, value) -> 'StaticXpathUiObject':
         s = u2.xpath.XPathSelector(self.selector)
         s._next_xpath = u2.xpath.XPathSelector.create(value.selector)
         s._operator = u2.xpath.Operator.AND
@@ -288,7 +288,7 @@ class StaticXpathUiObject(u2.xpath.XPathSelector):
         self.selector = new
         return self
 
-    def get(self, timeout=None) -> "XMLElement":
+    def get(self, timeout=None) -> "u2.xpath.XMLElement":
         """
         Get first matched element
 
@@ -343,7 +343,15 @@ class _HindenWidgetFilter:
         self._nodes = []
 
         self.idx = rtree.index.Index()
-        self.set_covered_attr(root)
+        try:
+            self.set_covered_attr(root)
+        except Exception as e:
+            import traceback, uuid
+            traceback.print_exc()
+            logger.error(f"Error in setting covered widgets")
+            with open(f"kea2_error_tree_{uuid.uuid4().hex}.xml", "wb") as f:
+                xml_bytes = etree.tostring(root, pretty_print=True, encoding="utf-8", xml_declaration=True)
+                f.write(xml_bytes)
 
         # xml_bytes = etree.tostring(root, pretty_print=True, encoding="utf-8", xml_declaration=True)
         # with open("filtered_tree.xml", "wb") as f:

{kea2_python-0.3.3 → kea2_python-0.3.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Kea2-python"
-version = "0.3.3"
+version = "0.3.5"
 description = "A python library for supporting and customizing automated UI testing for mobile apps"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -9,7 +9,7 @@ dependencies = [
     "jinja2>=3.0.0",
     "uiautomator2>=3.3.3",
     "adbutils>=2.9.3",
-    "setuptools>=75.3.2",
+    "packaging>=25.0",
 ]
 authors = [
     { name = "Xixian Liang", email = "xixian@stu.ecnu.edu.cn" }