Kea2-python 0.3.4__tar.gz → 0.3.6__tar.gz

{kea2_python-0.3.4 → kea2_python-0.3.6}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.3.4
+Version: 0.3.6
 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
 
 
@@ -260,6 +260,8 @@ 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)
+- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/?vd_source=ab7968b8d764666d85d24af49d9b8891)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -339,7 +341,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.4 → kea2_python-0.3.6}/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.4 → kea2_python-0.3.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.3.4
+Version: 0.3.6
 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
 
 
@@ -260,6 +260,8 @@ 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)
+- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/?vd_source=ab7968b8d764666d85d24af49d9b8891)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -339,7 +341,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.4 → kea2_python-0.3.6}/README.md

@@ -245,6 +245,8 @@ 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)
+- [Kea2 分享交流会 (2025.09, bilibili 录播)](https://www.bilibili.com/video/BV1CZYNz9Ei5/?vd_source=ab7968b8d764666d85d24af49d9b8891)
 
 Some blogs on Kea/Kea2 (in Chinese):
 - [别再苦哈哈写测试脚本了，生成它们吧！(一)](https://mp.weixin.qq.com/s/R2kLCkXpDjpa8wCX4Eidtg)
@@ -324,7 +326,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.4 → kea2_python-0.3.6}/kea2/bug_report_generator.py

@@ -538,7 +538,7 @@ class BugReportGenerator:
         timestamp = datetime.now().strftime("%Y-%m-%d %H:%M:%S")
 
         # Ensure coverage_trend has data
-        if not data["coverage_trend"]:
+        if not data.get("coverage_trend"):
             logger.warning("No coverage trend data")
             # Use the same field names as in coverage.log file
             data["coverage_trend"] = [{"stepsCount": 0, "coverage": 0, "testedActivitiesCount": 0}]

{kea2_python-0.3.4 → kea2_python-0.3.6}/kea2/fastbotManager.py

@@ -2,13 +2,12 @@ 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
 from pathlib import Path
-from kea2.utils import getLogger
+from kea2.utils import getLogger, getProjectRoot
 
 
 from typing import IO, TYPE_CHECKING, Dict
@@ -71,14 +70,15 @@ class FastbotManager:
             "/data/local/tmp/x86_64/libfastbot_native.so",
         )
 
+        cwd = getProjectRoot()
         whitelist = self.options.act_whitelist_file
         blacklist = self.options.act_blacklist_file
         if bool(whitelist) ^ bool(blacklist):
             if whitelist:
-                file_to_push = cur_dir.parent / 'configs' / 'awl.strings'
+                file_to_push = cwd / 'configs' / 'awl.strings'
                 remote_path = whitelist
             else:
-                file_to_push = cur_dir.parent / 'configs' / 'abl.strings'
+                file_to_push = cwd / 'configs' / 'abl.strings'
                 remote_path = blacklist
 
             self.dev.sync.push(
@@ -198,6 +198,9 @@ class FastbotManager:
 
         shell_command += ["-v", "-v", "-v"]
 
+        if self.options.extra_args:
+            shell_command += self.options.extra_args
+
         full_cmd = ["adb"] + (["-s", self.options.serial] if self.options.serial else []) + ["shell"] + shell_command
 
 

{kea2_python-0.3.4 → kea2_python-0.3.6}/kea2/keaUtils.py

@@ -136,6 +136,8 @@ class Options:
     act_whitelist_file: str = None
     # Activity BlackList File
     act_blacklist_file: str = None
+    # Extra args
+    extra_args: List[str] = None
 
     def __setattr__(self, name, value):
         if value is None:

{kea2_python-0.3.4 → kea2_python-0.3.6}/kea2/kea_launcher.py

@@ -148,8 +148,8 @@ def _set_runner_parser(subparsers: "argparse._SubParsersAction[argparse.Argument
 def unittest_info_logger(args):
     if args.agent == "native":
         print("[Warning] Property not availble in native agent.", flush=True)
-    if args.extra and args.extra[0] == "unittest":
-        print("Captured unittest args:", args.extra, flush=True)
+    if args.unittest_args:
+        print("Captured unittest args:", args.unittest_args, flush=True)
 
 
 def driver_info_logger(args):
@@ -189,7 +189,13 @@ def _sanitize_args(args):
             args.driver_name = "d"
         else:
             raise ValueError("--driver-name should be specified when customizing script in --agent u2")
-
+    if args.extra:
+        args.extra = args.extra[1:] if args.extra[0] == "--" else args.extra
+        unittest_index = args.extra.index("unittest") if "unittest" in args.extra else -1
+        if unittest_index != -1:
+            unittest_args = args.extra[unittest_index+1:]
+            setattr(args, "unittest_args", unittest_args)
+            args.extra = args.extra[:unittest_index]
 
 def run(args=None):
     if args is None:
@@ -197,6 +203,9 @@ def run(args=None):
     _sanitize_args(args)
     driver_info_logger(args)
     unittest_info_logger(args)
+    if args.extra:
+        print("[Warning] Captured extra args:", args.extra, flush=True)
+        print("The extra args will be passed into fastbot launcher.", flush=True)
 
     from kea2 import KeaTestRunner, Options
     from kea2.u2Driver import U2Driver
@@ -214,15 +223,13 @@ def run(args=None):
         profile_period=args.profile_period,
         take_screenshots=args.take_screenshots,
         device_output_root=args.device_output_root,
-        act_whitelist_file = args.act_whitelist_file,
-        act_blacklist_file=args.act_blacklist_file
+        act_whitelist_file=args.act_whitelist_file,
+        act_blacklist_file=args.act_blacklist_file,
+        extra_args=args.extra,
     )
 
     KeaTestRunner.setOptions(options)
-    unittest_args = []
-    if args.extra and args.extra[0] == "unittest":
-        unittest_args = args.extra[1:]
-    sys.argv = ["python3 -m unittest"] + unittest_args
+    sys.argv = ["python3 -m unittest"] + args.unittest_args
 
     unittest.main(module=None, testRunner=KeaTestRunner)
 

{kea2_python-0.3.4 → kea2_python-0.3.6}/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.4 → kea2_python-0.3.6}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Kea2-python"
-version = "0.3.4"
+version = "0.3.6"
 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" }