Kea2-python 0.2.4__tar.gz → 0.3.0__tar.gz

{kea2_python-0.2.4 → kea2_python-0.3.0}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.2.4
+Version: 0.3.0
 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
@@ -22,6 +22,8 @@ Dynamic: license-file
     <img src="https://github.com/user-attachments/assets/84e47b87-2dd2-4d7e-91d1-e8c1d1db0cf4" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
+The group has reached its capacity. 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 group.
+
 ### Github repo link
 [https://github.com/ecnusse/Kea2](https://github.com/ecnusse/Kea2)
 
@@ -58,7 +60,11 @@ Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operatin
 | **Finding crashes in deep states** |  | :+1: | :+1: |
 | **Finding non-crashing functional (logic) bugs** |  |  | :+1: |
 
+## Kea2's Known Users
+
+[OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app
 
+We are glad to hear if you are using Kea2 for your app.
 
 ## Design & Roadmap
 Kea2 currently works with:
@@ -224,6 +230,7 @@ You can find the [user manual](docs/manual_en.md), which includes:
 - How to run Kea2 and Kea2's command line options
 - 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
+- [Common Q&A for PBT and Kea2](https://sy8pzmhmun.feishu.cn/wiki/SLGwwqgzIiEuC3kwmV8cSZY0nTg?from=from_copylink)
 
 ## Open-source projects used by Kea2
 
@@ -246,8 +253,8 @@ You can find the [user manual](docs/manual_en.md), which includes:
 Kea2 has been actively developed and maintained by the people in [ecnusse](https://github.com/ecnusse):
 
 - [Xixian Liang](https://xixianliang.github.io/resume/) ([@XixianLiang][])
-- Bo Ma ([@majuzi123][])
-- Chen Peng ([@Drifterpc][])
+- [Bo Ma](https://github.com/majuzi123) ([@majuzi123][])
+- [Cheng Peng](https://github.com/Drifterpc) ([@Drifterpc][])
 - [Ting Su](https://tingsu.github.io/) ([@tingsu][])
 
 [@XixianLiang]: https://github.com/XixianLiang

{kea2_python-0.2.4 → kea2_python-0.3.0}/Kea2_python.egg-info/SOURCES.txt

@@ -16,6 +16,7 @@ kea2/fastbotManager.py
 kea2/keaUtils.py
 kea2/kea_launcher.py
 kea2/logWatcher.py
+kea2/report_merger.py
 kea2/resultSyncer.py
 kea2/u2Driver.py
 kea2/utils.py
@@ -37,4 +38,5 @@ 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/merged_bug_report_template.html
 tests/test_u2Selector.py

{kea2_python-0.2.4 → kea2_python-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.2.4
+Version: 0.3.0
 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
@@ -22,6 +22,8 @@ Dynamic: license-file
     <img src="https://github.com/user-attachments/assets/84e47b87-2dd2-4d7e-91d1-e8c1d1db0cf4" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
+The group has reached its capacity. 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 group.
+
 ### Github repo link
 [https://github.com/ecnusse/Kea2](https://github.com/ecnusse/Kea2)
 
@@ -58,7 +60,11 @@ Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operatin
 | **Finding crashes in deep states** |  | :+1: | :+1: |
 | **Finding non-crashing functional (logic) bugs** |  |  | :+1: |
 
+## Kea2's Known Users
+
+[OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app
 
+We are glad to hear if you are using Kea2 for your app.
 
 ## Design & Roadmap
 Kea2 currently works with:
@@ -224,6 +230,7 @@ You can find the [user manual](docs/manual_en.md), which includes:
 - How to run Kea2 and Kea2's command line options
 - 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
+- [Common Q&A for PBT and Kea2](https://sy8pzmhmun.feishu.cn/wiki/SLGwwqgzIiEuC3kwmV8cSZY0nTg?from=from_copylink)
 
 ## Open-source projects used by Kea2
 
@@ -246,8 +253,8 @@ You can find the [user manual](docs/manual_en.md), which includes:
 Kea2 has been actively developed and maintained by the people in [ecnusse](https://github.com/ecnusse):
 
 - [Xixian Liang](https://xixianliang.github.io/resume/) ([@XixianLiang][])
-- Bo Ma ([@majuzi123][])
-- Chen Peng ([@Drifterpc][])
+- [Bo Ma](https://github.com/majuzi123) ([@majuzi123][])
+- [Cheng Peng](https://github.com/Drifterpc) ([@Drifterpc][])
 - [Ting Su](https://tingsu.github.io/) ([@tingsu][])
 
 [@XixianLiang]: https://github.com/XixianLiang

{kea2_python-0.2.4 → kea2_python-0.3.0}/README.md

@@ -8,6 +8,8 @@
     <img src="https://github.com/user-attachments/assets/84e47b87-2dd2-4d7e-91d1-e8c1d1db0cf4" style="border-radius: 14px; width: 20%; height: 20%;"/> 
 </div>
 
+The group has reached its capacity. 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 group.
+
 ### Github repo link
 [https://github.com/ecnusse/Kea2](https://github.com/ecnusse/Kea2)
 
@@ -44,7 +46,11 @@ Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operatin
 | **Finding crashes in deep states** |  | :+1: | :+1: |
 | **Finding non-crashing functional (logic) bugs** |  |  | :+1: |
 
+## Kea2's Known Users
+
+[OPay Business](https://play.google.com/store/apps/details?id=team.opay.pay.merchant.service) --- a financial & payment app
 
+We are glad to hear if you are using Kea2 for your app.
 
 ## Design & Roadmap
 Kea2 currently works with:
@@ -210,6 +216,7 @@ You can find the [user manual](docs/manual_en.md), which includes:
 - How to run Kea2 and Kea2's command line options
 - 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
+- [Common Q&A for PBT and Kea2](https://sy8pzmhmun.feishu.cn/wiki/SLGwwqgzIiEuC3kwmV8cSZY0nTg?from=from_copylink)
 
 ## Open-source projects used by Kea2
 
@@ -232,8 +239,8 @@ You can find the [user manual](docs/manual_en.md), which includes:
 Kea2 has been actively developed and maintained by the people in [ecnusse](https://github.com/ecnusse):
 
 - [Xixian Liang](https://xixianliang.github.io/resume/) ([@XixianLiang][])
-- Bo Ma ([@majuzi123][])
-- Chen Peng ([@Drifterpc][])
+- [Bo Ma](https://github.com/majuzi123) ([@majuzi123][])
+- [Cheng Peng](https://github.com/Drifterpc) ([@Drifterpc][])
 - [Ting Su](https://tingsu.github.io/) ([@tingsu][])
 
 [@XixianLiang]: https://github.com/XixianLiang

{kea2_python-0.2.4 → kea2_python-0.3.0}/kea2/bug_report_generator.py

@@ -1,8 +1,9 @@
 import json
+import re
 from datetime import datetime
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Dict, TypedDict, List, Deque, NewType, Union, Optional
+from typing import Dict, Tuple, TypedDict, List, Deque, NewType, Union, Optional
 from collections import deque
 from concurrent.futures import ThreadPoolExecutor
 
@@ -56,6 +57,8 @@ class ReportData(TypedDict):
     coverage_trend: List
     property_execution_trend: List  # Track executed properties count over steps
     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
 
 
 class PropertyExecResult(TypedDict):
@@ -119,6 +122,7 @@ class DataPath:
     coverage_log: Path
     screenshots_dir: Path
     property_exec_info: Path
+    crash_dump_log: Path
 
 
 class BugReportGenerator:
@@ -223,7 +227,8 @@ class BugReportGenerator:
             result_json=self.result_dir / f"result_{self.log_timestamp}.json",
             coverage_log=self.result_dir / f"output_{self.log_timestamp}" / "coverage.log",
             screenshots_dir=self.result_dir / f"output_{self.log_timestamp}" / "screenshots",
-            property_exec_info=self.result_dir / f"property_exec_info_{self.log_timestamp}.json"
+            property_exec_info=self.result_dir / f"property_exec_info_{self.log_timestamp}.json",
+            crash_dump_log=self.result_dir / f"output_{self.log_timestamp}" / "crash-dump.log"
         )
 
         self.screenshots = deque()
@@ -287,7 +292,9 @@ class BugReportGenerator:
             "screenshot_info": {},
             "coverage_trend": [],
             "property_execution_trend": [],
-            "activity_count_history": {}
+            "activity_count_history": {},
+            "crash_events": [],
+            "anr_events": []
         }
 
         # Parse steps.log file to get test step numbers and screenshot mappings
@@ -402,6 +409,11 @@ class BugReportGenerator:
         # Load error details for properties with fail/error state
         data["property_error_details"] = self._load_property_error_details()
 
+        # Load crash and ANR events from crash-dump.log
+        crash_events, anr_events = self._load_crash_dump_data()
+        data["crash_events"] = crash_events
+        data["anr_events"] = anr_events
+
         return data
 
     def _parse_step_data(self, raw_step_info: str) -> StepData:
@@ -432,7 +444,7 @@ class BugReportGenerator:
             logger.error(f"Error when marking screenshots: {e}")
 
 
-    def _mark_screenshot_interaction(self, step_type: str, screenshot_name: str, action_type: str, position: Union[List, tuple]) -> bool:
+    def _mark_screenshot_interaction(self, step_type: str, screenshot_name: str, action_type: str, position: Union[List, Tuple]) -> bool:
         """
         Mark interaction on screenshot with colored rectangle
 
@@ -556,7 +568,9 @@ class BugReportGenerator:
                 'take_screenshots': self.take_screenshots,  # Pass screenshot setting to template
                 'property_execution_trend': data["property_execution_trend"],
                 'property_execution_data': json.dumps(data["property_execution_trend"]),
-                'activity_count_history': data["activity_count_history"]
+                'activity_count_history': data["activity_count_history"],
+                'crash_events': data["crash_events"],
+                'anr_events': data["anr_events"]
             }
 
             # Check if template exists, if not create it
@@ -616,7 +630,7 @@ class BugReportGenerator:
         })
 
     def _process_script_info(self, property_name: str, state: str, step_index: int, screenshot: str,
-                             current_property: str, current_test: Dict, property_violations: Dict) -> tuple:
+                             current_property: str, current_test: Dict, property_violations: Dict) -> Tuple:
         """
         Process ScriptInfo step for property violations tracking
 
@@ -817,11 +831,257 @@ class BugReportGenerator:
         
         return property_execution_trend
 
+    def _load_crash_dump_data(self) -> Tuple[List[Dict], List[Dict]]:
+        """
+        Load crash and ANR events from crash-dump.log file
+
+        Returns:
+            tuple: (crash_events, anr_events) - Lists of crash and ANR event dictionaries
+        """
+        crash_events = []
+        anr_events = []
+
+        if not self.data_path.crash_dump_log.exists():
+            logger.info(f"No crash was found in this run.")
+            return crash_events, anr_events
+
+        try:
+            with open(self.data_path.crash_dump_log, "r", encoding="utf-8") as f:
+                content = f.read()
+
+            # Parse crash events
+            crash_events = self._parse_crash_events(content)
+
+            # Parse ANR events
+            anr_events = self._parse_anr_events(content)
+
+            logger.debug(f"Found {len(crash_events)} crash events and {len(anr_events)} ANR events")
+
+            return crash_events, anr_events
+
+        except Exception as e:
+            logger.error(f"Error reading crash dump file: {e}")
+
+
+    def _parse_crash_events(self, content: str) -> List[Dict]:
+        """
+        Parse crash events from crash-dump.log content
+
+        Args:
+            content: Content of crash-dump.log file
+
+        Returns:
+            List[Dict]: List of crash event dictionaries
+        """
+        crash_events = []
+
+        # Pattern to match crash blocks
+        crash_pattern = r'(\d{14})\ncrash:\n(.*?)\n// crash end'
+
+        for match in re.finditer(crash_pattern, content, re.DOTALL):
+            timestamp_str = match.group(1)
+            crash_content = match.group(2)
+
+            # Parse timestamp (format: YYYYMMDDHHMMSS)
+            try:
+                timestamp = datetime.strptime(timestamp_str, "%Y%m%d%H%M%S")
+                formatted_time = timestamp.strftime("%Y-%m-%d %H:%M:%S")
+            except ValueError:
+                formatted_time = timestamp_str
+
+            # Extract crash information
+            crash_info = self._extract_crash_info(crash_content)
+
+            crash_event = {
+                "time": formatted_time,
+                "exception_type": crash_info.get("exception_type", "Unknown"),
+                "process": crash_info.get("process", "Unknown"),
+                "stack_trace": crash_info.get("stack_trace", "")
+            }
+
+            crash_events.append(crash_event)
+
+        return crash_events
+
+    def _parse_anr_events(self, content: str) -> List[Dict]:
+        """
+        Parse ANR events from crash-dump.log content
+
+        Args:
+            content: Content of crash-dump.log file
+
+        Returns:
+            List[Dict]: List of ANR event dictionaries
+        """
+        anr_events = []
+
+        # Pattern to match ANR blocks
+        anr_pattern = r'(\d{14})\nanr:\n(.*?)\nanr end'
+
+        for match in re.finditer(anr_pattern, content, re.DOTALL):
+            timestamp_str = match.group(1)
+            anr_content = match.group(2)
+
+            # Parse timestamp (format: YYYYMMDDHHMMSS)
+            try:
+                timestamp = datetime.strptime(timestamp_str, "%Y%m%d%H%M%S")
+                formatted_time = timestamp.strftime("%Y-%m-%d %H:%M:%S")
+            except ValueError:
+                formatted_time = timestamp_str
+
+            # Extract ANR information
+            anr_info = self._extract_anr_info(anr_content)
+
+            anr_event = {
+                "time": formatted_time,
+                "reason": anr_info.get("reason", "Unknown"),
+                "process": anr_info.get("process", "Unknown"),
+                "trace": anr_info.get("trace", "")
+            }
+
+            anr_events.append(anr_event)
+
+        return anr_events
+
+    def _extract_crash_info(self, crash_content: str) -> Dict:
+        """
+        Extract crash information from crash content
+
+        Args:
+            crash_content: Content of a single crash block
+
+        Returns:
+            Dict: Extracted crash information
+        """
+        crash_info = {
+            "exception_type": "Unknown",
+            "process": "Unknown",
+            "stack_trace": ""
+        }
+
+        lines = crash_content.strip().split('\n')
+
+        for line in lines:
+            line = line.strip()
+
+            # Extract PID from CRASH line
+            if line.startswith("// CRASH:"):
+                # Pattern: // CRASH: process_name (pid xxxx) (dump time: ...)
+                pid_match = re.search(r'\(pid\s+(\d+)\)', line)
+                if pid_match:
+                    crash_info["process"] = pid_match.group(1)
+
+            # Extract exception type from Long Msg line
+            elif line.startswith("// Long Msg:"):
+                # Pattern: // Long Msg: ExceptionType: message
+                exception_match = re.search(r'// Long Msg:\s+([^:]+)', line)
+                if exception_match:
+                    crash_info["exception_type"] = exception_match.group(1).strip()
+
+        # Extract full stack trace (all lines starting with //)
+        stack_lines = []
+        for line in lines:
+            if line.startswith("//"):
+                # Remove the "// " prefix for cleaner display
+                clean_line = line[3:] if line.startswith("// ") else line[2:]
+                stack_lines.append(clean_line)
+
+        crash_info["stack_trace"] = '\n'.join(stack_lines)
+
+        return crash_info
+
+    def _extract_anr_info(self, anr_content: str) -> Dict:
+        """
+        Extract ANR information from ANR content
+
+        Args:
+            anr_content: Content of a single ANR block
+
+        Returns:
+            Dict: Extracted ANR information
+        """
+        anr_info = {
+            "reason": "Unknown",
+            "process": "Unknown",
+            "trace": ""
+        }
+
+        lines = anr_content.strip().split('\n')
+
+        for line in lines:
+            line = line.strip()
+
+            # Extract PID from ANR line
+            if line.startswith("// ANR:"):
+                # Pattern: // ANR: process_name (pid xxxx) (dump time: ...)
+                pid_match = re.search(r'\(pid\s+(\d+)\)', line)
+                if pid_match:
+                    anr_info["process"] = pid_match.group(1)
+
+            # Extract reason from Reason line
+            elif line.startswith("Reason:"):
+                # Pattern: Reason: Input dispatching timed out (...)
+                reason_match = re.search(r'Reason:\s+(.+)', line)
+                if reason_match:
+                    full_reason = reason_match.group(1).strip()
+                    # Simplify the reason by extracting the main part before parentheses
+                    simplified_reason = self._simplify_anr_reason(full_reason)
+                    anr_info["reason"] = simplified_reason
+
+        # Store the full ANR trace content
+        anr_info["trace"] = anr_content
+
+        return anr_info
+
+    def _simplify_anr_reason(self, full_reason: str) -> str:
+        """
+        Simplify ANR reason by extracting the main part
+
+        Args:
+            full_reason: Full ANR reason string
+
+        Returns:
+            str: Simplified ANR reason
+        """
+        # Common ANR reason patterns to simplify
+        simplification_patterns = [
+            # Input dispatching timed out (details...) -> Input dispatching timed out
+            (r'^(Input dispatching timed out)\s*\(.*\).*$', r'\1'),
+            # Broadcast of Intent (details...) -> Broadcast timeout
+            (r'^Broadcast of Intent.*$', 'Broadcast timeout'),
+            # Service timeout -> Service timeout
+            (r'^Service.*timeout.*$', 'Service timeout'),
+            # ContentProvider timeout -> ContentProvider timeout
+            (r'^ContentProvider.*timeout.*$', 'ContentProvider timeout'),
+        ]
+
+        # Apply simplification patterns
+        for pattern, replacement in simplification_patterns:
+            match = re.match(pattern, full_reason, re.IGNORECASE)
+            if match:
+                if callable(replacement):
+                    return replacement(match)
+                elif '\\1' in replacement:
+                    return re.sub(pattern, replacement, full_reason, flags=re.IGNORECASE)
+                else:
+                    return replacement
+
+        # If no pattern matches, try to extract the part before the first parenthesis
+        paren_match = re.match(r'^([^(]+)', full_reason)
+        if paren_match:
+            simplified = paren_match.group(1).strip()
+            # Remove trailing punctuation
+            simplified = re.sub(r'[.,;:]+$', '', simplified)
+            return simplified
+
+        # If all else fails, return the original but truncated
+        return full_reason[:50] + "..." if len(full_reason) > 50 else full_reason
+
 
 if __name__ == "__main__":
     print("Generating bug report")
     # OUTPUT_PATH = "<Your output path>"
-    OUTPUT_PATH = "P:/Python/Kea2/output/res_2025070814_4842540549"
+    OUTPUT_PATH = "P:/Python/Kea2/output/res_2025072011_5048015228"
 
     report_generator = BugReportGenerator()
     report_path = report_generator.generate_report(OUTPUT_PATH)

{kea2_python-0.2.4 → kea2_python-0.3.0}/kea2/cli.py

@@ -54,9 +54,15 @@ def cmd_report(args):
             logger.error("Report directory path is required. Use -p to specify the path.")
             return
 
-        report_path = Path(report_dir)
+        if Path(report_dir).is_absolute():
+            report_path = Path(report_dir)
+        else:
+            report_path = Path.cwd() / report_dir
+
+        report_path = report_path.resolve()
+
         if not report_path.exists():
-            logger.error(f"Report directory does not exist: {report_dir}")
+            logger.error(f"Report directory does not exist: {report_path}")
             return
         
         logger.debug(f"Generating test report from directory: {report_dir}")
@@ -74,6 +80,47 @@ def cmd_report(args):
         logger.error(f"Error generating test report: {e}")
 
 
+def cmd_merge(args):
+    """Merge multiple test report directories and generate a combined report"""
+    from .report_merger import TestReportMerger
+
+    try:
+        # Validate input paths
+        if not args.paths or len(args.paths) < 2:
+            logger.error("At least 2 test report paths are required for merging. Use -p to specify paths.")
+            return
+
+        # Validate that all paths exist
+        for path in args.paths:
+            path_obj = Path(path)
+            if not path_obj.exists():
+                logger.error(f"Test report path does not exist: {path}")
+                return
+            if not path_obj.is_dir():
+                logger.error(f"Path is not a directory: {path}")
+                return
+
+        logger.debug(f"Merging {len(args.paths)} test report directories...")
+
+        # Initialize merger
+        merger = TestReportMerger()
+
+        # Merge test reports
+        merged_dir = merger.merge_reports(args.paths, args.output)
+
+        # Print results
+        print(f"✅ Test reports merged successfully!", flush=True)
+        print(f"📁 Merged report directory: {merged_dir}", flush=True)
+        print(f"📊 Merged report: {merged_dir}/merged_report.html", flush=True)
+
+        # Get merge summary
+        merge_summary = merger.get_merge_summary()
+        print(f"📈 Merged {merge_summary.get('merged_directories', 0)} directories", flush=True)
+
+    except Exception as e:
+        logger.error(f"Error during merge operation: {e}")
+
+
 def cmd_run(args):
     base_dir = getProjectRoot()
     if base_dir is None:
@@ -102,6 +149,28 @@ _commands = [
                 help="Path to the directory containing test results"
             )
         ]
+    ),
+    dict(
+        action=cmd_merge,
+        command="merge",
+        help="merge multiple test report directories and generate a combined report",
+        flags=[
+            dict(
+                name=["paths"],
+                args=["-p", "--paths"],
+                type=str,
+                nargs='+',
+                required=True,
+                help="Paths to test report directories (res_* directories) to merge"
+            ),
+            dict(
+                name=["output"],
+                args=["-o", "--output"],
+                type=str,
+                required=False,
+                help="Output directory for merged report (optional)"
+            )
+        ]
     )
 ]