kyapp 0.0.2__tar.gz

kyapp-0.0.2/PKG-INFO

@@ -0,0 +1,30 @@
+Metadata-Version: 2.4
+Name: kyapp
+Version: 0.0.2
+Summary: 安卓/IOS自动化测试框架
+Home-page: https://gitee.com/bluepang2021/kyapp_project
+Author: 杨康
+Author-email: 772840356@qq.com
+Platform: Android/IOS
+Classifier: Programming Language :: Python :: 3.9
+Requires-Python: >=3.9
+Requires-Dist: click==8.1.7
+Requires-Dist: loguru==0.7.0
+Requires-Dist: PyYAML==6.0.1
+Requires-Dist: allure-pytest==2.9.45
+Requires-Dist: pytest==6.2.5
+Requires-Dist: pytest-xdist==2.5.0
+Requires-Dist: pytest-rerunfailures==10.2
+Requires-Dist: pytest-repeat==0.9.3
+Requires-Dist: uiviewer==1.1.3
+Requires-Dist: uiautomator2==3.2.4
+Requires-Dist: tidevice==0.12.10
+Requires-Dist: facebook-wda==1.5.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: home-page
+Dynamic: platform
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary

kyapp-0.0.2/demo/config.py

@@ -0,0 +1,4 @@
+class Config:
+    EMAIL = 'lute2026@qq.com'
+    PASSWORD = 'lute123456'
+

kyapp-0.0.2/demo/pages/__init__.py

@@ -0,0 +1,4 @@
+"""
+@Author: kang.yang
+@Date: 2024/9/14 09:43
+"""

kyapp-0.0.2/demo/pages/home_page.py

@@ -0,0 +1,9 @@
+from kyapp import Elem, Page
+
+
+class HomePage(Page):
+    me_tab = Elem(
+        title='底部我的tab入口',
+        adr=('resourceId', 'com.lute.momcozy:id/i_me'),
+        ios=('label', 'Me')
+    )

kyapp-0.0.2/demo/pages/login_page.py

@@ -0,0 +1,68 @@
+"""
+@Author: kang.yang
+@Date: 2024/9/14 09:44
+"""
+from config import Config
+from kyapp import Page, Elem, logger
+from pages.home_page import HomePage
+
+
+class LoginPage(Page):
+    reselect_ok = Elem(
+        title='地区偏移提示',
+        adr=('resourceId', 'com.lute.momcozy:id/btnNegative'),
+        ios=('label', 'OK')
+    )
+    welcome_text = Elem(
+        title='欢迎语',
+        adr=('text', 'Welcome to Momcozy'),
+        ios=('text', 'Welcome to Momcozy')
+    )
+    account_input = Elem(
+        title='账号输入框',
+        adr=('resourceId', 'com.lute.momcozy:id/etAccount'),
+        ios=('className', 'TextField'),
+    )
+    pwd_input = Elem(
+        title='密码输入框',
+        adr=('resourceId', 'com.lute.momcozy:id/etPassword'),
+        ios=('className', 'SecureTextField')
+    )
+    login_btn = Elem(
+        title='登录按钮',
+        adr=('resourceId', 'com.lute.momcozy:id/btnLogin'),
+        ios=('label', 'Log In'),
+    )
+
+
+class LoginApi:
+
+    def __init__(self, driver):
+        self.driver = driver
+        self.login_page = LoginPage(self.driver)
+        self.home_page = HomePage(self.driver)
+
+    def login_status_check(self, timeout=5):
+        if self.home_page.me_tab.exists(timeout=timeout):
+            return True
+        return False
+
+    def country_change_dialog_check(self):
+        if self.login_page.reselect_ok.exists():
+            self.login_page.reselect_ok.click()
+
+    def pwd_login(self):
+        self.login_page.account_input.clear()
+        self.login_page.account_input.input(Config.EMAIL)
+        self.login_page.pwd_input.input(Config.PASSWORD)
+        self.login_page.welcome_text.click()
+        self.country_change_dialog_check()
+        self.login_page.login_btn.click()
+
+    def login(self):
+        if self.login_status_check():
+            logger.info('已登录')
+        else:
+            logger.info('未登录，进行登录')
+            self.pwd_login()
+            assert self.login_status_check(timeout=30)

