uiautodev 0.3.3__tar.gz

uiautodev-0.3.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 codeskyblue
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

uiautodev-0.3.3/PKG-INFO

@@ -0,0 +1,56 @@
+Metadata-Version: 2.1
+Name: uiautodev
+Version: 0.3.3
+Summary: Mobile UI Automation, include UI hierarchy inspector, script recorder
+Home-page: https://uiauto.dev
+License: MIT
+Author: codeskyblue
+Author-email: codeskyblue@gmail.com
+Requires-Python: >=3.8,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Provides-Extra: appium
+Requires-Dist: adbutils (>=2.6.0,<3.0.0)
+Requires-Dist: appium-python-client (>=4.0.0,<5.0.0) ; extra == "appium"
+Requires-Dist: click (>=8.1.7,<9.0.0)
+Requires-Dist: construct
+Requires-Dist: fastapi[all] (>=0.109.2,<0.110.0)
+Requires-Dist: httpretty (>=1.1.4,<2.0.0)
+Requires-Dist: lxml
+Requires-Dist: pillow
+Requires-Dist: pygments (>=2)
+Requires-Dist: uiautomator2 (>=3.0.11,<4.0.0)
+Requires-Dist: uvicorn[standard] (>=0.27.1,<0.28.0)
+Description-Content-Type: text/markdown
+
+# uiautodev
+[![codecov](https://codecov.io/gh/codeskyblue/appinspector/graph/badge.svg?token=aLTg4VOyQH)](https://codecov.io/gh/codeskyblue/appinspector)
+[![PyPI version](https://badge.fury.io/py/uiautodev.svg)](https://badge.fury.io/py/uiautodev)
+
+https://uiauto.dev
+
+UI Inspector for Android and iOS, help inspector element properties, and auto generate XPath, script.
+
+
+# DEVELOP
+```bash
+# install poetry (python package manager)
+pip install poetry # pipx install poetry
+
+# install deps
+poetry install
+
+# format import
+make format
+
+# run server
+make dev
+```
+
+# LICENSE
+[MIT](LICENSE)

uiautodev-0.3.3/README.md

@@ -0,0 +1,26 @@
+# uiautodev
+[![codecov](https://codecov.io/gh/codeskyblue/appinspector/graph/badge.svg?token=aLTg4VOyQH)](https://codecov.io/gh/codeskyblue/appinspector)
+[![PyPI version](https://badge.fury.io/py/uiautodev.svg)](https://badge.fury.io/py/uiautodev)
+
+https://uiauto.dev
+
+UI Inspector for Android and iOS, help inspector element properties, and auto generate XPath, script.
+
+
+# DEVELOP
+```bash
+# install poetry (python package manager)
+pip install poetry # pipx install poetry
+
+# install deps
+poetry install
+
+# format import
+make format
+
+# run server
+make dev
+```
+
+# LICENSE
+[MIT](LICENSE)

uiautodev-0.3.3/pyproject.toml

@@ -0,0 +1,41 @@
+[tool.poetry]
+name = "uiautodev"
+version = "0.3.3"
+description = "Mobile UI Automation, include UI hierarchy inspector, script recorder"
+homepage = "https://uiauto.dev"
+authors = ["codeskyblue <codeskyblue@gmail.com>"]
+license = "MIT"
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.8"
+fastapi = {extras = ["all"], version = "^0.109.2"}
+uvicorn = {extras = ["standard"], version = "^0.27.1"}
+pillow = "*"
+adbutils = "^2.6.0"
+construct = "*"
+lxml = "*"
+click = "^8.1.7"
+pygments = ">=2"
+httpretty = {version = "^1.1.4", optional = true}
+appium-python-client = {version = "^4.0.0", optional = true}
+uiautomator2 = "^3.0.11"
+
+[tool.poetry.extras]
+appium = ["appium-python-client", "httppretty"]
+
+[tool.poetry.scripts]
+"uiauto.dev" = "uiautodev.__main__:main"
+"uiautodev" = "uiautodev.__main__:main"
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.0.1"
+isort = "^5.13.2"
+pytest-cov = "^4.1.0"
+
+[tool.poetry-dynamic-versioning] # 根据tag来动态配置版本号
+enable = false
+
+[build-system]
+requires = ["poetry-core>=1.0.0", "poetry-dynamic-versioning>=1.0.0,<2.0.0"]
+build-backend = "poetry_dynamic_versioning.backend"

uiautodev-0.3.3/uiautodev/__init__.py

@@ -0,0 +1,12 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""Created on Mon Mar 04 2024 14:28:53 by codeskyblue
+"""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("uiautodev")
+except PackageNotFoundError:
+    __version__ = "0.0.0"

uiautodev-0.3.3/uiautodev/__main__.py

@@ -0,0 +1,10 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""Created on Sun Feb 18 2024 14:20:15 by codeskyblue
+"""
+
+from uiautodev.cli import main
+
+if __name__ == "__main__":
+    main()

uiautodev-0.3.3/uiautodev/app.py

@@ -0,0 +1,92 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""Created on Sun Feb 18 2024 13:48:55 by codeskyblue
+"""
+
+import logging
+import os
+import platform
+import signal
+from pathlib import Path
+from typing import List
+
+from fastapi import FastAPI
+from fastapi.middleware.cors import CORSMiddleware
+from fastapi.responses import FileResponse, RedirectResponse
+from pydantic import BaseModel
+
+from uiautodev import __version__
+from uiautodev.provider import AndroidProvider, IOSProvider, MockProvider
+from uiautodev.router.device import make_router
+from uiautodev.router.xml import router as xml_router
+
+logger = logging.getLogger(__name__)
+
+app = FastAPI()
+
+app.add_middleware(
+    CORSMiddleware,
+    allow_origins=["*"],
+    allow_credentials=True,
+    allow_methods=["GET", "POST"],
+    allow_headers=["*"],
+)
+
+android_router = make_router(AndroidProvider())
+ios_router = make_router(IOSProvider())
+mock_router = make_router(MockProvider())
+
+app.include_router(mock_router, prefix="/api/mock", tags=["mock"])
+
+if os.environ.get("UIAUTODEV_MOCK"):
+    app.include_router(mock_router, prefix="/api/android", tags=["mock"])
+    app.include_router(mock_router, prefix="/api/ios", tags=["mock"])
+else:
+    app.include_router(android_router, prefix="/api/android", tags=["android"])
+    app.include_router(ios_router, prefix="/api/ios", tags=["ios"])
+
+app.include_router(xml_router, prefix="/api/xml", tags=["xml"])
+
+
+class InfoResponse(BaseModel):
+    version: str
+    description: str
+    platform: str
+    code_language: str
+    cwd: str
+    drivers: List[str]
+
+
+@app.get("/api/info")
+def info() -> InfoResponse:
+    """Information about the application"""
+    return InfoResponse(
+        version=__version__,
+        description="client for https://uiauto.dev",
+        platform=platform.system(),  # Linux | Darwin | Windows
+        code_language="Python",
+        cwd=os.getcwd(),
+        drivers=["android"],
+    )
+
+
+@app.get("/shutdown")
+def shutdown() -> str:
+    """Shutdown the server"""
+    os.kill(os.getpid(), signal.SIGINT)
+    return "Server shutting down..."
+
+
+@app.get("/demo")
+def demo() -> str:
+    """Demo endpoint"""
+    static_dir = Path(__file__).parent / "static"
+    print(static_dir / "demo.html")
+    return FileResponse(static_dir / "demo.html")
+
+
+@app.get("/")
+def index_redirect():
+    """ redirect to official homepage """
+    return RedirectResponse("https://uiauto.dev")

uiautodev-0.3.3/uiautodev/appium_proxy.py

@@ -0,0 +1,53 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""Created on Tue Mar 19 2024 22:23:37 by codeskyblue
+"""
+
+import sys
+
+import httpx
+from fastapi import FastAPI, Request, Response
+
+app = FastAPI()
+
+
+# Retrieve the target URL from the command line arguments
+try:
+    TARGET_URL = sys.argv[1]
+except IndexError:
+    print("Usage: python proxy_server.py <target_url>")
+    sys.exit(1)
+
+@app.api_route("/{path:path}", methods=["GET", "POST", "PUT", "DELETE", "OPTIONS", "HEAD", "PATCH", "TRACE"])
+async def proxy(request: Request, path: str):
+    # Construct the full URL to forward the request to
+    if path.endswith('/execute/sync'):
+        # 旧版appium处理不好这个请求，直接返回404, unknown command
+        # 目前browserstack也不支持这个请求
+        return Response(content=b'{"value": {"error": "unknown command", "message": "unknown command", "stacktrace": "UnknownCommandError"}}', status_code=404)
+    full_url = f"{TARGET_URL}/{path}"
+    body = await request.body()
+    print("Forwarding to", request.method, full_url)
+    print("==> BODY <==")
+    print(body)
+    # Include original headers in the request
+    headers = {k: v for k, v in request.headers.items() if k != 'host'}
+
+    # Forward the request to the target server
+    async with httpx.AsyncClient(timeout=120) as client:
+        resp = await client.request(
+            method=request.method,
+            url=full_url,
+            headers=headers,
+            data=body,
+            follow_redirects=True,        
+        )
+
+    # Return the response received from the target server
+    return Response(content=resp.content, status_code=resp.status_code, headers=dict(resp.headers))
+
+
+if __name__ == "__main__":
+    import uvicorn
+    uvicorn.run(app, host="0.0.0.0", port=8000)

uiautodev-0.3.3/uiautodev/case.py

@@ -0,0 +1,137 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""Created on Sat Apr 13 2024 22:35:03 by codeskyblue
+"""
+
+import enum
+import logging
+from typing import Dict, Union
+
+from pydantic import BaseModel
+
+from uiautodev import command_proxy
+from uiautodev.command_types import Command
+from uiautodev.driver.base_driver import BaseDriver
+from uiautodev.provider import AndroidProvider
+
+logger = logging.getLogger(__name__)
+
+class CommandStep(BaseModel):
+    method: Union[str, Command]
+    params: Dict[str, str]
+    skip: bool = False
+    ignore_error: bool = False
+
+
+class CompareEnum(str, enum.Enum):
+    EQUAL = "equal"
+    CONTAINS = "contains"
+    NOT_EQUAL = "not_equal"
+    NOT_CONTAINS = "not_contains"
+
+
+class CompareCheckStep(BaseModel):
+    method: CompareEnum
+    value_a: str
+    value_b: str
+    skip: bool = False
+
+
+def run_driver_command(driver: BaseDriver, command: Command, params: dict):
+    model = command_proxy.get_command_params_type(command)
+    params_obj = model.model_validate(params) if params else None
+    # print("Params:", params, params_obj)
+    result = command_proxy.send_command(driver, command, params_obj)
+    return result
+
+def run():
+    # all params key and value should be string
+    # Step中
+    # 入参类型在为前端保存一份，后端需要同步兼容
+    # params所有的key和value都是string类型
+    # 出参类型支持重命名 result
+    # - key: string, old_key: string, desc: string
+    # eg. "WIDTH", "width", "屏幕宽度"
+    steps = [
+        CommandStep(
+            method=Command.APP_LAUNCH,
+            params= {
+                "package": "com.saucelabs.mydemoapp.android",
+                "stop": "true" # bool
+            }
+        ),
+        CommandStep(
+            method=Command.GET_WINDOW_SIZE,
+            result_trans=[
+                dict(key="WIDTH", result_key="width", desc="屏幕宽度"),
+            ]
+        ),
+        CommandStep(
+            method=Command.ECHO,
+            params={
+                "message": "WindowWidth is {{WIDTH}}", 
+            }
+        ),
+        CommandStep(
+            method=Command.CLICK_ELEMENT,
+            params={
+                "by": "id",
+                "value": "com.saucelabs.mydemoapp.android:id/productIV",
+            }
+        ),
+        CommandStep(
+            method=Command.CLICK_ELEMENT,
+            params={
+                "by": "id",
+                "value": "com.saucelabs.mydemoapp.android:id/plusIV",
+            }
+        ),
+        CommandStep(
+            method=Command.CLICK_ELEMENT,
+            params={
+                "by": "id",
+                "value": "com.saucelabs.mydemoapp.android:id/cartBt",
+            }
+        ),
+        CommandStep(
+            method=Command.CLICK_ELEMENT,
+            params={
+                "by": "id",
+                "value": "com.saucelabs.mydemoapp.android:id/cartIV",
+            }
+        ),
+        CommandStep(
+            method=Command.FIND_ELEMENT,
+            params={
+                "by": "text",
+                "value": "Proceed To Checkout",
+            },
+            skip=True,
+        ),
+        CompareCheckStep(
+            method=CompareEnum.EQUAL,
+            value_a="$.name",
+            value_b="com.saucelabs.mydemoapp.android:id/cartIV",
+        ),
+        CommandStep(
+            method=Command.CLICK_ELEMENT,
+            params={
+                "by": "text",
+                "value": "Proceed To Checkout",
+            }
+        ),
+    ]
+    provider = AndroidProvider()
+    driver = provider.get_single_device_driver()
+    local_vars: Dict[str, str] = {}
+    for step in steps:
+        if not isinstance(step, CommandStep):
+            continue
+        command = Command(step.method)
+        params = step.params
+        print(step.method, params)
+        if step.skip:
+            logger.debug("Skip step: %s", step.method)
+            continue
+        run_driver_command(driver, command, params)

uiautodev-0.3.3/uiautodev/cli.py

@@ -0,0 +1,171 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+
+"""Created on Tue Mar 19 2024 10:53:03 by codeskyblue
+"""
+
+from __future__ import annotations
+
+import logging
+import platform
+import sys
+import threading
+import time
+from pprint import pprint
+
+import click
+import httpx
+import pydantic
+import uvicorn
+
+from uiautodev import __version__, command_proxy
+from uiautodev.command_types import Command
+from uiautodev.provider import AndroidProvider, BaseProvider, IOSProvider
+from uiautodev.utils.common import convert_params_to_model, print_json
+
+logger = logging.getLogger(__name__)
+
+
+@click.group()
+@click.option("--verbose", "-v", is_flag=True, default=False, help="verbose mode")
+def cli(verbose: bool):
+    if verbose:
+        root_logger = logging.getLogger(__name__.split(".")[0])
+        root_logger.setLevel(logging.DEBUG)
+
+        console_handler = logging.StreamHandler()
+        console_handler.setLevel(logging.DEBUG)
+        
+        formatter = logging.Formatter('%(name)s - %(levelname)s - %(message)s')
+        console_handler.setFormatter(formatter)
+
+        root_logger.addHandler(console_handler)
+        logger.debug("Verbose mode enabled")
+
+
+def run_driver_command(provider: BaseProvider, command: Command, params: list[str] = None):
+    if command == Command.LIST:
+        devices = provider.list_devices()
+        print("==> Devices <==")
+        pprint(devices)
+        return
+    driver = provider.get_single_device_driver()
+    params_obj = None
+    model = command_proxy.get_command_params_type(command)
+    if model:
+        if not params:
+            print(f"params is required for {command}")
+            pprint(model.model_json_schema())
+            return
+        params_obj = convert_params_to_model(params, model)
+
+    try:
+        print("Command:", command.value)
+        print("Params ↓")
+        print_json(params_obj)
+        result = command_proxy.send_command(driver, command, params_obj)
+        print("Result ↓")
+        print_json(result)
+    except pydantic.ValidationError as e:
+        print(f"params error: {e}")
+        print(f"\n--- params should be match schema ---")
+        pprint(model.model_json_schema()["properties"])
+
+
+@cli.command(help="COMMAND: " + ", ".join(c.value for c in Command))
+@click.argument("command", type=Command, required=True)
+@click.argument("params", required=False, nargs=-1)
+def android(command: Command, params: list[str] = None):
+    provider = AndroidProvider()
+    run_driver_command(provider, command, params)
+
+
+@cli.command(help="COMMAND: " + ", ".join(c.value for c in Command))
+@click.argument("command", type=Command, required=True)
+@click.argument("params", required=False, nargs=-1)
+def ios(command: Command, params: list[str] = None):
+    provider = IOSProvider()
+    run_driver_command(provider, command, params)
+
+
+@cli.command(help="run case (beta)")
+def case():
+    from uiautodev.case import run
+    run()
+
+
+@cli.command(help="COMMAND: " + ", ".join(c.value for c in Command))
+@click.argument("command", type=Command, required=True)
+@click.argument("params", required=False, nargs=-1)
+def appium(command: Command, params: list[str] = None):
+    from uiautodev.driver.appium import AppiumProvider
+    from uiautodev.exceptions import AppiumDriverException
+    
+    provider = AppiumProvider()
+    try:
+        run_driver_command(provider, command, params)
+    except AppiumDriverException as e:
+        print(f"Error: {e}")
+
+
+@cli.command('version')
+def print_version():
+    print(__version__)
+
+
+@cli.command(help="start uiauto.dev local server [default]")
+@click.option("--port", default=20242, help="port number", show_default=True)
+@click.option("--host", default="127.0.0.1", help="host", show_default=True)
+@click.option("--reload", is_flag=True, default=False, help="auto reload, dev only")
+@click.option("-f", "--force", is_flag=True, default=False, help="shutdown alrealy runningserver")
+@click.option("--no-browser", is_flag=True, default=False, help="do not open browser")
+def server(port: int, host: str, reload: bool, force: bool, no_browser: bool):
+    logger.info("version: %s", __version__)
+    if force:
+        try:
+            httpx.get(f"http://{host}:{port}/shutdown", timeout=3)
+        except httpx.HTTPError:
+            pass
+
+    use_color = True
+    if platform.system() == 'Windows':
+        use_color = False
+    
+    if not no_browser:
+        th = threading.Thread(target=open_browser_when_server_start, args=(f"http://{host}:{port}",))
+        th.daemon = True
+        th.start()
+    uvicorn.run("uiautodev.app:app", host=host, port=port, reload=reload, use_colors=use_color)
+
+
+def open_browser_when_server_start(server_url: str):
+    deadline = time.time() + 10
+    while time.time() < deadline:
+        try:
+            httpx.get(f"{server_url}/api/info", timeout=1)
+            break
+        except Exception as e:
+            time.sleep(0.5)
+    import webbrowser
+    web_url = "https://uiauto.dev"
+    logger.info("open browser: %s", web_url)
+    webbrowser.open(web_url)
+
+def main():
+    # set logger level to INFO
+    # logging.basicConfig(level=logging.INFO)
+    logger.setLevel(logging.INFO)
+
+    has_command = False
+    for name in sys.argv[1:]:
+        if not name.startswith("-"):
+            has_command = True
+
+    if not has_command:
+        cli.main(args=sys.argv[1:] + ["server"], prog_name="uiauto.dev")
+    else:
+        cli()
+
+
+if __name__ == "__main__":
+    main()