Kea2-python 1.0.4__tar.gz → 1.0.5__tar.gz

{kea2_python-1.0.4 → kea2_python-1.0.5}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 1.0.4
+Version: 1.0.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
@@ -21,9 +21,10 @@ Dynamic: license-file
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ecnusse/Kea2)
 
 <div>
-    <img src="https://github.com/user-attachments/assets/84e47b87-2dd2-4d7e-91d1-e8c1d1db0cf4" style="border-radius: 14px; width: 20%; height: 20%;"/> 
+    <img src="https://github.com/user-attachments/assets/8d9f8750-1e10-411b-a49f-7d8367bbe9fe" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
+
 Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn) with your Wechat ID / QR code to be invited to the WeChat discussion group. Of course, we are also ready on GitHub to answer your questions/feedback.
 
 ####  Github repo [https://github.com/ecnusse/Kea2](https://github.com/ecnusse/Kea2)
@@ -77,7 +78,7 @@ Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operatin
 
 Kea2 (and its idea) has been used/integrated by
 
-- [OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app. OPay uses Kea2 for regression testing on POS machines and mobile devices.
+- [OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app (2 millions of active users daily). OPay uses Kea2 for regression testing on POS machines and mobile devices.
 
 - [WeChat's iExplorer]() --- WeChat's in-house testing platform (coming with an interactive UI-based tool to ease writing scripts)
 

{kea2_python-1.0.4 → kea2_python-1.0.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 1.0.4
+Version: 1.0.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
@@ -21,9 +21,10 @@ Dynamic: license-file
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ecnusse/Kea2)
 
 <div>
-    <img src="https://github.com/user-attachments/assets/84e47b87-2dd2-4d7e-91d1-e8c1d1db0cf4" style="border-radius: 14px; width: 20%; height: 20%;"/> 
+    <img src="https://github.com/user-attachments/assets/8d9f8750-1e10-411b-a49f-7d8367bbe9fe" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
+
 Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn) with your Wechat ID / QR code to be invited to the WeChat discussion group. Of course, we are also ready on GitHub to answer your questions/feedback.
 
 ####  Github repo [https://github.com/ecnusse/Kea2](https://github.com/ecnusse/Kea2)
@@ -77,7 +78,7 @@ Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operatin
 
 Kea2 (and its idea) has been used/integrated by
 
-- [OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app. OPay uses Kea2 for regression testing on POS machines and mobile devices.
+- [OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app (2 millions of active users daily). OPay uses Kea2 for regression testing on POS machines and mobile devices.
 
 - [WeChat's iExplorer]() --- WeChat's in-house testing platform (coming with an interactive UI-based tool to ease writing scripts)
 

{kea2_python-1.0.4 → kea2_python-1.0.5}/README.md

@@ -6,9 +6,10 @@
 [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/ecnusse/Kea2)
 
 <div>
-    <img src="https://github.com/user-attachments/assets/84e47b87-2dd2-4d7e-91d1-e8c1d1db0cf4" style="border-radius: 14px; width: 20%; height: 20%;"/> 
+    <img src="https://github.com/user-attachments/assets/8d9f8750-1e10-411b-a49f-7d8367bbe9fe" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
+
 Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn) with your Wechat ID / QR code to be invited to the WeChat discussion group. Of course, we are also ready on GitHub to answer your questions/feedback.
 
 ####  Github repo [https://github.com/ecnusse/Kea2](https://github.com/ecnusse/Kea2)
@@ -62,7 +63,7 @@ Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operatin
 
 Kea2 (and its idea) has been used/integrated by
 
-- [OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app. OPay uses Kea2 for regression testing on POS machines and mobile devices.
+- [OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app (2 millions of active users daily). OPay uses Kea2 for regression testing on POS machines and mobile devices.
 
 - [WeChat's iExplorer]() --- WeChat's in-house testing platform (coming with an interactive UI-based tool to ease writing scripts)
 

{kea2_python-1.0.4 → kea2_python-1.0.5}/kea2/fastbotManager.py

@@ -129,6 +129,14 @@ class FastbotManager:
             path="/dumpHierarchy",
         )
         return r.json()['result']
+    
+    @retry(Exception, tries=2, delay=2)
+    def sendInfo(self, info: str):
+        r = self.request(
+            method="POST",
+            path="/sendInfo",
+            data=info
+        )
 
     @property
     def device_output_dir(self):

{kea2_python-1.0.4 → kea2_python-1.0.5}/kea2/keaUtils.py

@@ -8,7 +8,7 @@ import os
 from collections import deque
 from copy import deepcopy
 from pathlib import Path
-from time import perf_counter
+from time import perf_counter, sleep
 from typing import Callable, Any, Deque, Dict, List, Literal, NewType, Tuple, Union
 from contextvars import ContextVar
 from unittest import TextTestRunner, registerResult, TestSuite, TestCase, TextTestResult, defaultTestLoader, SkipTest
@@ -155,6 +155,8 @@ class Options:
     act_blacklist_file: str = None
     # propertytest sub-commands args (eg. discover -s xxx -p xxx)
     propertytest_args: List[str] = None
+    # period (N steps) to restart the app under test
+    restart_app_period: int = None
     # unittest sub-commands args (Feat 4)
     unittest_args: List[str] = None
     # Extra args (directly passed to fastbot)
@@ -468,21 +470,30 @@ class KeaTestRunner(TextTestRunner, KeaOptionSetter):
                 start_time = perf_counter()
                 fb_is_running = True
                 self.stepsCount = 0
+
                 while self.stepsCount < self.options.maxStep:
                     if self.shouldStop(start_time):
                         logger.info("Exploration time up (--running-minutes).")
                         break
+
+                    if self.options.restart_app_period and self.stepsCount and self.stepsCount % self.options.restart_app_period == 0:
+                        self.stepsCount += 1
+                        logger.info(f"Sending monkeyEvent {self._monkey_event_count}")
+                        logger.info("Kill all test apps to restart the app under test.")
+                        for app in self.options.packageNames:
+                            logger.info(f"Stopping app: {app}")
+                            self.scriptDriver.app_stop(app)
+                        sleep(3)
+                        fb.sendInfo("kill_apps")
+                        continue
+
                     try:
                         if fb.executed_prop:
                             fb.executed_prop = False
                             xml_raw = fb.dumpHierarchy()
                         else:
                             self.stepsCount += 1
-                            logger.info("Sending monkeyEvent {}".format(
-                                f"({self.stepsCount} / {self.options.maxStep})" if self.options.maxStep != float("inf")
-                                else f"({self.stepsCount})"
-                                )
-                            )
+                            logger.info(f"Sending monkeyEvent {self._monkey_event_count}")
                             xml_raw = fb.stepMonkey(self._monkeyStepInfo)
                         propsSatisfiedPrecond = self.getValidProperties(xml_raw, result)
                     except u2.HTTPError:
@@ -559,6 +570,10 @@ class KeaTestRunner(TextTestRunner, KeaOptionSetter):
         r = self._get_block_widgets()
         r["steps_count"] = self.stepsCount
         return r
+    
+    @property
+    def _monkey_event_count(self):
+        return f"({self.stepsCount} / {self.options.maxStep})" if self.options.maxStep != float("inf") else f"({self.stepsCount})"                       
 
     def _get_block_widgets(self):
         block_dict = self._getBlockedWidgets()

{kea2_python-1.0.4 → kea2_python-1.0.5}/kea2/kea_launcher.py

@@ -158,6 +158,15 @@ def _set_runner_parser(subparsers: "argparse._SubParsersAction[argparse.Argument
         help="Activity BlackList File. The activities listed in the file will be avoided during testing.",
     )
 
+    parser.add_argument(
+        "--restart-app-period",
+        dest="restart_app_period",
+        type=int,
+        required=False,
+        default=0,
+        help="The period (in the numbers of monkey events) to restart the app under test. 0 means no restart.",
+    )
+
     parser.add_argument(
         "extra",
         nargs=argparse.REMAINDER,
@@ -200,6 +209,8 @@ def driver_info_logger(args):
             print("  post_failure_screenshots:", args.post_failure_screenshots, flush=True)
     if args.max_step:
         print("  max_step:", args.max_step, flush=True)
+    if args.restart_app_period > 0:
+        print("  restart_app_period:", args.restart_app_period, flush=True)
 
 
 def parse_args(argv: List):
@@ -270,6 +281,7 @@ def run(args=None):
         device_output_root=args.device_output_root,
         act_whitelist_file=args.act_whitelist_file,
         act_blacklist_file=args.act_blacklist_file,
+        restart_app_period=args.restart_app_period,
         propertytest_args=args.propertytest_args,
         unittest_args=args.unittest_args,
         extra_args=args.extra,

{kea2_python-1.0.4 → kea2_python-1.0.5}/kea2/report/bug_report_generator.py

@@ -59,6 +59,7 @@ class ReportData(TypedDict):
     activity_count_history: Dict[str, int]  # Activity traversal count from final coverage data
     crash_events: List[Dict]  # Crash events from crash-dump.log
     anr_events: List[Dict]  # ANR events from crash-dump.log
+    kill_apps_events: List[Dict]  # kill_apps info events from steps.log
 
 
 class PropertyExecResult(TypedDict):
@@ -250,6 +251,7 @@ class BugReportGenerator(CrashAnrMixin, PathParserMixin, ScreenshotsMixin):
             "activity_count_history": {},
             "crash_events": [],
             "anr_events": [],
+            "kill_apps_events": [],
         }
 
         # Parse steps.log file to get test step numbers and screenshot mappings
@@ -283,6 +285,25 @@ class BugReportGenerator(CrashAnrMixin, PathParserMixin, ScreenshotsMixin):
                 if step_type == "Monkey" or step_type == "Fuzz":
                     monkey_events_count += 1
 
+                # Record restart-app marker events (no screenshot expected)
+                if step_type == "Monkey" and info == "kill_apps":
+                    monkey_steps_count = step_data.get("MonkeyStepsCount", "N/A")
+                    caption = f"Monkey Step {monkey_steps_count}: restart app"
+
+                    data["kill_apps_events"].append({
+                        "step_index": step_index,
+                        "monkey_steps_count": monkey_steps_count,
+                    })
+
+                    # Show this info event in the Test Screenshots timeline
+                    self.screenshots.append({
+                        "id": step_index,
+                        "path": "",
+                        "caption": f"{step_index}. {caption}",
+                        "kind": "info",
+                        "info": "kill_apps",
+                    })
+
                 # If screenshots are enabled, mark the screenshot
                 if self.take_screenshots and step_data["Screenshot"]:
                     executor.submit(self._mark_screenshot, step_data)
@@ -390,8 +411,12 @@ class BugReportGenerator(CrashAnrMixin, PathParserMixin, ScreenshotsMixin):
 
     def _parse_step_data(self, raw_step_info: str) -> StepData:
         step_data: StepData = json.loads(raw_step_info)
-        if step_data["Type"] in {"Monkey", "Script", "ScriptInfo"}:
-            step_data["Info"] = json.loads(step_data["Info"])
+        if step_data.get("Type") in {"Monkey", "Script", "ScriptInfo"}:
+            info = step_data.get("Info")
+            if isinstance(info, str):
+                stripped = info.strip()
+                if stripped and stripped[0] in "{[":
+                    step_data["Info"] = json.loads(stripped)
         return step_data
 
 
@@ -443,7 +468,8 @@ class BugReportGenerator(CrashAnrMixin, PathParserMixin, ScreenshotsMixin):
             'anr_events': data["anr_events"],
             'triggered_crash_count': len(data["crash_events"]),
             'triggered_anr_count': len(data["anr_events"]),
-            'property_stats_summary': data["property_stats_summary"]
+            'property_stats_summary': data["property_stats_summary"],
+            'kill_apps_events': data.get("kill_apps_events", []),
         }
 
         # Check if template exists, if not create it
@@ -498,7 +524,8 @@ class BugReportGenerator(CrashAnrMixin, PathParserMixin, ScreenshotsMixin):
                             "start": current_test["start"],
                             "end": current_test["end"],
                             "screenshot_start": current_test["screenshot_start"],
-                            "screenshot_end": screenshot
+                            "screenshot_end": screenshot,
+                            "state": state
                         })
 
                     # Reset current test
@@ -524,7 +551,8 @@ class BugReportGenerator(CrashAnrMixin, PathParserMixin, ScreenshotsMixin):
                     data["property_violations"].append({
                         "index": index,
                         "property_name": property_name,
-                        "interaction_pages": [start_step, end_step]
+                        "interaction_pages": [start_step, end_step],
+                        "state": violation.get("state", "fail")
                     })
                     index += 1
 

{kea2_python-1.0.4 → kea2_python-1.0.5}/kea2/report/mixin.py

@@ -311,16 +311,19 @@ class ScreenshotsMixin:
         screenshot_name = step_data["Screenshot"]
         if not screenshot_name:
             return
+        info = step_data.get("Info")
+        if not isinstance(info, dict):
+            return
 
         if step_type == "Monkey":
-            act = step_data["Info"].get("act")
-            pos = step_data["Info"].get("pos")
+            act = info.get("act")
+            pos = info.get("pos")
             if act in ["CLICK", "LONG_CLICK"] or act.startswith("SCROLL"):
                 self._mark_screenshot_interaction(step_type, screenshot_name, act, pos)
 
         elif step_type == "Script":
-            act = step_data["Info"].get("method")
-            pos = step_data["Info"].get("params")
+            act = info.get("method")
+            pos = info.get("params")
             if act in ["click", "setText", "swipe"]:
                 self._mark_screenshot_interaction(step_type, screenshot_name, act, pos)
 
@@ -425,19 +428,30 @@ class ScreenshotsMixin:
             data: Data dictionary to update
         """
         caption = ""
+        info = step_data.get("Info")
 
         if step_data["Type"] == "Monkey":
             # Extract 'act' attribute for Monkey type and add MonkeyStepsCount
             monkey_steps_count = step_data.get('MonkeyStepsCount', 'N/A')
-            action = step_data['Info'].get('act', 'N/A')
+            if isinstance(info, dict):
+                action = info.get('act', 'N/A')
+            else:
+                action = str(info) if info else 'N/A'
             caption = f"Monkey Step {monkey_steps_count}: {action}"
         elif step_data["Type"] == "Script":
             # Extract 'method' attribute for Script type
-            caption = f"{step_data['Info'].get('method', 'N/A')}"
+            if isinstance(info, dict):
+                caption = f"{info.get('method', 'N/A')}"
+            else:
+                caption = str(info) if info else "N/A"
         elif step_data["Type"] == "ScriptInfo":
             # Extract 'propName' and 'state' attributes for ScriptInfo type
-            prop_name = step_data["Info"].get('propName', '')
-            state = step_data["Info"].get('state', 'N/A')
+            if isinstance(info, dict):
+                prop_name = info.get('propName', '')
+                state = info.get('state', 'N/A')
+            else:
+                prop_name = ''
+                state = str(info) if info else 'N/A'
             caption = f"{prop_name}: {state}" if prop_name else f"{state}"
         elif step_data["Type"] == "Fuzz":
             monkey_steps_count = step_data.get('MonkeyStepsCount', 'N/A')
@@ -465,4 +479,4 @@ class ScreenshotsMixin:
             'id': step_index,
             'path': relative_screenshot_path,  # Now using string path
             'caption': f"{step_index}. {caption}"
-        })
+        })

{kea2_python-1.0.4 → kea2_python-1.0.5}/kea2/report/templates/bug_report_template.html

@@ -140,6 +140,107 @@
             box-shadow: 0 3px 10px rgba(0, 0, 0, 0.1);
             margin-bottom: 8px;
         }
+
+        .screenshot-placeholder {
+            width: 300px;
+            height: 400px;
+            border-radius: 8px;
+            background: linear-gradient(180deg, rgba(52, 152, 219, 0.08), rgba(255, 255, 255, 0.98));
+            border: 1px solid rgba(52, 152, 219, 0.18);
+            box-shadow: 0 8px 24px rgba(44, 62, 80, 0.08);
+            display: flex;
+            align-items: center;
+            justify-content: center;
+            margin-bottom: 8px;
+            color: #6c757d;
+        }
+
+        .screenshot-placeholder::before {
+            content: "";
+            position: absolute;
+            inset: 10px;
+            border-radius: 10px;
+            border: 1px dashed rgba(52, 152, 219, 0.25);
+            pointer-events: none;
+        }
+
+        .screenshot-item .screenshot-placeholder {
+            position: relative;
+            overflow: hidden;
+        }
+
+        .screenshot-placeholder::after {
+            content: "";
+            position: absolute;
+            inset: 0;
+            background:
+                radial-gradient(circle at 20% 25%, rgba(46, 204, 113, 0.18), transparent 42%),
+                radial-gradient(circle at 80% 70%, rgba(52, 152, 219, 0.16), transparent 48%);
+            pointer-events: none;
+            opacity: 0.9;
+        }
+
+        .screenshot-placeholder .placeholder-content {
+            position: relative;
+            z-index: 1;
+            display: flex;
+            flex-direction: column;
+            align-items: center;
+            gap: 12px;
+            text-align: center;
+        }
+
+        .screenshot-placeholder .placeholder-icon {
+            width: 92px;
+            height: 92px;
+            border-radius: 999px;
+            display: inline-flex;
+            align-items: center;
+            justify-content: center;
+            box-shadow: 0 16px 32px rgba(52, 152, 219, 0.22);
+            border: 1px solid rgba(52, 152, 219, 0.22);
+            background: radial-gradient(circle at 30% 30%, rgba(255, 255, 255, 0.9), rgba(52, 152, 219, 0.10));
+        }
+
+        .screenshot-placeholder .placeholder-icon i {
+            font-size: 40px;
+            color: var(--primary-color);
+        }
+
+        .screenshot-placeholder .placeholder-icon.info i {
+            color: #6c757d;
+        }
+
+        .screenshot-placeholder .placeholder-icon.reboot {
+            background: conic-gradient(from 210deg, rgba(46, 204, 113, 0.22), rgba(52, 152, 219, 0.22), rgba(46, 204, 113, 0.22));
+        }
+
+        .screenshot-placeholder .placeholder-text {
+            font-size: 13px;
+            font-weight: 600;
+            letter-spacing: 0.2px;
+            color: rgba(44, 62, 80, 0.78);
+            padding: 6px 10px;
+            border-radius: 999px;
+            background: rgba(255, 255, 255, 0.72);
+            border: 1px solid rgba(52, 152, 219, 0.14);
+            box-shadow: 0 6px 18px rgba(44, 62, 80, 0.06);
+        }
+
+        .screenshot-item:hover .screenshot-placeholder {
+            border-color: rgba(52, 152, 219, 0.28);
+            box-shadow: 0 12px 30px rgba(44, 62, 80, 0.10);
+        }
+
+        .screenshot-item:hover .placeholder-icon.reboot i {
+            animation: reboot-spin 1.4s ease-in-out infinite;
+        }
+
+        @keyframes reboot-spin {
+            0% { transform: rotate(0deg); }
+            60% { transform: rotate(220deg); }
+            100% { transform: rotate(360deg); }
+        }
         
         .screenshot-caption {
             font-size: 13px;
@@ -524,6 +625,10 @@
             border-radius: 0 0 8px 8px;
             box-shadow: 0 2px 4px rgba(0,0,0,0.05);
         }
+
+        .pagination-container.pagination-violations {
+            padding: 10px 16px;
+        }
         
         .activity-item {
             padding: 10px 15px;
@@ -1435,20 +1540,58 @@
 
         <!-- Screenshots Section -->
         {% if take_screenshots %}
-        {% if screenshots %}
+        {% if screenshots or kill_apps_events %}
         <div class="section-block">
             <h2 class="section-title">Test Screenshots</h2>
             <div class="card">
                 <div class="card-body">
                     <div class="screenshots-container" id="screenshots">
-                        {% for screenshot in screenshots %}
-                        <div class="screenshot-item">
-                            <a href="{{ screenshot.path }}" target="_blank">
-                                <img src="{{ screenshot.path }}" class="screenshot-img" id="{{ screenshot.id }}">
-                            </a>
-                            <div class="screenshot-caption">{{ screenshot.caption }}</div>
-                        </div>
-                        {% endfor %}
+                        {% if screenshots %}
+                            {% for screenshot in screenshots %}
+                            <div class="screenshot-item">
+                                {% if screenshot.path %}
+                                    <a href="{{ screenshot.path }}" target="_blank">
+                                        <img src="{{ screenshot.path }}" class="screenshot-img" id="{{ screenshot.id }}">
+                                    </a>
+                                {% else %}
+                                    <div class="screenshot-placeholder" id="{{ screenshot.id }}">
+                                        {% if screenshot.info == "kill_apps" %}
+                                            <div class="placeholder-content">
+                                                <span class="placeholder-icon reboot">
+                                                    <i class="bi bi-bootstrap-reboot"></i>
+                                                </span>
+                                                <div class="placeholder-text">Restart app</div>
+                                            </div>
+                                        {% else %}
+                                            <div class="placeholder-content">
+                                                <span class="placeholder-icon info">
+                                                    <i class="bi bi-info-circle"></i>
+                                                </span>
+                                                <div class="placeholder-text">Info event</div>
+                                            </div>
+                                        {% endif %}
+                                    </div>
+                                {% endif %}
+                                <div class="screenshot-caption">{{ screenshot.caption }}</div>
+                            </div>
+                            {% endfor %}
+                        {% else %}
+                            {% for ev in kill_apps_events %}
+                            <div class="screenshot-item">
+                                <div class="screenshot-placeholder" id="{{ ev.step_index }}">
+                                    <div class="placeholder-content">
+                                        <span class="placeholder-icon reboot">
+                                            <i class="bi bi-bootstrap-reboot"></i>
+                                        </span>
+                                        <div class="placeholder-text">Restart app</div>
+                                    </div>
+                                </div>
+                                <div class="screenshot-caption">
+                                    {{ ev.step_index }}. Monkey Step {{ ev.monkey_steps_count }}: restart app
+                                </div>
+                            </div>
+                            {% endfor %}
+                        {% endif %}
                     </div>
                 </div>
             </div>
@@ -1630,7 +1773,7 @@
                     </thead>
                     <tbody id="property-violations-container">
                         {% for violation in property_violations %}
-                        <tr class="property-violation-row" data-page="1">
+                        <tr class="property-violation-row" data-page="1" data-status="{{ violation.state|default('fail') }}">
                             <td>{{ violation.index }}</td>
                             <td><span class="badge bg-light text-dark badge-custom">{{ violation.property_name }}</span></td>
                             <td>
@@ -1645,8 +1788,8 @@
                 </table>
 
                 <!-- Pagination for Property Violations -->
-                <div class="d-flex justify-content-between align-items-center mt-3">
-                    <div class="d-flex align-items-center">
+                <div class="d-flex justify-content-between align-items-center mt-3 pagination-container pagination-violations">
+                    <div class="d-flex align-items-center gap-3">
                         <label for="violations-page-size" class="form-label me-2 mb-0">Show:</label>
                         <select class="form-select form-select-sm" id="violations-page-size" style="width: auto;">
                             <option value="5">5</option>
@@ -1655,6 +1798,11 @@
                             <option value="50">50</option>
                             <option value="100">100</option>
                         </select>
+                        <label for="violations-status-filter" class="form-label mb-0">Status:</label>
+                        <select class="form-select form-select-sm" id="violations-status-filter" style="width: auto;">
+                            <option value="all" selected>All</option>
+                            <option value="fail">Fail only</option>
+                        </select>
                     </div>
                     <nav aria-label="Property Violations Pagination">
                         <ul class="pagination pagination-sm mb-0" id="violations-pagination">
@@ -2232,6 +2380,7 @@
             
             // Initialize pagination for Property tables
             initPagination('property-violations-container', 'property-violation-row', 'violations-pagination', 'violations-page-size');
+            initViolationFilter();
             initPagination('property-stats-container', 'property-stat-row', 'stats-pagination', 'stats-page-size');
             
             // Initialize sorting for Property Checking Statistics
@@ -2402,6 +2551,10 @@
                 const allItems = Array.from(container.getElementsByClassName(itemClass));
                 const paginationElement = document.getElementById(paginationId);
                 
+                if (containerId === 'property-stats-container') {
+                    closePropertyErrorDetails(container);
+                }
+
                 console.log('goToPage called with:', {pageNumber, containerId, itemClass, itemsPerPage, paginationId});
                 console.log('Total items found:', allItems.length);
                 
@@ -2946,6 +3099,18 @@
                 }, 3000);
             }
         });
+
+        // Close opened Property Checking Statistics error details when pagination changes
+        function closePropertyErrorDetails(container) {
+            if (!container) return;
+
+            const openDetails = container.querySelectorAll('.property-detail-row.show');
+            openDetails.forEach(function(detailRow) {
+                const collapseInstance = bootstrap.Collapse.getInstance(detailRow) ||
+                    new bootstrap.Collapse(detailRow, { toggle: false });
+                collapseInstance.hide();
+            });
+        }
         
         // Global activity search functions
         function performActivitySearch(searchInput) {
@@ -3140,6 +3305,33 @@
                 }
             }
         }
+
+        function initViolationFilter() {
+            const filterSelect = document.getElementById('violations-status-filter');
+            const container = document.getElementById('property-violations-container');
+
+            if (!filterSelect || !container) return;
+
+            filterSelect.addEventListener('change', function() {
+                const filterValue = this.value;
+                const rows = Array.from(container.getElementsByClassName('property-violation-row'));
+
+                rows.forEach(function(row) {
+                    const status = row.getAttribute('data-status') || 'fail';
+                    if (filterValue === 'all') {
+                        row.removeAttribute('data-search-visible');
+                    } else {
+                        row.setAttribute('data-search-visible', status === filterValue ? 'true' : 'false');
+                    }
+                });
+
+                initPagination('property-violations-container', 'property-violation-row', 'violations-pagination', 'violations-page-size');
+
+                const currentPageSize = document.getElementById('violations-page-size') ?
+                    parseInt(document.getElementById('violations-page-size').value) : 10;
+                goToPage(1, 'property-violations-container', 'property-violation-row', currentPageSize, 'violations-pagination');
+            });
+        }
         
         // Global pagination and navigation functions
         function goToPage(pageNumber, containerId, itemClass, itemsPerPage, paginationId) {
@@ -3147,6 +3339,10 @@
             const allItems = Array.from(container.getElementsByClassName(itemClass));
             const paginationElement = document.getElementById(paginationId);
             
+            if (containerId === 'property-stats-container') {
+                closePropertyErrorDetails(container);
+            }
+
             // Get items that should be visible based on search filter
             const filteredItems = allItems.filter(item => {
                 const searchVisible = item.getAttribute('data-search-visible');

{kea2_python-1.0.4 → kea2_python-1.0.5}/kea2/resultSyncer.py

@@ -3,7 +3,7 @@ import threading
 from pathlib import Path
 
 from .adbUtils import ADBDevice
-from .utils import getLogger
+from .utils import getLogger, catchException, timer
 
 from typing import TYPE_CHECKING
 if TYPE_CHECKING:
@@ -34,36 +34,32 @@ class ResultSyncer:
         """Thread function that waits for sync event and then syncs data"""
         while self.running:
             # Wait for sync event with a timeout to periodically check if still running
-            if self.sync_event.wait(timeout=3):
+            if self.sync_event.wait(timeout=1):
                 self._sync_device_data()
                 self.sync_event.clear()
 
+    @timer("Data Sync cost %cost_time seconds")
     def close(self):
         self.running = False
         self.sync_event.set()
         if self.thread and self.thread.is_alive():
+            logger.info("Syncing result data from device. Please wait...")
             self.thread.join(timeout=10)
         self._sync_device_data()
         try:
             logger.debug(f"Removing device output directory: {self.device_output_dir}")
             remove_device_dir = ["rm", "-rf", self.device_output_dir]
-            # adb_shell(remove_device_dir)
             self.dev.shell(remove_device_dir)
         except Exception as e:
             logger.error(f"Error removing device output directory: {e}", flush=True)
 
+    @catchException("Error during device data sync.")    
     def _sync_device_data(self):
         """
         Sync the device data to the local directory.
         """
-        try:
-            logger.debug("Syncing data")
-
-            self.dev.sync.pull_dir(self.device_output_dir, self.output_dir, exist_ok=True)
-            # pull_file(self.device_output_dir, str(self.output_dir))
+        logger.debug("Syncing data")
+        self.dev.sync.pull_dir(self.device_output_dir, self.output_dir, exist_ok=True)
 
-            remove_pulled_screenshots = ["find", self.device_output_dir, "-name", '"*.png"', "-delete"]
-            self.dev.shell(remove_pulled_screenshots)
-            # adb_shell(remove_pulled_screenshots)
-        except Exception as e:
-            logger.error(f"Error in data sync: {e}")
+        remove_pulled_screenshots = ["find", self.device_output_dir, "-name", '"*.png"', "-delete"]
+        self.dev.shell(remove_pulled_screenshots)

{kea2_python-1.0.4 → kea2_python-1.0.5}/pyproject.toml

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

kea2_python-1.0.5/tests/test_xpath.py

@@ -0,0 +1,67 @@
+import unittest
+from kea2.u2Driver import U2StaticChecker, U2StaticDevice
+from pathlib import Path
+
+
+XML_PATH = Path(__file__).parent / "xpath_test.xml"
+
+
+class U2StaticCheckerForTest(U2StaticChecker):
+    def __init__(self):
+        self.d = U2StaticDevice(script_driver=None)
+
+
+def get_static_checker():
+    xml = ""
+    with open(XML_PATH, "r", encoding="utf-8") as f:
+        xml = f.read()
+    d = U2StaticCheckerForTest()
+    return d.getInstance(xml)
+
+
+class TestXPath(unittest.TestCase):
+
+    def setUp(self):
+        self.d = get_static_checker()
+
+    def test_basic_xpath(self):
+        assert self.d.xpath("""//*[@text="Hrgshsjs"]""").exists
+        assert self.d.xpath("""//android.widget.TextView[@text="hehzhe"]""").exists
+        assert self.d.xpath(
+            """(//*[@resource-id="it.feio.android.omninotes.alpha:id/category_marker"])[3]"""
+        ).exists
+
+        assert self.d.xpath('@com.android.systemui:id/clock').exists          
+
+        assert self.d.xpath('//android.widget.TextView[@text="hehzhe"]')\
+                    .parent_exists('//androidx.recyclerview.widget.RecyclerView')   
+
+        assert (self.d.xpath('100') &
+                self.d.xpath('@com.android.systemui:id/battery_inside_percent')).exists
+
+        assert (self.d.xpath('100') | self.d.xpath('2:14')).exists            # |
+
+        assert self.d.xpath('//android.widget.TextView[@text="Notes"]')\
+                    .parent_exists('@it.feio.android.omninotes.alpha:id/toolbar')  # parent_exists
+
+        assert self.d.xpath('@it.feio.android.omninotes.alpha:id/fab')\
+                    .child('/android.widget.ImageButton').exists              # child
+
+        assert self.d.xpath('//androidx.drawerlayout.widget.DrawerLayout[@resource-id="it.feio.android.omninotes.alpha:id/drawer_layout"]' +
+                            '//android.view.ViewGroup[@resource-id="it.feio.android.omninotes.alpha:id/toolbar"]').exists
+
+        assert self.d.xpath('(//android.view.View[@resource-id="it.feio.android.omninotes.alpha:id/category_marker"])[3]')\
+                    .parent_exists('//androidx.recyclerview.widget.RecyclerView[@resource-id="it.feio.android.omninotes.alpha:id/list"]')
+        
+        assert self.d.xpath('//androidx.drawerlayout.widget.DrawerLayout[@resource-id="it.feio.android.omninotes.alpha:id/drawer_layout"]' +
+                            '//android.view.ViewGroup[@resource-id="it.feio.android.omninotes.alpha:id/toolbar"]').exists
+
+        # parent_exists
+        node = (self.d.xpath('@com.android.systemui:id/battery_inside_percent') |  
+                self.d.xpath('@com.android.systemui:id/clock'))                    
+        assert node & self.d.xpath('//android.widget.TextView')                     
+        assert node.parent_exists('@com.android.systemui:id/status_bar')            # parent_exists
+
+
+if __name__ == "__main__":
+    unittest.main()

kea2_python-1.0.4/tests/test_xpath.py

@@ -1,36 +0,0 @@
-import unittest
-from kea2.u2Driver import U2StaticChecker, U2StaticDevice
-from pathlib import Path
-
-
-XML_PATH = Path(__file__).parent / "xpath_test.xml"
-
-
-class U2StaticCheckerForTest(U2StaticChecker):
-    def __init__(self):
-        self.d = U2StaticDevice(script_driver=None)
-
-
-def get_static_checker():
-    xml = ""
-    with open(XML_PATH, "r", encoding="utf-8") as f:
-        xml = f.read()
-    d = U2StaticCheckerForTest()
-    return d.getInstance(xml)
-
-
-class TestXPath(unittest.TestCase):
-
-    def setUp(self):
-        self.d = get_static_checker()
-
-    def test_basic_xpath(self):
-        assert self.d.xpath("""//*[@text="Hrgshsjs"]""").exists
-        assert self.d.xpath("""//android.widget.TextView[@text="hehzhe"]""").exists
-        assert self.d.xpath(
-            """(//*[@resource-id="it.feio.android.omninotes.alpha:id/category_marker"])[3]"""
-        ).exists
-
-
-if __name__ == "__main__":
-    unittest.main()