kyapp-0.0.2/demo/run.py

@@ -0,0 +1,17 @@
+"""
+@Author: kang.yang
+@Date: 2024/7/12 17:10
+"""
+import kyapp
+
+
+if __name__ == '__main__':
+    kyapp.main(
+        case_path='tests',
+        did='3B661X0181J00000',
+        pkg='com.lute.momcozy',
+        platform='adr'
+    )
+
+
+

kyapp-0.0.2/demo/tests/test_go_me.py

@@ -0,0 +1,23 @@
+import kyapp
+from pages.login_page import LoginApi
+from pages.home_page import HomePage
+
+class TestAdrDemo(kyapp.TestCase):
+    def start(self):
+        self.start_app(force=True)
+        LoginApi(self.dr).login()
+        self.home_page = HomePage(self.dr)
+
+    def test_go_me(self):
+        self.sleep(10)
+        self.home_page.me_tab.click()
+
+
+
+
+
+
+
+
+
+

kyapp-0.0.2/kyapp/__init__.py

@@ -0,0 +1,13 @@
+from .running.runner import main
+from .running.conf import App
+from .utils.config import FileConfig
+from .utils.pytest_util import *
+from .utils.allure_util import *
+from .utils.log import logger
+from .page import Page
+from .element import Elem
+from .case import TestCase
+
+
+__version__ = "0.0.2"
+__description__ = "安卓/IOS自动化测试框架"

kyapp-0.0.2/kyapp/case.py

@@ -0,0 +1,100 @@
+"""
+@Author: kang.yang
+@Date: 2023/10/26 09:48
+"""
+import time
+
+from .core.adr.driver import Driver as AdrDriver
+from .core.ios.driver import Driver as IosDriver
+
+from .running.conf import App
+from .utils.log import logger
+
+
+class TestCase:
+    """
+    测试用例基类，所有测试用例需要继承该类
+    """
+
+    dr = None
+
+    # ---------------------初始化-------------------------------
+    def start_class(self):
+        """
+        Hook method for setup_class fixture
+        :return:
+        """
+        pass
+
+    def end_class(self):
+        """
+        Hook method for teardown_class fixture
+        :return:
+        """
+        pass
+
+    @classmethod
+    def setup_class(cls):
+        try:
+            cls().start_class()
+        except BaseException as e:
+            logger.error(f"start_class Exception: {e}")
+
+    @classmethod
+    def teardown_class(cls):
+        try:
+            cls().end_class()
+        except BaseException as e:
+            logger.error(f"end_class Exception: {e}")
+
+    def start(self):
+        """
+        Hook method for setup_method fixture
+        :return:
+        """
+        pass
+
+    def end(self):
+        """
+        Hook method for teardown_method fixture
+        :return:
+        """
+        pass
+
+    def setup_method(self):
+        did = App.did
+        pkg = App.pkg
+        if App.platform == 'ios':
+            self.dr = IosDriver(udid=did, bundle_id=pkg)
+        else:
+            self.dr = AdrDriver(serial=did, package=pkg)
+
+        self.start()
+
+    def teardown_method(self):
+        self.end()
+        if App.platform == 'ios':
+            self.dr.close()
+            print('休眠5s，防止释放设备过慢的情况！')
+            self.sleep(5)
+
+    # 公共方法
+    @staticmethod
+    def sleep(n: float):
+        logger.info(f"暂停: {n}s")
+        time.sleep(n)
+
+    def shot(self, name: str, delay=0):
+        if delay:
+            self.sleep(delay)
+        self.dr.shot(name)
+
+    def start_app(self, force=True):
+        if force:
+            self.stop_app()
+        self.dr.start_app()
+
+    def stop_app(self):
+        self.dr.stop_app()
+
+

