Kea2-python 0.1.1__tar.gz → 0.1.3__tar.gz

{kea2_python-0.1.1 → kea2_python-0.1.3}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.1.1
+Version: 0.1.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
@@ -17,8 +17,9 @@ Dynamic: license-file
 [![PyPI Downloads](https://static.pepy.tech/badge/kea2-python)](https://pepy.tech/projects/kea2-python)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
 
+
 <div>
-    <img src="https://github.com/user-attachments/assets/1a64635b-a8f2-40f1-8f16-55e47b1d74e7" style="border-radius: 14px; width: 20%; height: 20%;"/> 
+    <img src="https://github.com/user-attachments/assets/aa5839fc-4542-46f6-918b-c9f891356c84" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
 ## About
@@ -67,7 +68,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`:
@@ -251,4 +252,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.1 → kea2_python-0.1.3}/Kea2_python.egg-info/SOURCES.txt

@@ -21,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
@@ -35,4 +36,5 @@ 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/templates/bug_report_template.html
+kea2/templates/bug_report_template.html
+tests/test_u2Selector.py

{kea2_python-0.1.1 → kea2_python-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.1.1
+Version: 0.1.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
@@ -17,8 +17,9 @@ Dynamic: license-file
 [![PyPI Downloads](https://static.pepy.tech/badge/kea2-python)](https://pepy.tech/projects/kea2-python)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
 
+
 <div>
-    <img src="https://github.com/user-attachments/assets/1a64635b-a8f2-40f1-8f16-55e47b1d74e7" style="border-radius: 14px; width: 20%; height: 20%;"/> 
+    <img src="https://github.com/user-attachments/assets/aa5839fc-4542-46f6-918b-c9f891356c84" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
 ## About
@@ -67,7 +68,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`:
@@ -251,4 +252,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.1 → kea2_python-0.1.3}/README.md

@@ -4,8 +4,9 @@
 [![PyPI Downloads](https://static.pepy.tech/badge/kea2-python)](https://pepy.tech/projects/kea2-python)
 ![Python](https://img.shields.io/badge/python-3.8%2B-blue)
 
+
 <div>
-    <img src="https://github.com/user-attachments/assets/1a64635b-a8f2-40f1-8f16-55e47b1d74e7" style="border-radius: 14px; width: 20%; height: 20%;"/> 
+    <img src="https://github.com/user-attachments/assets/aa5839fc-4542-46f6-918b-c9f891356c84" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
 ## About
@@ -54,7 +55,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`:
@@ -238,4 +239,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.1 → kea2_python-0.1.3}/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

{kea2_python-0.1.1 → kea2_python-0.1.3}/kea2/bug_report_generator.py

@@ -68,7 +68,7 @@ class BugReportGenerator:
             with open(report_path, "w", encoding="utf-8") as f:
                 f.write(html_content)
 
-            logger.debug(f"Bug report generated: {report_path}")
+            logger.info(f"Bug report saved to: {report_path}")
 
         except Exception as e:
             logger.error(f"Error generating bug report: {e}")
@@ -323,6 +323,8 @@ class BugReportGenerator:
                 if lines:
                     # Collect coverage trend data
                     for line in lines:
+                        if not line.strip():
+                            continue
                         try:
                             coverage_data = json.loads(line)
                             data["coverage_trend"].append({

{kea2_python-0.1.1 → kea2_python-0.1.3}/kea2/fastbotManager.py

@@ -42,6 +42,11 @@ class FastbotManager:
             "/sdcard/fastbot-thirdpart.jar",
             device=options.serial,
         )
+        push_file(
+            Path.joinpath(cur_dir, "assets/kea2-thirdpart.jar"),
+            "/sdcard/kea2-thirdpart.jar",
+            device=options.serial,
+        )
         push_file(
             Path.joinpath(cur_dir, "assets/framework.jar"), 
             "/sdcard/framework.jar",
@@ -91,7 +96,12 @@ class FastbotManager:
 
     def _startFastbotService(self) -> threading.Thread:
         shell_command = [
-            "CLASSPATH=/sdcard/monkeyq.jar:/sdcard/framework.jar:/sdcard/fastbot-thirdpart.jar",
+            "CLASSPATH="
+            "/sdcard/monkeyq.jar:"
+            "/sdcard/framework.jar:"
+            "/sdcard/fastbot-thirdpart.jar:"
+            "/sdcard/kea2-thirdpart.jar",
+            
             "exec", "app_process",
             "/system/bin", "com.android.commands.monkey.Monkey",
             "-p", *self.options.packageNames,
@@ -126,7 +136,7 @@ class FastbotManager:
         self.return_code = proc.wait()
         f.close()
         if self.return_code != 0:
-            raise RuntimeError(f"Fastbot Error: Terminated with [code {self.return_code}]")
+            raise RuntimeError(f"Fastbot Error: Terminated with [code {self.return_code}] See {self.log_file} for details.")
 
     def get_return_code(self):
         if self.thread:

{kea2_python-0.1.1 → kea2_python-0.1.3}/kea2/keaUtils.py

@@ -14,7 +14,7 @@ from .bug_report_generator import BugReportGenerator
 from .resultSyncer import ResultSyncer
 from .logWatcher import LogWatcher
 from .utils import TimeStamp, getProjectRoot, getLogger
-from .u2Driver import StaticU2UiObject, selector_to_xpath
+from .u2Driver import StaticU2UiObject
 from .fastbotManager import FastbotManager
 import uiautomator2 as u2
 import types
@@ -126,6 +126,8 @@ class Options:
     profile_period: int = 25
     # take screenshots for every step
     take_screenshots: bool = False
+    # The root of output dir on device
+    device_output_root: str = "/sdcard"
     # the debug mode
     debug: bool = False
 
@@ -135,10 +137,18 @@ class Options:
         super().__setattr__(name, value)
 
     def __post_init__(self):
+        import logging
+        logging.basicConfig(level=logging.DEBUG if self.debug else logging.INFO)
         if self.serial and self.Driver:
             self.Driver.setDeviceSerial(self.serial)
         global LOGFILE, RESFILE, STAMP
         if self.log_stamp:
+            illegal_chars = ['/', '\\', ':', '*', '?', '"', '<', '>', '|', '\n', '\r', '\t', '\0']
+            for char in illegal_chars:
+                if char in self.log_stamp:
+                    raise ValueError(
+                        f"char: `{char}` is illegal in --log-stamp. current stamp: {self.log_stamp}"
+                    )
             STAMP = self.log_stamp
         self.output_dir = Path(self.output_dir).absolute() / f"res_{STAMP}"
         LOGFILE = f"fastbot_{STAMP}.log"
@@ -324,8 +334,9 @@ class KeaTestRunner(TextTestRunner):
                         xml_raw = self.stepMonkey()
                         propsSatisfiedPrecond = self.getValidProperties(xml_raw, result)
                     except requests.ConnectionError:
+                        logger.info("Connection refused by remote.")
                         if fb.get_return_code() == 0:
-                            logger.info("[INFO] Exploration times up (--running-minutes).")
+                            logger.info("Exploration times up (--running-minutes).")
                             end_by_remote = True
                             break
                         raise RuntimeError("Fastbot Aborted.")
@@ -333,8 +344,6 @@ class KeaTestRunner(TextTestRunner):
                     if self.options.profile_period and self.stepsCount % self.options.profile_period == 0:
                         resultSyncer.sync_event.set()
 
-                    print(f"{len(propsSatisfiedPrecond)} precond satisfied.", flush=True)
-
                     # Go to the next round if no precond satisfied
                     if len(propsSatisfiedPrecond) == 0:
                         continue
@@ -467,18 +476,25 @@ class KeaTestRunner(TextTestRunner):
                     if not precond(test):
                         valid = False
                         break
+                except u2.UiObjectNotFoundError as e:
+                    valid = False
+                    break
                 except Exception as e:
-                    print(f"[ERROR] Error when checking precond: {getFullPropName(test)}", flush=True)
+                    logger.error(f"Error when checking precond: {getFullPropName(test)}")
                     traceback.print_exc()
                     valid = False
                     break
             # if all the precond passed. make it the candidate prop.
             if valid:
-                logger.debug(f"precond satisfied: {getFullPropName(test)}")
                 if result.getExcuted(test) >= getattr(prop, MAX_TRIES_MARKER, float("inf")):
-                    logger.debug(f"{getFullPropName(test)} has reached its max_tries. Skip.")
+                    print(f"{getFullPropName(test)} has reached its max_tries. Skip.", flush=True)
                     continue
                 validProps[propName] = test
+        
+        print(f"{len(validProps)} precond satisfied.", flush=True)
+        if len(validProps) > 0:
+            print("[INFO] Valid properties:",flush=True)
+            print("\n".join([f'                - {getFullPropName(p)}' for p in validProps.values()]), flush=True)
         return validProps
 
     def _logScript(self, execution_info:Dict):
@@ -495,7 +511,8 @@ class KeaTestRunner(TextTestRunner):
         URL = f"http://localhost:{self.scriptDriver.lport}/init"
         data = {
             "takeScreenshots": self.options.take_screenshots,
-            "Stamp": STAMP
+            "Stamp": STAMP,
+            "deviceOutputRoot": self.options.device_output_root,
         }
         print(f"[INFO] Init fastbot: {data}", flush=True)
         r = requests.post(
@@ -505,7 +522,7 @@ class KeaTestRunner(TextTestRunner):
         res = r.content.decode(encoding="utf-8")
         import re
         self.device_output_dir = re.match(r"outputDir:(.+)", res).group(1)
-        print(f"[INFO] Fastbot initiated. Device outputDir: {res}", flush=True)
+        print(f"[INFO] Fastbot initiated. outputDir: {res}", flush=True)
 
     def collectAllProperties(self, test: TestSuite):
         """collect all the properties to prepare for PBT
@@ -607,60 +624,72 @@ class KeaTestRunner(TextTestRunner):
            """
         def _get_xpath_widgets(func):
             blocked_set = set()
-            try:
-                script_driver = self.options.Driver.getScriptDriver()
-                preconds = getattr(func, PRECONDITIONS_MARKER, [])
-                if all(precond(script_driver) for precond in preconds):
+            script_driver = self.options.Driver.getScriptDriver()
+            preconds = getattr(func, PRECONDITIONS_MARKER, [])
+
+            def preconds_pass(preconds):
+                try:
+                    return all(precond(script_driver) for precond in preconds)
+                except u2.UiObjectNotFoundError as e:
+                    return False
+                except Exception as e:
+                    logger.error(f"Error processing precond. Check if precond: {e}")
+                    traceback.print_exc()
+                    return False
+
+            if preconds_pass(preconds):
+                try:
                     _widgets = func(self.options.Driver.getStaticChecker())
                     _widgets = _widgets if isinstance(_widgets, list) else [_widgets]
                     for w in _widgets:
                         if isinstance(w, StaticU2UiObject):
-                            xpath = selector_to_xpath(w.selector, True)
-                            blocked_set.add(xpath)
+                            xpath = w.selector_to_xpath(w.selector)
+                            if xpath != '//error':
+                                blocked_set.add(xpath)
                         elif isinstance(w, u2.xpath.XPathSelector):
                             xpath = w._parent.xpath
                             blocked_set.add(xpath)
                         else:
-                            logger.warning(f"{w} Not supported")
-            except Exception as e:
-                logger.error(f"Error processing blocked widgets: {e}")
-                traceback.print_exc()
+                            logger.error(f"block widget defined in {func.__name__} Not supported.")
+                except Exception as e:
+                    logger.error(f"Error processing blocked widgets in: {func}")
+                    logger.error(e)
+                    traceback.print_exc()
             return blocked_set
 
-        res = {
+        result = {
             "widgets": set(),
             "trees": set()
         }
 
-
         for func in self._blockWidgetFuncs["widgets"]:
             widgets = _get_xpath_widgets(func)
-            res["widgets"].update(widgets)
-
+            result["widgets"].update(widgets)
 
         for func in self._blockWidgetFuncs["trees"]:
             trees = _get_xpath_widgets(func)
-            res["trees"].update(trees)
+            result["trees"].update(trees)
 
+        result["widgets"] = list(result["widgets"] - result["trees"])
+        result["trees"] = list(result["trees"])
 
-        res["widgets"] = list(res["widgets"] - res["trees"])
-        res["trees"] = list(res["trees"])
-
-        return res
+        return result
 
 
     def __del__(self):
         """tearDown method. Cleanup the env.
         """
-        try:
-            logger.debug("Generating test bug report")
-            report_generator = BugReportGenerator(self.options.output_dir)
-            report_generator.generate_report()
-        except Exception as e:
-            logger.error(f"Error generating bug report: {e}", flush=True)
         try:
             self.stopMonkey()
         except Exception as e:
             pass
+
         if self.options.Driver:
             self.options.Driver.tearDown()
+
+        try:
+            logger.info("Generating bug report")
+            report_generator = BugReportGenerator(self.options.output_dir)
+            report_generator.generate_report()
+        except Exception as e:
+            logger.error(f"Error generating bug report: {e}", flush=True)

{kea2_python-0.1.1 → kea2_python-0.1.3}/kea2/kea_launcher.py

@@ -91,6 +91,15 @@ def _set_runner_parser(subparsers: "argparse._SubParsersAction[argparse.Argument
         default=25,
         help="Steps to profile the testing statistics.",
     )
+
+    parser.add_argument(
+        "--device-output-root",
+        dest="device_output_root",
+        type=str,
+        required=False,
+        default="/sdcard",
+        help="The root of device output dir. (Saving tmp log files and screenshots)",
+    )
     
     parser.add_argument(
         "--take-screenshots",
@@ -171,6 +180,7 @@ def run(args=None):
         log_stamp=args.log_stamp,
         profile_period=args.profile_period,
         take_screenshots=args.take_screenshots,
+        device_output_root=args.device_output_root
     )
 
     KeaTestRunner.setOptions(options)

{kea2_python-0.1.1 → kea2_python-0.1.3}/kea2/u2Driver.py

@@ -100,39 +100,105 @@ class StaticU2UiObject(u2.UiObject):
             return filterDict[originKey]
         return originKey
 
-    def _getXPath(self, kwargs: Dict[str, str]):
+    def selector_to_xpath(self, selector: u2.Selector, is_initial: bool = True) -> str:
+        """
+            Convert a u2 Selector into an XPath expression compatible with Java Android UI controls.
 
-        def filter_selectors(kwargs: Dict[str, str]):
-            """
-            filter the selector
-            """
-            new_kwargs = dict()
-            SPECIAL_KEY = {"mask", "childOrSibling", "childOrSiblingSelector"}
-            for key, val in kwargs.items():
-                if key in SPECIAL_KEY:
-                    continue
-                key = self._transferU2Keys(key)
-                new_kwargs[key] = val
-            return new_kwargs
+            Args:
+                selector (u2.Selector): A u2 Selector object
+                is_initial (bool): Whether it is the initial node, defaults to True
 
-        kwargs = filter_selectors(kwargs)
+            Returns:
+                str: The corresponding XPath expression
+            """
+        try:
 
-        attrLocs = [
-            f"[@{k}='{v}']" for k, v in kwargs.items()
-        ]
-        xpath = f".//node{''.join(attrLocs)}"
-        return xpath
+            xpath = ".//node" if is_initial else "node"
+
+            conditions = []
+
+            if "className" in selector:
+                conditions.insert(0, f"[@class='{selector['className']}']")
+
+            if "text" in selector:
+                conditions.append(f"[@text='{selector['text']}']")
+            elif "textContains" in selector:
+                conditions.append(f"[contains(@text, '{selector['textContains']}')]")
+            elif "textStartsWith" in selector:
+                conditions.append(f"[starts-with(@text, '{selector['textStartsWith']}')]")
+            elif "textMatches" in selector:
+                raise NotImplementedError("'textMatches' syntax is not supported")
+
+            if "description" in selector:
+                conditions.append(f"[@content-desc='{selector['description']}']")
+            elif "descriptionContains" in selector:
+                conditions.append(f"[contains(@content-desc, '{selector['descriptionContains']}')]")
+            elif "descriptionStartsWith" in selector:
+                conditions.append(f"[starts-with(@content-desc, '{selector['descriptionStartsWith']}')]")
+            elif "descriptionMatches" in selector:
+                raise NotImplementedError("'descriptionMatches' syntax is not supported")
+
+            if "packageName" in selector:
+                conditions.append(f"[@package='{selector['packageName']}']")
+            elif "packageNameMatches" in selector:
+                raise NotImplementedError("'packageNameMatches' syntax is not supported")
+
+            if "resourceId" in selector:
+                conditions.append(f"[@resource-id='{selector['resourceId']}']")
+            elif "resourceIdMatches" in selector:
+                raise NotImplementedError("'resourceIdMatches' syntax is not supported")
+
+            bool_props = ["checkable", "checked", "clickable", "longClickable", "scrollable", "enabled", "focusable",
+                          "focused", "selected", "covered"]
+
+            def str_to_bool(value):
+                """Convert string 'true'/'false' to boolean, or return original value if already boolean"""
+                if isinstance(value, str):
+                    return value.lower() == "true"
+                return bool(value)
+
+            for prop in bool_props:
+                if prop in selector:
+                    bool_value = str_to_bool(selector[prop])
+                    value = "true" if bool_value else "false"
+                    conditions.append(f"[@{prop}='{value}']")
+
+            if "index" in selector:
+                conditions.append(f"[@index='{selector['index']}']")
+
+            xpath += "".join(conditions)
+
+            if "childOrSibling" in selector and selector["childOrSibling"]:
+                for i, relation in enumerate(selector["childOrSibling"]):
+                    sub_selector = selector["childOrSiblingSelector"][i]
+                    sub_xpath = self.selector_to_xpath(sub_selector, False)
+
+                    if relation == "child":
+                        xpath += f"//{sub_xpath}"
+                    elif relation == "sibling":
+                        cur_root = xpath
+                        following_sibling = cur_root + f"/following-sibling::{sub_xpath}"
+                        preceding_sibling = cur_root + f"/preceding-sibling::{sub_xpath}"
+                        xpath = f"({following_sibling} | {preceding_sibling})"
+            if "instance" in selector:
+                xpath = f"({xpath})[{selector['instance'] + 1}]"
+
+            return xpath
+
+        except Exception as e:
+            print(f"Error occurred during selector conversion: {e}")
+            return "//error"
 
 
     @property
     def exists(self):
-        dict.update(self.selector, {"covered": "false"})
-        xpath = self._getXPath(self.selector)
+        set_covered_to_deepest_node(self.selector)
+        xpath = self.selector_to_xpath(self.selector)
         matched_widgets = self.session.xml.xpath(xpath)
         return bool(matched_widgets)
 
     def __len__(self):
-        xpath = self._getXPath(self.selector)
+        xpath = self.selector_to_xpath(self.selector)
         matched_widgets = self.session.xml.xpath(xpath)
         return len(matched_widgets)
     
@@ -141,6 +207,9 @@ class StaticU2UiObject(u2.UiObject):
     
     def sibling(self, **kwargs):
         return StaticU2UiObject(self.session, self.selector.clone().sibling(**kwargs))
+    
+    def __getattr__(self, attr):
+        return getattr(super(), attr)
 
 
 def _get_bounds(raw_bounds):
@@ -227,7 +296,9 @@ class U2StaticDevice(u2.Device):
         self._script_driver = script_driver
 
     def __call__(self, **kwargs):
-        return StaticU2UiObject(session=self, selector=u2.Selector(**kwargs))
+        ui = StaticU2UiObject(session=self, selector=u2.Selector(**kwargs))
+        ui.jsonrpc = self._script_driver.jsonrpc
+        return ui
 
     @property
     def xpath(self) -> u2.xpath.XPathEntry:
@@ -274,7 +345,12 @@ class U2StaticChecker(AbstractStaticChecker):
     def setHierarchy(self, hierarchy: str):
         if hierarchy is None:
             return
-        self.d.xml = etree.fromstring(hierarchy.encode("utf-8"))
+        if isinstance(hierarchy, str):
+            self.d.xml = etree.fromstring(hierarchy.encode("utf-8"))
+        elif isinstance(hierarchy, etree._Element):
+            self.d.xml = hierarchy
+        elif isinstance(hierarchy, etree._ElementTree):
+            self.d.xml = hierarchy.getroot()
         _HindenWidgetFilter(self.d.xml)
 
     def getInstance(self, hierarchy: str=None):
@@ -330,90 +406,6 @@ def forward_port(self, remote: Union[int, str]) -> int:
         logger.debug(f"forwading port: tcp:{local_port} -> {remote}")
         return local_port
 
-
-def selector_to_xpath(selector: u2.Selector, is_initial: bool = True) -> str:
-    """
-    Convert a u2 Selector into an XPath expression compatible with Java Android UI controls.
-
-    Args:
-        selector (u2.Selector): A u2 Selector object
-        is_initial (bool): Whether it is the initial node, defaults to True
-
-    Returns:
-        str: The corresponding XPath expression
-    """
-    try:
-        if is_initial:
-            xpath = ".//node"
-        else:
-            xpath = "node"
-
-        conditions = []
-
-        if "className" in selector:
-            conditions.insert(0, f"[@class='{selector['className']}']")  # 将 className 条件放在前面
-
-        if "text" in selector:
-            conditions.append(f"[@text='{selector['text']}']")
-        elif "textContains" in selector:
-            conditions.append(f"[contains(@text, '{selector['textContains']}')]")
-        elif "textMatches" in selector:
-            conditions.append(f"[re:match(@text, '{selector['textMatches']}')]")
-        elif "textStartsWith" in selector:
-            conditions.append(f"[starts-with(@text, '{selector['textStartsWith']}')]")
-
-        if "description" in selector:
-            conditions.append(f"[@content-desc='{selector['description']}']")
-        elif "descriptionContains" in selector:
-            conditions.append(f"[contains(@content-desc, '{selector['descriptionContains']}')]")
-        elif "descriptionMatches" in selector:
-            conditions.append(f"[re:match(@content-desc, '{selector['descriptionMatches']}')]")
-        elif "descriptionStartsWith" in selector:
-            conditions.append(f"[starts-with(@content-desc, '{selector['descriptionStartsWith']}')]")
-
-        if "packageName" in selector:
-            conditions.append(f"[@package='{selector['packageName']}']")
-        elif "packageNameMatches" in selector:
-            conditions.append(f"[re:match(@package, '{selector['packageNameMatches']}')]")
-
-        if "resourceId" in selector:
-            conditions.append(f"[@resource-id='{selector['resourceId']}']")
-        elif "resourceIdMatches" in selector:
-            conditions.append(f"[re:match(@resource-id, '{selector['resourceIdMatches']}')]")
-
-        bool_props = [
-            "checkable", "checked", "clickable", "longClickable", "scrollable",
-            "enabled", "focusable", "focused", "selected", "covered"
-        ]
-        for prop in bool_props:
-            if prop in selector:
-                value = "true" if selector[prop] else "false"
-                conditions.append(f"[@{prop}='{value}']")
-
-        if "index" in selector:
-            conditions.append(f"[@index='{selector['index']}']")
-        elif "instance" in selector:
-            conditions.append(f"[@instance='{selector['instance']}']")
-
-        xpath += "".join(conditions)
-
-        if "childOrSibling" in selector and selector["childOrSibling"]:
-            for i, relation in enumerate(selector["childOrSibling"]):
-                sub_selector = selector["childOrSiblingSelector"][i]
-                sub_xpath = selector_to_xpath(sub_selector, False)  # 递归处理子选择器
-
-                if relation == "child":
-                    xpath += f"/{sub_xpath}"
-                elif relation == "sibling":
-                    xpath_initial = xpath
-                    xpath = '(' + xpath_initial + f"/following-sibling::{sub_xpath} | " + xpath_initial + f"/preceding-sibling::{sub_xpath})"
-
-        return xpath
-
-    except Exception as e:
-        print(f"Error occurred during selector conversion: {e}")
-        return "//error"
-
 def is_port_in_use(port: int) -> bool:
     with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
         return s.connect_ex(('127.0.0.1', port)) == 0
@@ -435,3 +427,25 @@ def get_free_port():
             if not is_port_in_use(port):
                 return port
         raise RuntimeError("No free port found")
+
+def set_covered_to_deepest_node(selector: u2.Selector):
+
+    def find_deepest_nodes(node):
+        deepest_node = None
+        is_leaf = True
+        if "childOrSibling" in node and node["childOrSibling"]:
+            for i, relation in enumerate(node["childOrSibling"]):
+                sub_selector = node["childOrSiblingSelector"][i]
+                deepest_node = find_deepest_nodes(sub_selector)
+                is_leaf = False
+
+        if is_leaf:
+            deepest_node = node
+        return deepest_node
+
+    deepest_node = find_deepest_nodes(selector)
+
+    if deepest_node is not None:
+        dict.update(deepest_node, {"covered": False})
+
+

{kea2_python-0.1.1 → kea2_python-0.1.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "Kea2-python"
-version = "0.1.1"
+version = "0.1.3"
 description = "A python library for supporting and customizing automated UI testing for mobile apps"
 readme = "README.md"
 requires-python = ">=3.8"

kea2_python-0.1.3/tests/test_u2Selector.py

@@ -0,0 +1,200 @@
+import unittest
+from kea2.u2Driver import _HindenWidgetFilter, U2Driver
+from lxml import etree
+from pathlib import Path
+
+
+XML_PATH = Path(__file__).parent / "hidden_widget_test.xml"
+
+
+def get_static_checker():
+    xml: etree._ElementTree = etree.parse(XML_PATH)
+    d = U2Driver.getStaticChecker(xml)
+    return d
+
+
+class TestHiddenWidget(unittest.TestCase):
+
+    def test_hidden_widget(self):
+        d = get_static_checker()
+        assert not d(text="微信(690)").exists
+
+import unittest
+
+class TestSupportedAttributes(unittest.TestCase):
+
+    def setUp(self):
+        self.d = get_static_checker()
+
+    def test_text(self):
+        assert self.d(text="添加朋友").exists
+        assert self.d(textContains="朋友").exists
+        assert self.d(textStartsWith="添加").exists
+
+
+    def test_class_name(self):
+        assert self.d(className="android.widget.Button").exists
+
+    def test_description(self):
+        assert self.d(description="企业微信联系人，，通过手机号搜索企业微信用户").exists
+        assert self.d(descriptionContains="微信联系人").exists
+        assert self.d(descriptionStartsWith="企业微信").exists
+
+
+    def test_clickable_true(self):
+        assert self.d(clickable=True).exists
+        assert self.d(clickable=False).exists
+        assert self.d(enabled=True).exists
+        assert self.d(focusable=True).exists
+        assert self.d(focusable=False).exists
+        assert self.d(scrollable=False).exists
+        assert self.d(checkable=False).exists
+        assert self.d(checked=False).exists
+        assert self.d(focused=False).exists
+        assert self.d(selected=False).exists
+        assert self.d(packageName="com.tencent.mm").exists
+        assert self.d(resourceId="com.tencent.mm:id/search_ll").exists
+
+
+    def test_combined_text_and_className(self):
+        assert self.d(text="添加朋友", className="android.widget.TextView").exists
+
+    def test_combined_resourceId_and_className(self):
+        assert self.d(resourceId="com.tencent.mm:id/search_ll", className="android.widget.LinearLayout").exists
+
+    def test_combined_attributes_search_button(self):
+        assert self.d(text="添加朋友", clickable=False).exists
+
+    def test_child_element(self):
+        assert self.d(resourceId="android:id/list").child(description="手机联系人，，添加通讯录中的朋友").exists
+
+
+    def test_sibling_element(self):
+        assert self.d(description="雷达，，添加身边的朋友").sibling(description="手机联系人，，添加通讯录中的朋友").exists
+
+
+
+class TestUnsupportedMethods(unittest.TestCase):
+
+    def setUp(self):
+        self.d = get_static_checker()
+
+    def test_positional_left_not_supported(self):
+        try:
+            result = self.d(text="微信(690)").left(text="搜索")
+            assert False, "left() method should not be supported"
+        except:
+            assert True
+
+    def test_positional_right_not_supported(self):
+        try:
+            result = self.d(text="微信(690)").right(text="搜索")
+            assert False, "right() method should not be supported"
+        except:
+            assert True
+
+    def test_positional_up_not_supported(self):
+        try:
+            result = self.d(text="通讯录").up(text="10:21")
+            assert False, "up() method should not be supported"
+        except:
+            assert True
+
+    def test_positional_down_not_supported(self):
+        try:
+            result = self.d(text="10:21").down(text="通讯录")
+            assert False, "down() method should not be supported"
+        except:
+            assert True
+
+    def test_child_by_text_not_supported(self):
+        try:
+            result = self.d(resourceId="android:id/list").child_by_text("通讯录")
+            assert False, "child_by_text() method should not be supported"
+        except:
+            assert True
+
+    def test_child_by_description_not_supported(self):
+        try:
+            result = self.d(className="android.widget.ListView").child_by_description("扫描")
+            assert False, "child_by_description() method should not be supported"
+        except:
+            assert True
+
+    def test_child_by_instance_not_supported(self):
+        try:
+            result = self.d(className="android.widget.LinearLayout").child_by_instance(1)
+            assert False, "child_by_instance() method should not be supported"
+        except:
+            assert True
+
+    def test_instance_parameter_not_supported(self):
+        try:
+            result = self.d(className="android.widget.TextView", instance=0)
+            assert False, "instance parameter should not be supported"
+        except:
+            assert True
+
+    def test_text_matches_not_supported(self):
+        try:
+            result = self.d(textMatches="微信.*")
+            assert False, "textMatches should not be supported"
+        except:
+            assert True
+
+    def test_class_name_matches_not_supported(self):
+        try:
+            result = self.d(classNameMatches=".*TextView")
+            assert False, "classNameMatches should not be supported"
+        except:
+            assert True
+
+    def test_description_matches_not_supported(self):
+        try:
+            result = self.d(descriptionMatches=".*搜索.*")
+            assert False, "descriptionMatches should not be supported"
+        except:
+            assert True
+
+    def test_package_name_matches_not_supported(self):
+        try:
+            result = self.d(packageNameMatches="com.tencent.*")
+            assert False, "packageNameMatches should not be supported"
+        except:
+            assert True
+
+    def test_resource_id_matches_not_supported(self):
+        try:
+            result = self.d(resourceIdMatches=".*:id/.*")
+            assert False, "resourceIdMatches should not be supported"
+        except:
+            assert True
+
+class TestEdgeCases(unittest.TestCase):
+
+    def setUp(self):
+        self.d = get_static_checker()
+
+    def test_empty_text(self):
+        assert self.d(text="").exists
+
+    def test_empty_resource_id(self):
+        assert self.d(resourceId="").exists
+
+    def test_special_characters_in_text(self):
+        assert not self.d(text="微信(690)").exists
+        assert not self.d(text="[有人@我] 测试: [聊天记录]").exists
+
+    def test_non_existent_element(self):
+        assert not self.d(text="不存在的文本").exists
+        assert not self.d(resourceId="com.example.nonexistent").exists
+
+class TestWidget(unittest.TestCase):
+
+    def test_widget(self):
+        d = get_static_checker()
+        
+
+
+if __name__ == "__main__":
+    unittest.main()