Kea2-python 0.3.4__py3-none-any.whl → 0.3.6__py3-none-any.whl

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/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/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/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/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.dist-info → kea2_python-0.3.6.dist-info}/METADATA

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

@@ -1,11 +1,11 @@
 kea2/__init__.py,sha256=JFJjqgf5KB4bXUFQ3upkEug0cFMFIk9p3OHV9vzulHw,75
 kea2/absDriver.py,sha256=NzmsLs1Ojz-yEXctGAqj7aKBwAQW19zd83l65RABCe8,1288
 kea2/adbUtils.py,sha256=zi0T0_g44xZQZe3XYzBsuh7VTHpdZ4dd6yKi-p7BTYI,19939
-kea2/bug_report_generator.py,sha256=gASx3AasGWAufb4A8T4dv0-22knu7h24Z9M9NBSzy24,44107
+kea2/bug_report_generator.py,sha256=swKg2bbfhtpSX6VfqgnsqAXkYr6WNJ5G7wnXp67IlQ8,44111
 kea2/cli.py,sha256=MccJhY8VPZa1rMAbirm3dmbzDx1lf2w3zrpF1ZUq2m0,6481
-kea2/fastbotManager.py,sha256=pGuAH-X26nOy2Qj6Hg5aoMxJx4KfsRk6bj6nhcPENGc,8158
-kea2/keaUtils.py,sha256=zfTmG23KmWmf5b71rrPTxwnpZhZ6gdlLD9eIhjAZv4Y,25834
-kea2/kea_launcher.py,sha256=M9TMCdgkteCWO5iBxJRDRvb7dikanoPf3jdicCEurU8,6268
+kea2/fastbotManager.py,sha256=HaCL-cd7IKhk9Stp-3wx_U_4LnVYLG8UOIF5ih9iqnI,8263
+kea2/keaUtils.py,sha256=pWxJVbXRHQdXC-Ob8aYDwEjGBF72DuBEPNekDJBlo5M,25884
+kea2/kea_launcher.py,sha256=LpidhW90nFhCKh5bEMfUH_LkCuxa66XUqJAr_VoBerc,6734
 kea2/logWatcher.py,sha256=Dp6OzvLSuWYw0AqdcPDqfotaRZQgpF8S49LInGsAWp8,2599
 kea2/report_merger.py,sha256=0b-g59pdrsJDwVNek02ouu1utuu_Sd_1oEMQa4e23xI,24884
 kea2/resultSyncer.py,sha256=9kb3H0Innwj7oPboDDTf97nbjam7EP6HYxywR9B8SvM,2437
@@ -14,7 +14,7 @@ kea2/utils.py,sha256=x0VTGweW-XShG9MuwZDMP13SBg8jQXYa7e0AXdwYX38,3270
 kea2/assets/fastbot-thirdpart.jar,sha256=0SZ_OoZFWDGMnazgXKceHgKvXdUDoIa3Gb2bcifaikk,85664
 kea2/assets/framework.jar,sha256=rTluOJJKj2DFwh7ascXso1udYdWv00BxBwSQ3Vmv-fw,1149240
 kea2/assets/kea2-thirdpart.jar,sha256=HYdtG2gqDLuLb72dpK3lX-Y6QUNTrJ-bfQopU5aWpfo,359346
-kea2/assets/monkeyq.jar,sha256=4_WLifmU9q5noqMofZWW15Gh8kcuVouNrI-Ca5_g-BM,113104
+kea2/assets/monkeyq.jar,sha256=fYC4ynmJcZ5HFQ9zpHSF6CrGLcnldasZfWGtcJ9VgZc,113488
 kea2/assets/quicktest.py,sha256=BgTul5jfSBCh6hVSMRmur61M6_KNTkzIT6Bdff72TE4,3009
 kea2/assets/fastbot_configs/abl.strings,sha256=Rn8_YEbVGOJqndIY_-kWnR5NaoFI-cuB-ij10Ddhl90,75
 kea2/assets/fastbot_configs/awl.strings,sha256=-j4980GoWQxGOM9ijAwXPQmziCwFBZJFmuiv2tOEaYI,101
@@ -28,11 +28,11 @@ kea2/assets/fastbot_libs/arm64-v8a/libfastbot_native.so,sha256=tAFrG73pJi7XakRxS
 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/templates/bug_report_template.html,sha256=amZUwlJSg1jzpb1-RB0W6fzwXYZBQK-4SHdhj6LYSbo,152983
+kea2/templates/bug_report_template.html,sha256=SkqssIKPOEP_3CjRZuxXEnANVnefg_fYNi97guDDNh8,152992
 kea2/templates/merged_bug_report_template.html,sha256=iWoXxvN3YQzCabi7BTP4sGl2F6LQrR3_HcG0aD3fHtk,135668
-kea2_python-0.3.4.dist-info/licenses/LICENSE,sha256=nM9PPjcsXVo5SzNsjRqWgA-gdJlwqZZcRDSC6Qf6bVE,2034
-kea2_python-0.3.4.dist-info/METADATA,sha256=owA_RN6ZzlDdCqzVoNoAbsUcvpXNXixhFUiAwZpjKHQ,18983
-kea2_python-0.3.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-kea2_python-0.3.4.dist-info/entry_points.txt,sha256=mFX06TyxXiUAJQ6JZn8QHzfn8n5R8_KJ5W-pTm_fRCA,39
-kea2_python-0.3.4.dist-info/top_level.txt,sha256=TsgNH4PQoNOVhegpO7AcjutMVWp6Z4KDL1pBH9FnMmk,5
-kea2_python-0.3.4.dist-info/RECORD,,
+kea2_python-0.3.6.dist-info/licenses/LICENSE,sha256=nM9PPjcsXVo5SzNsjRqWgA-gdJlwqZZcRDSC6Qf6bVE,2034
+kea2_python-0.3.6.dist-info/METADATA,sha256=noBg-rOuzQQ_Gtw9mdLCN_yT_Ua7k7lHdiDSt_xHKOE,19300
+kea2_python-0.3.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+kea2_python-0.3.6.dist-info/entry_points.txt,sha256=mFX06TyxXiUAJQ6JZn8QHzfn8n5R8_KJ5W-pTm_fRCA,39
+kea2_python-0.3.6.dist-info/top_level.txt,sha256=TsgNH4PQoNOVhegpO7AcjutMVWp6Z4KDL1pBH9FnMmk,5
+kea2_python-0.3.6.dist-info/RECORD,,