kyapp-0.0.2/kyapp/cli.py

@@ -0,0 +1,41 @@
+import click
+from . import __version__
+
+@click.group()
+@click.version_option(version=__version__, help="Show version.")
+# 老是变，等最后定下来再搞，目前也没啥用
+def main():
+    pass
+
+
+# @main.command()
+# @click.option('-p', '--platform', help="Specify the platform.")
+# def create(platform):
+#     """
+#     创建新项目，老是变，先注释掉
+#     @param platform: 平台，如api、android、ios、web
+#     @return:
+#     """
+#     create_scaffold(platform)
+
+
+# @main.command()
+# @click.option('-p', '--platform', help="Specify the platform.")
+# @click.option('-u', '--url', help="Specify the url.")
+# def inspector(platform, url):
+#     """
+#     获取元素定位信息
+#     @param platform: 平台，android、ios、web
+#     @param url：针对web，需要录制的页面的url
+#     @return:
+#     """
+#     import os
+#     if platform in ['android', 'ios', 'web']:
+#         os.system('weditor')
+#     elif platform == 'web':
+#         if not url:
+#             raise KeyError('url不能为空')
+#         os.system(f'playwright codegen {url}')
+#     else:
+#         raise KeyError('只支持android、ios、web')
+

kyapp-0.0.2/kyapp/core/__init__.py

@@ -0,0 +1,4 @@
+"""
+@Author: kang.yang
+@Date: 2025/4/8 09:37
+"""

kyapp-0.0.2/kyapp/core/adr/__init__.py

@@ -0,0 +1,13 @@
+from .element import Elem
+from .page import Page
+from .driver import Driver
+from .remote_driver import RemoteDriver
+from .case import TestCase
+
+__all__ = [
+    "Elem",
+    "Page",
+    "Driver",
+    "TestCase",
+    "RemoteDriver"
+]

kyapp-0.0.2/kyapp/core/adr/case.py

@@ -0,0 +1,108 @@
+"""
+@Author: kang.yang
+@Date: 2023/10/26 09:48
+"""
+import time
+
+from .driver import Driver
+from .remote_driver import RemoteDriver
+
+from kyapp.running.conf import App
+from kyapp.utils.log import logger
+
+class TestCase:
+    """
+    测试用例基类，所有测试用例需要继承该类
+    """
+
+    dr = None
+
+    # ---------------------初始化-------------------------------
+    def start_class(self):
+        """
+        Hook method for setup_class fixture
+        :return:
+        """
+        pass
+
+    def end_class(self):
+        """
+        Hook method for teardown_class fixture
+        :return:
+        """
+        pass
+
+    @classmethod
+    def setup_class(cls):
+        try:
+            cls().start_class()
+        except BaseException as e:
+            logger.error(f"start_class Exception: {e}")
+
+    @classmethod
+    def teardown_class(cls):
+        try:
+            cls().end_class()
+        except BaseException as e:
+            logger.error(f"end_class Exception: {e}")
+
+    def start(self):
+        """
+        Hook method for setup_method fixture
+        :return:
+        """
+        pass
+
+    def end(self):
+        """
+        Hook method for teardown_method fixture
+        :return:
+        """
+        pass
+
+    def setup_method(self):
+
+        # 驱动初始化
+        if App.sonic_host is not None:
+            self.dr = RemoteDriver(
+                serial=App.did,
+                package=App.pkg,
+                sonic_host=App.sonic_host,
+                sonic_user=App.sonic_user,
+                sonic_pwd=App.sonic_pwd
+            )
+        else:
+            self.dr = Driver(
+                serial=App.did,
+                package=App.pkg
+            )
+        # 解锁设备
+        self.dr.unlock()
+
+        self.start()
+
+    def teardown_method(self):
+        self.end()
+        if isinstance(self.dr, RemoteDriver):
+            self.dr.close()
+
+    # 公共方法
+    @staticmethod
+    def sleep(n: float):
+        logger.info(f"暂停: {n}s")
+        time.sleep(n)
+
+    def shot(self, name: str, delay=0):
+        if delay:
+            self.sleep(delay)
+        self.dr.shot(name)
+
+    def start_app(self, force=True):
+        if force:
+            self.stop_app()
+        self.dr.start_app()
+
+    def stop_app(self):
+        self.dr.stop_app()
+
+

