Kea2-python 1.0.2__tar.gz → 1.0.3__tar.gz

{kea2_python-1.0.2 → kea2_python-1.0.3}/Kea2_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 1.0.2
+Version: 1.0.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
@@ -43,7 +43,7 @@ Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn)
 
 Kea2 is an easy-to-use tool for fuzzing mobile apps. Its key *novelty* is able to fuse automated UI testing with scripts (usually written by human), thus empowering automated UI testing with human intelligence for effectively finding *crashing bugs* as well as *non-crashing functional (logic) bugs*. 
 
-Kea2 is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android), *an industrial-strength automated UI testing tool*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*.
+Kea2 is currently built on top of [Fastbot](https://github.com/ecnusse/Fastbot_Android) 3.0 (a modified/enhanced version of the original [FastBot](https://github.com/bytedance/Fastbot_Android) 2.0), *an industrial-strength automated UI testing tool from ByteDance*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*. 
 Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps. 
 
 ## Novelty & Important features
@@ -90,7 +90,7 @@ Please let us know and willing to hear your feedback/questions if you are also u
 Kea2 currently works with:
 - [unittest](https://docs.python.org/3/library/unittest.html) as the testing framework to manage the scripts;
 - [uiautomator2](https://github.com/openatx/uiautomator2) as the UI test driver; 
-- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool.
+- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool. 
 
 In the future, Kea2 will be extended to support
 - [pytest](https://docs.pytest.org/en/stable/), another popular python testing framework;
@@ -379,7 +379,7 @@ kea2做了什么：
 
 > Guided, Stochastic Model-Based GUI Testing of Android Apps. ESEC/FSE 2017.  [pdf](https://dl.acm.org/doi/10.1145/3106237.3106298)
 
-### Maintainers/Contributors
+## Maintainers/Contributors
 
 Kea2 has been actively developed and maintained by the people in [ecnusse](https://github.com/ecnusse):
 
@@ -397,7 +397,13 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 
 Kea2 has also received many valuable insights, advices, feedbacks and lessons shared by several industrial people from Bytedance ([Zhao Zhang](https://github.com/zhangzhao4444), Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
-### Star History
+### Become a Contributor!
+
+Kea2 is an open-source project and we are calling for more contributors to join us!
+
+See [Developer guide](DEVELOP.md) for more details.
+
+## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=ecnusse/Kea2&type=Date)](https://www.star-history.com/#ecnusse/Kea2&Date)
 

{kea2_python-1.0.2 → kea2_python-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 1.0.2
+Version: 1.0.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
@@ -43,7 +43,7 @@ Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn)
 
 Kea2 is an easy-to-use tool for fuzzing mobile apps. Its key *novelty* is able to fuse automated UI testing with scripts (usually written by human), thus empowering automated UI testing with human intelligence for effectively finding *crashing bugs* as well as *non-crashing functional (logic) bugs*. 
 
-Kea2 is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android), *an industrial-strength automated UI testing tool*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*.
+Kea2 is currently built on top of [Fastbot](https://github.com/ecnusse/Fastbot_Android) 3.0 (a modified/enhanced version of the original [FastBot](https://github.com/bytedance/Fastbot_Android) 2.0), *an industrial-strength automated UI testing tool from ByteDance*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*. 
 Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps. 
 
 ## Novelty & Important features
@@ -90,7 +90,7 @@ Please let us know and willing to hear your feedback/questions if you are also u
 Kea2 currently works with:
 - [unittest](https://docs.python.org/3/library/unittest.html) as the testing framework to manage the scripts;
 - [uiautomator2](https://github.com/openatx/uiautomator2) as the UI test driver; 
-- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool.
+- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool. 
 
 In the future, Kea2 will be extended to support
 - [pytest](https://docs.pytest.org/en/stable/), another popular python testing framework;
@@ -379,7 +379,7 @@ kea2做了什么：
 
 > Guided, Stochastic Model-Based GUI Testing of Android Apps. ESEC/FSE 2017.  [pdf](https://dl.acm.org/doi/10.1145/3106237.3106298)
 
-### Maintainers/Contributors
+## Maintainers/Contributors
 
 Kea2 has been actively developed and maintained by the people in [ecnusse](https://github.com/ecnusse):
 
@@ -397,7 +397,13 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 
 Kea2 has also received many valuable insights, advices, feedbacks and lessons shared by several industrial people from Bytedance ([Zhao Zhang](https://github.com/zhangzhao4444), Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
-### Star History
+### Become a Contributor!
+
+Kea2 is an open-source project and we are calling for more contributors to join us!
+
+See [Developer guide](DEVELOP.md) for more details.
+
+## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=ecnusse/Kea2&type=Date)](https://www.star-history.com/#ecnusse/Kea2&Date)
 

{kea2_python-1.0.2 → kea2_python-1.0.3}/README.md

@@ -28,7 +28,7 @@ Please contact Xixian Liang at [xixian@stu.ecnu.edu.cn](xixian@stu.ecnu.edu.cn)
 
 Kea2 is an easy-to-use tool for fuzzing mobile apps. Its key *novelty* is able to fuse automated UI testing with scripts (usually written by human), thus empowering automated UI testing with human intelligence for effectively finding *crashing bugs* as well as *non-crashing functional (logic) bugs*. 
 
-Kea2 is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android), *an industrial-strength automated UI testing tool*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*.
+Kea2 is currently built on top of [Fastbot](https://github.com/ecnusse/Fastbot_Android) 3.0 (a modified/enhanced version of the original [FastBot](https://github.com/bytedance/Fastbot_Android) 2.0), *an industrial-strength automated UI testing tool from ByteDance*, and [uiautomator2](https://github.com/openatx/uiautomator2), *an easy-to-use and stable Android automation library*. 
 Kea2 currently targets [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps. 
 
 ## Novelty & Important features
@@ -75,7 +75,7 @@ Please let us know and willing to hear your feedback/questions if you are also u
 Kea2 currently works with:
 - [unittest](https://docs.python.org/3/library/unittest.html) as the testing framework to manage the scripts;
 - [uiautomator2](https://github.com/openatx/uiautomator2) as the UI test driver; 
-- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool.
+- [Fastbot](https://github.com/bytedance/Fastbot_Android) as the backend automated UI testing tool. 
 
 In the future, Kea2 will be extended to support
 - [pytest](https://docs.pytest.org/en/stable/), another popular python testing framework;
@@ -364,7 +364,7 @@ kea2做了什么：
 
 > Guided, Stochastic Model-Based GUI Testing of Android Apps. ESEC/FSE 2017.  [pdf](https://dl.acm.org/doi/10.1145/3106237.3106298)
 
-### Maintainers/Contributors
+## Maintainers/Contributors
 
 Kea2 has been actively developed and maintained by the people in [ecnusse](https://github.com/ecnusse):
 
@@ -382,7 +382,13 @@ Kea2 has been actively developed and maintained by the people in [ecnusse](https
 
 Kea2 has also received many valuable insights, advices, feedbacks and lessons shared by several industrial people from Bytedance ([Zhao Zhang](https://github.com/zhangzhao4444), Yuhui Su from the Fastbot team), OPay (Tiesong Liu), WeChat (Haochuan Lu, Yuetang Deng), Huawei, Xiaomi and etc. Kudos!
 
-### Star History
+### Become a Contributor!
+
+Kea2 is an open-source project and we are calling for more contributors to join us!
+
+See [Developer guide](DEVELOP.md) for more details.
+
+## Star History
 
 [![Star History Chart](https://api.star-history.com/svg?repos=ecnusse/Kea2&type=Date)](https://www.star-history.com/#ecnusse/Kea2&Date)
 

{kea2_python-1.0.2 → kea2_python-1.0.3}/kea2/keaUtils.py

@@ -255,7 +255,7 @@ def _check_package_installation(packageNames):
     for package in packageNames:
         if package not in installed_packages:
             logger.error(f"package {package} not installed. Abort.")
-            raise ValueError("package not installed")
+            raise ValueError(f"{package} not installed")
 
 
 def _save_bug_report_configs(options: Options):
@@ -600,6 +600,8 @@ class KeaTestRunner(TextTestRunner, KeaOptionSetter):
                     continue
                 validProps[propName] = test
 
+        staticCheckerDriver.clear_cache()
+
         print(f"{len(validProps)} precond satisfied.", flush=True)
         if len(validProps) > 0:
             print("[INFO] Valid properties:",flush=True)

{kea2_python-1.0.2 → kea2_python-1.0.3}/kea2/logWatcher.py

@@ -46,7 +46,7 @@ class LogWatcher:
                 raise RuntimeError(
                     "[Error] Fatal Execption while running fastbot:\n" + 
                     exception_body + 
-                    "\nSee fastbot.log for details."
+                    f"\nSee {self.log_file} for details."
                 )
         
         statistic_match = PATTERN_STATISTIC.search(content)

{kea2_python-1.0.2 → kea2_python-1.0.3}/kea2/report/bug_report_generator.py

@@ -280,7 +280,7 @@ class BugReportGenerator(CrashAnrMixin, PathParserMixin, ScreenshotsMixin):
                 info = step_data.get("Info", {})
 
                 # Count Monkey events separately
-                if step_type == "Monkey":
+                if step_type == "Monkey" or step_type == "Fuzz":
                     monkey_events_count += 1
 
                 # If screenshots are enabled, mark the screenshot

{kea2_python-1.0.2 → kea2_python-1.0.3}/kea2/u2Driver.py

@@ -411,15 +411,25 @@ class _HindenWidgetFilter:
 
 
 class U2StaticDevice(u2.Device):
+    
     def __init__(self, script_driver=None):
         self.xml: etree._Element = None
-        self._script_driver = script_driver
+        self._script_driver:u2.Device = script_driver
+        self._app_current = None
 
     def __call__(self, **kwargs):
         ui = StaticU2UiObject(session=self, selector=u2.Selector(**kwargs))
         if self._script_driver:
             ui.jsonrpc = self._script_driver.jsonrpc
         return ui
+    
+    def clear_cache(self):
+        self._app_current = None
+    
+    def app_current(self):
+        if not self._app_current:
+            self._app_current = self._script_driver.app_current()
+        return self._app_current
 
     @property
     def xpath(self) -> u2.xpath.XPathEntry:

{kea2_python-1.0.2 → kea2_python-1.0.3}/pyproject.toml

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