Kea2-python 0.0.1a3__py3-none-any.whl → 0.0.1a4__py3-none-any.whl

kea2/cli.py

@@ -156,8 +156,8 @@ def main():
             kwargs.pop('args', None)
             sp.add_argument(*args, **kwargs)
 
-    from .kea_launcher import _set_driver_parser
-    _set_driver_parser(subparser)
+    from .kea_launcher import _set_runner_parser
+    _set_runner_parser(subparser)
     actions["run"] = cmd_run
     if sys.argv[1:] == ["run"]:
         sys.argv.append("-h")

kea2/keaUtils.py

@@ -94,6 +94,8 @@ class Options:
     running_mins: int = 10
     # time(ms) to wait when exploring the app
     throttle: int = 200
+    # the output_dir for saving logs and results
+    output_dir: str = "output"
 
 
 @dataclass
@@ -261,6 +263,13 @@ class KeaTestRunner(TextTestRunner):
             options.Driver = None
         cls.options = options
 
+    def _setOuputDir(self):
+        output_dir = Path(self.options.output_dir).absolute()
+        os.mkdir(output_dir, parents=True, exist_ok=True)
+        global LOGFILE, RESFILE
+        LOGFILE = output_dir / Path(LOGFILE)
+        RESFILE = output_dir / Path(RESFILE)
+
     def run(self, test):
 
         self.allProperties = dict()
@@ -269,6 +278,8 @@ class KeaTestRunner(TextTestRunner):
         if len(self.allProperties) == 0:
             print("[Warning] No property has been found.", flush=True)
 
+        self._setOuputDir()
+
         JsonResult.setProperties(self.allProperties)
         self.resultclass = JsonResult
 

kea2/kea_launcher.py

@@ -1,9 +1,11 @@
+import os
 import sys
 import argparse
 import unittest
+from pathlib import Path
 from typing import List
 