kyapp-0.0.2/kyapp/core/adr/driver.py

@@ -0,0 +1,154 @@
+import allure
+import uiautomator2 as u2
+
+from kyapp.utils.log import logger
+from kyapp.utils.common import general_file_path
+
+
+class Driver:
+    """
+    u2库代码地址：https://github.com/openatx/uiautomator2
+    """
+
+    def __init__(self, serial: str, package: str = None):
+        """
+        @param serial: 设备序列号，通过adb devices获取，或者通过关于手机-序列号获取
+        @param package: 应用包名，通过adb shell pm list packages获取
+        """
+        logger.info(f"初始化本地设备连接: {serial}")
+        self.package = package
+        self.d = u2.connect(serial)
+
+    def uninstall_app(self, package: str = None):
+        """
+        卸载应用
+        @param package: 应用包名
+        @return:
+        """
+        if self.package is None:
+            if package is None:
+                raise KeyError('package不能为空')
+            else:
+                self.package = package
+        logger.info(f"卸载应用: {self.package}")
+        self.d.app_uninstall(self.package)
+
+    def install_app(self, apk_url, package: str = None):
+        """
+        安装应用
+        @param apk_url: apk链接
+        @param package: 应用包名
+        @return:
+        """
+        if self.package is None:
+            if package is None:
+                raise KeyError('package不能为空')
+            else:
+                self.package = package
+        self.d.app_uninstall(self.package)
+        logger.info(f"安装应用: {apk_url}")
+        self.d.app_install(apk_url)
+
+    def start_app(self, package: str = None):
+        """
+        启动应用
+        @param package: 应用包名
+        @return:
+        """
+        if self.package is None:
+            if package is None:
+                raise KeyError('package不能为空')
+            else:
+                self.package = package
+        logger.info(f"启动应用: {self.package}")
+        self.d.app_start(package_name=self.package, use_monkey=True)
+
+    def stop_app(self, package: str = None):
+        """
+        停止应用
+        @param package: 应用包名
+        @return:
+        """
+        if self.package is None:
+            if package is None:
+                raise KeyError('package不能为空')
+            else:
+                self.package = package
+        logger.info(f"停止应用: {self.package}")
+        self.d.app_stop(self.package)
+
+    def shot(self, file_name: str = None):
+        """
+        截图
+        @param file_name: 截图保存后的文件名
+        @return:
+        """
+        file_path = general_file_path(file_name)
+        logger.info(f"截图保存至: {file_path}")
+        self.d.screenshot(file_path)
+
+        logger.info("截图上传allure报告")
+        allure.attach.file(
+            file_path,
+            attachment_type=allure.attachment_type.PNG,
+            name=f"{file_path}",
+        )
+        return file_path
+
+    def click(self, x, y):
+        """
+        点击坐标
+        @param x: 横坐标
+        @param y: 纵坐标
+        @return:
+        """
+        self.d.click(x, y)
+
+    def input(self, *args, **kwargs):
+        """
+        输入
+        @param args:
+        @param kwargs:
+        @return:
+        """
+        self.d.send_keys(*args, **kwargs)
+
+    def unlock(self):
+        """
+        设备解锁
+        @return:
+        """
+        self.d.unlock()
+
+    def shell(self, *args, **kwargs):
+        """
+        执行adb shell
+        @param args:
+        @param kwargs:
+        @return:
+        """
+        self.d.shell(*args, **kwargs)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+