-def _set_driver_parser(subparsers: "argparse._SubParsersAction[argparse.ArgumentParser]"):
+def _set_runner_parser(subparsers: "argparse._SubParsersAction[argparse.ArgumentParser]"):
     parser = subparsers.add_parser("run", help="run kea2")
     parser.add_argument(
         "-s",
@@ -23,6 +25,16 @@ def _set_driver_parser(subparsers: "argparse._SubParsersAction[argparse.Argument
         help="The target package names com.example.app",
     )
 
+    parser.add_argument(
+        "-o",
+        "--output-dir",
+        dest="output_dir",
+        type=str,
+        required=False,
+        default="output",
+        help="The output dir for saving logs and results."
+    )
+
     parser.add_argument(
         "--agent",
         dest="agent",
@@ -96,7 +108,7 @@ def parse_args(argv: List):
     parser = argparse.ArgumentParser(description="Kea2")
     subparsers = parser.add_subparsers(dest="command", required=True)
 
-    _set_driver_parser(subparsers)
+    _set_runner_parser(subparsers)
     args = parser.parse_args(argv)
     return args
 

{kea2_python-0.0.1a3.dist-info → kea2_python-0.0.1a4.dist-info}/METADATA

@@ -1,18 +1,18 @@
 Metadata-Version: 2.4
 Name: Kea2-python
-Version: 0.0.1a3
+Version: 0.0.1a4
 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.9
+Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: rtree>=1.4.0
+Requires-Dist: rtree>=1.3.0
 Requires-Dist: uiautomator2>=3.2.9
 Dynamic: license-file
 
 # Introduction 
 
-Kea2 is an easy-to-use Python library for supporting and customizing automated UI testing for mobile apps. The library is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android) and [uiautomator2](https://github.com/openatx/uiautomator2), and targeting [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps.
+Kea2 is an easy-to-use Python library for supporting, customizing and improving automated UI testing for mobile apps. The library is currently built on top of [Fastbot](https://github.com/bytedance/Fastbot_Android) and [uiautomator2](https://github.com/openatx/uiautomator2), and targeting [Android](https://en.wikipedia.org/wiki/Android_(operating_system)) apps.
 
 ### Kea2 has three important features:
 - **Feature 1**(查找稳定性问题): coming with the full capability of [Fastbot](https://github.com/bytedance/Fastbot_Android) for stress testing and finding *stability problems* (i.e., *crashing bugs*); 
@@ -52,7 +52,7 @@ In the future, Kea2 will be extended to support
 
 Running requirements/environment:
 - support Windows, MacOS and Linux
-- python 3.9+
+- python 3.8+
 - Android SDK installed
 - **VPN closed** (Features 2 and 3 required)
 
@@ -99,7 +99,7 @@ kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent native --
 ```
 
 The usage is similar to the the original [Fastbot](https://github.com/bytedance/Fastbot_Android?tab=readme-ov-file#run-fastbot-with-shell-command)'s shell commands. 
-See more options by `python kea_launcher.py driver -h`
+See more options by `kea2 run -h`
 
 
 ## Feature 2(自定义测试场景或事件序列): customizing testing scenarios by scripts
@@ -153,14 +153,13 @@ You can find the full example in script `quickstart.py` and run it by executing:
 python3 quickstart.py u2
 ```
 
+In real use, you can use `kea2 run` to launch the customizing script.
+
 ```bash
 # Launch Kea2 and load one single script quickstart.py.
-kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest quickstart.py
+kea2 run -s "emulator-5554" -p it.feio.android.omninotes.alpha --agent u2 --running-minutes 10 --throttle 200 --driver-name d unittest discover -p quickstart.py
 ```
 
-
-
-
 ## Feature 3(支持断言机制): Supporting auto-assertions by scripts.
 
 Kea2 supports auto-assertions when running Fastbot for finding *logic bugs* (i.e., *non-crashing bugs*). To achieve this, you can add assertions in the scripts. When an assertion fails during automated UI testing, we find a likely functional bug. This idea is inspired by  [property-based testing](https://en.wikipedia.org/wiki/Software_testing#Property_testing) inheritted from [Kea](https://github.com/ecnusse/Kea).

{kea2_python-0.0.1a3.dist-info → kea2_python-0.0.1a4.dist-info}/RECORD

@@ -1,9 +1,9 @@
 kea2/__init__.py,sha256=_IFDiyzb6OLyhjldBXrAol6OpOijTnJ2LYWMK4TqSno,121
 kea2/absDriver.py,sha256=M08ba0kpIer20ApMhX7yCmcLrfPb6a3udZxR_4FhriI,1224
 kea2/adbUtils.py,sha256=IV-5G_3mc89YP1NJZJIWUrgxb13QECGGXTTANkGH_Rk,8986
-kea2/cli.py,sha256=NsHhO_MhAOrjh8ALXQ7MHfvPNIJDLP4p9imZ4_k2jx0,4349
-kea2/keaUtils.py,sha256=W4JEHt1K-0HGWqiIbXg_qjun9rl2mLcYOuSLYiXLhO4,19746
-kea2/kea_launcher.py,sha256=pBjV3Hxv3Sh9MXiV50Afahcb3ebgoY0JQhRTCekOMRU,3916
+kea2/cli.py,sha256=V_TOe-weqc-LvYmf3hGnm5W3_-aa1_swo3rKhOEib4o,4349
+kea2/keaUtils.py,sha256=6ZQIrjhH6rBi9mFUO3qJqRJD42i39nkqlq7D-Z4b5vQ,20126
+kea2/kea_launcher.py,sha256=m58wi1_L4TrvSjIhkYDNVHljBixXoRe7oUvu59rjBtM,4175
 kea2/logWatcher.py,sha256=hd8banPiCa6aCQ6d_MznWKOdzK_A2X_dPbrx-usjxgE,1927
 kea2/u2Driver.py,sha256=NE7Q6OUB9DtoLueZO7ruZoRE3Wp0dp_-R4QHRDLaBvE,10507
 kea2/utils.py,sha256=zjuoVwts2qVX9GnTaPoiqarfcSvyfW6cAD3ESf_dmrQ,1284
@@ -25,9 +25,9 @@ kea2/assets/fastbot_libs/arm64-v8a/libfastbot_native.so,sha256=dA2Tf74-gDrCFdeCl
 kea2/assets/fastbot_libs/armeabi-v7a/libfastbot_native.so,sha256=GWcL8M8WfQAd9CfOM6pRYbOnxeycN-LiL7Mf59YIadE,1334420
 kea2/assets/fastbot_libs/x86/libfastbot_native.so,sha256=k-aw1gEXRWMKZRNHIggKNuZy0wC1y2BnveJGEIO6rbo,2036856
 kea2/assets/fastbot_libs/x86_64/libfastbot_native.so,sha256=tiofhlf4uMQcU5WAvrdLgTBME0lb83hVUoGtTwxmE8A,2121416
-kea2_python-0.0.1a3.dist-info/licenses/LICENSE,sha256=nM9PPjcsXVo5SzNsjRqWgA-gdJlwqZZcRDSC6Qf6bVE,2034
-kea2_python-0.0.1a3.dist-info/METADATA,sha256=vAsWgOGh-EVwRLQzq0sqip-Jg1CB3IcBX95IBNqhsps,19030
-kea2_python-0.0.1a3.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-kea2_python-0.0.1a3.dist-info/entry_points.txt,sha256=mFX06TyxXiUAJQ6JZn8QHzfn8n5R8_KJ5W-pTm_fRCA,39
-kea2_python-0.0.1a3.dist-info/top_level.txt,sha256=TsgNH4PQoNOVhegpO7AcjutMVWp6Z4KDL1pBH9FnMmk,5
-kea2_python-0.0.1a3.dist-info/RECORD,,
+kea2_python-0.0.1a4.dist-info/licenses/LICENSE,sha256=nM9PPjcsXVo5SzNsjRqWgA-gdJlwqZZcRDSC6Qf6bVE,2034
+kea2_python-0.0.1a4.dist-info/METADATA,sha256=jPLHS0mfjMj1RxQY1dKuvGnm7dsc7Z2fTunhz3WLwsk,19100
+kea2_python-0.0.1a4.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+kea2_python-0.0.1a4.dist-info/entry_points.txt,sha256=mFX06TyxXiUAJQ6JZn8QHzfn8n5R8_KJ5W-pTm_fRCA,39
+kea2_python-0.0.1a4.dist-info/top_level.txt,sha256=TsgNH4PQoNOVhegpO7AcjutMVWp6Z4KDL1pBH9FnMmk,5
+kea2_python-0.0.1a4.dist-info/RECORD,,