kdtest-pw 2.0.0__py3-none-any.whl

kdtest_pw/data/init_data.py

@@ -0,0 +1,105 @@
+"""参数初始化模块"""
+
+from typing import Dict, Any, Optional
+from pathlib import Path
+
+from ..reference import GSDSTORE, MODULEDATA, INFO
+
+
+class InitData:
+    """参数初始化类
+
+    负责初始化测试所需的各类数据。
+    """
+
+    def __init__(self, work_path: str = None):
+        """初始化
+
+        Args:
+            work_path: 工作目录路径
+        """
+        self._work_path = Path(work_path) if work_path else Path.cwd()
+        self._element_data: Dict[str, Any] = {}
+        self._custom_params: Dict[str, Any] = {}
+
+    def load_element_data(self, file_path: str = None) -> Dict[str, Any]:
+        """加载元素数据
+
+        Args:
+            file_path: elementData.yaml 文件路径
+
+        Returns:
+            Dict: 元素数据
+        """
+        if not file_path:
+            # 默认路径
+            file_path = self._work_path / 'data' / 'elementData' / 'elementData.yaml'
+
+        path = Path(file_path)
+        if not path.exists():
+            INFO(f"元素数据文件不存在: {file_path}", "WARNING")
+            return {}
+
+        try:
+            import yaml
+            with open(path, 'r', encoding='utf-8') as f:
+                self._element_data = yaml.safe_load(f) or {}
+
+            MODULEDATA['elementData'] = self._element_data
+            INFO(f"加载元素数据: {len(self._element_data)} 个模块")
+
+        except ImportError:
+            INFO("PyYAML 未安装，无法加载元素数据", "WARNING")
+        except Exception as e:
+            INFO(f"加载元素数据失败: {e}", "ERROR")
+
+        return self._element_data
+
+    def load_custom_params(self, params: Dict[str, Any] = None) -> Dict[str, Any]:
+        """加载自定义参数
+
+        Args:
+            params: 自定义参数字典
+
+        Returns:
+            Dict: 自定义参数
+        """
+        if params:
+            self._custom_params.update(params)
+            GSDSTORE['START']['selfDefinedParameter'] = self._custom_params
+            INFO(f"加载自定义参数: {list(params.keys())}")
+
+        return self._custom_params
+
+    def setup_work_path(self) -> None:
+        """设置工作路径"""
+        GSDSTORE['WORKPATH'] = {
+            'root': str(self._work_path),
+            'data': str(self._work_path / 'data'),
+            'result': str(self._work_path / 'result'),
+            'plugins': str(self._work_path / 'plugins'),
+        }
+
+        # 确保目录存在
+        (self._work_path / 'result' / 'report').mkdir(parents=True, exist_ok=True)
+        (self._work_path / 'result' / 'log').mkdir(parents=True, exist_ok=True)
+        (self._work_path / 'result' / 'screenshot').mkdir(parents=True, exist_ok=True)
+        (self._work_path / 'result' / 'trace').mkdir(parents=True, exist_ok=True)
+        (self._work_path / 'result' / 'video').mkdir(parents=True, exist_ok=True)
+
+        INFO(f"工作目录: {self._work_path}")
+
+    @property
+    def element_data(self) -> Dict[str, Any]:
+        """获取元素数据"""
+        return self._element_data
+
+    @property
+    def custom_params(self) -> Dict[str, Any]:
+        """获取自定义参数"""
+        return self._custom_params
+
+    @property
+    def work_path(self) -> Path:
+        """获取工作路径"""
+        return self._work_path

kdtest_pw/data/static/elementData.yaml

@@ -0,0 +1,59 @@
+# KDTest Playwright 元素数据模板
+# 格式: element_name: [定位类型, 定位表达式]
+
+# 示例：登录模块
+login:
+  # 用户名输入框
+  userName:
+    - xpath
+    - //input[@placeholder='请输入账号']
+  # 密码输入框
+  password:
+    - xpath
+    - //input[@placeholder='请输入密码']
+  # 登录按钮
+  submitBtn:
+    - css
+    - .el-button--primary
+  # 记住我复选框
+  rememberMe:
+    - css
+    - .el-checkbox
+
+# 示例：首页模块
+home:
+  # 欢迎文字
+  welcomeText:
+    - css
+    - .welcome-text
+  # 菜单列表
+  menuList:
+    - css
+    - .el-menu
+  # 退出按钮
+  logoutBtn:
+    - xpath
+    - //span[text()='退出']
+
+# 示例：用户管理模块
+userManage:
+  # 搜索输入框
+  searchInput:
+    - css
+    - .el-input__inner
+  # 搜索按钮
+  searchBtn:
+    - xpath
+    - //button[contains(.,'搜索')]
+  # 新增按钮
+  addBtn:
+    - xpath
+    - //button[contains(.,'新增')]
+  # 用户表格
+  userTable:
+    - css
+    - .el-table
+  # 状态下拉框
+  statusSelect:
+    - xpath
+    - //div[contains(@class,'el-select')]

kdtest_pw/data/static/parameters.json

@@ -0,0 +1,24 @@
+{
+    "testCaseFile": [
+        {
+            "caseFilePath": "data/static/testCases.xlsx",
+            "caseItem": ["Sheet1"],
+            "interfaceSwitch": false
+        }
+    ],
+    "browser": "chromium",
+    "url": "http://localhost:8080",
+    "headless": false,
+    "slowMo": 0,
+    "timeout": 30000,
+    "trace": false,
+    "video": false,
+    "retrySwitch": false,
+    "retryCount": 1,
+    "parallel": false,
+    "selfDefinedParameter": {
+        "env": "test",
+        "username": "admin",
+        "password": "123456"
+    }
+}

kdtest_pw/plugins/__init__.py

@@ -0,0 +1,6 @@
+"""插件模块"""
+
+from .plugin_base import PluginBase
+from .plugin_loader import PluginLoader
+
+__all__ = ['PluginBase', 'PluginLoader']

kdtest_pw/plugins/element_plus_plugin/__init__.py

@@ -0,0 +1,5 @@
+"""Element Plus 内置插件"""
+
+from .element_plus_plugin import ElementPlusPlugin
+
+__all__ = ['ElementPlusPlugin']

kdtest_pw/plugins/element_plus_plugin/elementData/elementData.yaml

@@ -0,0 +1,144 @@
+# Element Plus 通用元素定义模板
+# 格式: element_name: [定位类型, 定位表达式]
+
+# 登录模块示例
+login:
+  userName:
+    - xpath
+    - //input[@placeholder='请输入账号']
+  password:
+    - xpath
+    - //input[@placeholder='请输入密码']
+  submitBtn:
+    - css
+    - .el-button--primary
+  rememberMe:
+    - css
+    - .el-checkbox
+
+# 通用组件
+common:
+  # Loading 遮罩
+  loadingMask:
+    - css
+    - .el-loading-mask
+  # 消息提示
+  message:
+    - css
+    - .el-message
+  messageContent:
+    - css
+    - .el-message__content
+  # 确认对话框
+  messageBox:
+    - css
+    - .el-message-box
+  messageBoxConfirm:
+    - css
+    - .el-message-box__btns .el-button--primary
+  messageBoxCancel:
+    - css
+    - .el-message-box__btns .el-button:not(.el-button--primary)
+  # 对话框
+  dialog:
+    - css
+    - .el-dialog
+  dialogClose:
+    - css
+    - .el-dialog__headerbtn
+  dialogConfirm:
+    - css
+    - .el-dialog__footer .el-button--primary
+  dialogCancel:
+    - css
+    - .el-dialog__footer .el-button:not(.el-button--primary)
+
+# 表单组件
+form:
+  input:
+    - css
+    - .el-input__inner
+  textarea:
+    - css
+    - .el-textarea__inner
+  select:
+    - css
+    - .el-select
+  selectDropdown:
+    - css
+    - .el-select-dropdown:visible
+  selectOption:
+    - css
+    - .el-select-dropdown__item
+  datepicker:
+    - css
+    - .el-date-editor
+  checkbox:
+    - css
+    - .el-checkbox
+  radio:
+    - css
+    - .el-radio
+  switch:
+    - css
+    - .el-switch
+
+# 表格组件
+table:
+  table:
+    - css
+    - .el-table
+  tableRow:
+    - css
+    - .el-table__row
+  tableCell:
+    - css
+    - .el-table__cell
+  tableHeader:
+    - css
+    - .el-table__header-wrapper th
+  tableCheckbox:
+    - css
+    - .el-table__row .el-checkbox
+  tableHeaderCheckbox:
+    - css
+    - .el-table__header-wrapper .el-checkbox
+
+# 树形控件
+tree:
+  tree:
+    - css
+    - .el-tree
+  treeNode:
+    - css
+    - .el-tree-node
+  treeLabel:
+    - css
+    - .el-tree-node__label
+  treeExpand:
+    - css
+    - .el-tree-node__expand-icon
+  treeCheckbox:
+    - css
+    - .el-tree-node .el-checkbox
+
+# 分页组件
+pagination:
+  pagination:
+    - css
+    - .el-pagination
+  prevBtn:
+    - css
+    - .el-pagination .btn-prev
+  nextBtn:
+    - css
+    - .el-pagination .btn-next
+  pageNumber:
+    - css
+    - .el-pagination .number
+  pageSizeSelect:
+    - css
+    - .el-pagination .el-select
+  jumper:
+    - css
+    - .el-pagination__jump .el-input__inner

kdtest_pw/plugins/element_plus_plugin/element_plus_plugin.py

@@ -0,0 +1,237 @@
+"""Element Plus 内置插件"""
+
+from pathlib import Path
+from playwright.sync_api import Page
+
+from ..plugin_base import PluginBase
+from ...action.element_plus import (
+    ElSelectKeyword,
+    ElDatePickerKeyword,
+    ElDialogKeyword,
+    ElTableKeyword,
+    ElCascaderKeyword,
+    ElTreeKeyword,
+    ElUploadKeyword,
+    ElFormKeyword,
+    ElMenuKeyword,
+)
+
+
+class ElementPlusPlugin(PluginBase):
+    """Element Plus 组件关键字插件
+
+    提供 Element Plus UI 组件的操作关键字。
+    """
+
+    name = "element_plus"
+    version = "2.0.0"
+    description = "Element Plus UI 组件关键字"
+    author = "KDTest Team"
+
+    def __init__(self, page: Page = None):
+        super().__init__(page)
+        self._el_select: ElSelectKeyword = None
+        self._el_datepicker: ElDatePickerKeyword = None
+        self._el_dialog: ElDialogKeyword = None
+        self._el_table: ElTableKeyword = None
+        self._el_cascader: ElCascaderKeyword = None
+        self._el_tree: ElTreeKeyword = None
+        self._el_upload: ElUploadKeyword = None
+        self._el_form: ElFormKeyword = None
+        self._el_menu: ElMenuKeyword = None
+
+    def setup(self) -> None:
+        """初始化插件"""
+        # 加载配置
+        config_path = Path(__file__).parent / "my.ini"
+        if config_path.exists():
+            self.load_config_from_file(str(config_path))
+
+        # 加载元素数据
+        element_data_path = Path(__file__).parent / "elementData" / "elementData.yaml"
+        if element_data_path.exists():
+            self.load_element_data_from_file(str(element_data_path))
+
+        # 初始化关键字类
+        if self._page:
+            self._init_keyword_classes()
+
+        # 注册关键字
+        self._register_keywords()
+
+    def _init_keyword_classes(self) -> None:
+        """初始化关键字类实例"""
+        self._el_select = ElSelectKeyword(self._page)
+        self._el_datepicker = ElDatePickerKeyword(self._page)
+        self._el_dialog = ElDialogKeyword(self._page)
+        self._el_table = ElTableKeyword(self._page)
+        self._el_cascader = ElCascaderKeyword(self._page)
+        self._el_tree = ElTreeKeyword(self._page)
+        self._el_upload = ElUploadKeyword(self._page)
+        self._el_form = ElFormKeyword(self._page)
+        self._el_menu = ElMenuKeyword(self._page)
+
+    def _register_keywords(self) -> None:
+        """注册所有关键字"""
+        # Select 关键字
+        self.register_keywords({
+            'el_select': self._wrap('_el_select', 'el_select'),
+            'el_select_multiple': self._wrap('_el_select', 'el_select_multiple'),
+            'el_select_clear': self._wrap('_el_select', 'el_select_clear'),
+            'el_select_search': self._wrap('_el_select', 'el_select_search'),
+            'el_select_get_value': self._wrap('_el_select', 'el_select_get_value'),
+            'el_select_assert': self._wrap('_el_select', 'el_select_assert'),
+        })
+
+        # DatePicker 关键字
+        self.register_keywords({
+            'el_datepicker': self._wrap('_el_datepicker', 'el_datepicker'),
+            'el_datepicker_panel': self._wrap('_el_datepicker', 'el_datepicker_panel'),
+            'el_datepicker_today': self._wrap('_el_datepicker', 'el_datepicker_today'),
+            'el_datetimepicker': self._wrap('_el_datepicker', 'el_datetimepicker'),
+            'el_daterange': self._wrap('_el_datepicker', 'el_daterange'),
+            'el_datepicker_clear': self._wrap('_el_datepicker', 'el_datepicker_clear'),
+            'el_datepicker_get_value': self._wrap('_el_datepicker', 'el_datepicker_get_value'),
+        })
+
+        # Dialog 关键字
+        self.register_keywords({
+            'el_dialog_wait': self._wrap('_el_dialog', 'el_dialog_wait'),
+            'el_dialog_close': self._wrap('_el_dialog', 'el_dialog_close'),
+            'el_dialog_confirm': self._wrap('_el_dialog', 'el_dialog_confirm'),
+            'el_dialog_cancel': self._wrap('_el_dialog', 'el_dialog_cancel'),
+            'el_dialog_input': self._wrap('_el_dialog', 'el_dialog_input'),
+            'el_message_box_wait': self._wrap('_el_dialog', 'el_message_box_wait'),
+            'el_message_box_confirm': self._wrap('_el_dialog', 'el_message_box_confirm'),
+            'el_message_box_input': self._wrap('_el_dialog', 'el_message_box_input'),
+            'el_message_wait': self._wrap('_el_dialog', 'el_message_wait'),
+            'el_message_get_text': self._wrap('_el_dialog', 'el_message_get_text'),
+            'el_message_assert': self._wrap('_el_dialog', 'el_message_assert'),
+            'el_notification_wait': self._wrap('_el_dialog', 'el_notification_wait'),
+            'el_notification_close': self._wrap('_el_dialog', 'el_notification_close'),
+            'el_drawer_wait': self._wrap('_el_dialog', 'el_drawer_wait'),
+            'el_drawer_close': self._wrap('_el_dialog', 'el_drawer_close'),
+        })
+
+        # Table 关键字
+        self.register_keywords({
+            'el_table_click_row': self._wrap('_el_table', 'el_table_click_row'),
+            'el_table_click_cell': self._wrap('_el_table', 'el_table_click_cell'),
+            'el_table_get_cell_text': self._wrap('_el_table', 'el_table_get_cell_text'),
+            'el_table_get_row_count': self._wrap('_el_table', 'el_table_get_row_count'),
+            'el_table_select_row': self._wrap('_el_table', 'el_table_select_row'),
+            'el_table_select_rows': self._wrap('_el_table', 'el_table_select_rows'),
+            'el_table_sort': self._wrap('_el_table', 'el_table_sort'),
+            'el_table_expand_row': self._wrap('_el_table', 'el_table_expand_row'),
+            'el_table_click_button': self._wrap('_el_table', 'el_table_click_button'),
+            'el_table_search_row': self._wrap('_el_table', 'el_table_search_row'),
+            'el_table_assert_cell': self._wrap('_el_table', 'el_table_assert_cell'),
+        })
+
+        # Cascader 关键字
+        self.register_keywords({
+            'el_cascader': self._wrap('_el_cascader', 'el_cascader'),
+            'el_cascader_search': self._wrap('_el_cascader', 'el_cascader_search'),
+            'el_cascader_clear': self._wrap('_el_cascader', 'el_cascader_clear'),
+            'el_cascader_get_value': self._wrap('_el_cascader', 'el_cascader_get_value'),
+            'el_cascader_assert': self._wrap('_el_cascader', 'el_cascader_assert'),
+        })
+
+        # Tree 关键字
+        self.register_keywords({
+            'el_tree_click_node': self._wrap('_el_tree', 'el_tree_click_node'),
+            'el_tree_expand_node': self._wrap('_el_tree', 'el_tree_expand_node'),
+            'el_tree_collapse_node': self._wrap('_el_tree', 'el_tree_collapse_node'),
+            'el_tree_check_node': self._wrap('_el_tree', 'el_tree_check_node'),
+            'el_tree_check_nodes': self._wrap('_el_tree', 'el_tree_check_nodes'),
+            'el_tree_expand_all': self._wrap('_el_tree', 'el_tree_expand_all'),
+            'el_tree_collapse_all': self._wrap('_el_tree', 'el_tree_collapse_all'),
+            'el_tree_search': self._wrap('_el_tree', 'el_tree_search'),
+            'el_tree_assert_node_exists': self._wrap('_el_tree', 'el_tree_assert_node_exists'),
+        })
+
+        # Upload 关键字
+        self.register_keywords({
+            'el_upload': self._wrap('_el_upload', 'el_upload'),
+            'el_upload_drag': self._wrap('_el_upload', 'el_upload_drag'),
+            'el_upload_remove': self._wrap('_el_upload', 'el_upload_remove'),
+            'el_upload_clear': self._wrap('_el_upload', 'el_upload_clear'),
+            'el_upload_preview': self._wrap('_el_upload', 'el_upload_preview'),
+            'el_upload_get_file_count': self._wrap('_el_upload', 'el_upload_get_file_count'),
+            'el_upload_assert_count': self._wrap('_el_upload', 'el_upload_assert_count'),
+            'el_upload_wait_success': self._wrap('_el_upload', 'el_upload_wait_success'),
+        })
+
+        # Form 关键字
+        self.register_keywords({
+            'el_form_input': self._wrap('_el_form', 'el_form_input'),
+            'el_form_select': self._wrap('_el_form', 'el_form_select'),
+            'el_form_date': self._wrap('_el_form', 'el_form_date'),
+            'el_form_checkbox': self._wrap('_el_form', 'el_form_checkbox'),
+            'el_form_radio': self._wrap('_el_form', 'el_form_radio'),
+            'el_form_switch': self._wrap('_el_form', 'el_form_switch'),
+            'el_form_submit': self._wrap('_el_form', 'el_form_submit'),
+            'el_form_reset': self._wrap('_el_form', 'el_form_reset'),
+            'el_form_get_error': self._wrap('_el_form', 'el_form_get_error'),
+            'el_form_assert_error': self._wrap('_el_form', 'el_form_assert_error'),
+            'el_form_fill': self._wrap('_el_form', 'el_form_fill'),
+        })
+
+        # Menu 菜单导航关键字
+        self.register_keywords({
+            'menu_load_data': self._wrap('_el_menu', 'load_menu_data'),
+            'menu_navigate': self._wrap('_el_menu', 'menu_navigate'),
+            'menu_click_first': self._wrap('_el_menu', 'menu_click_first'),
+            'menu_click_second': self._wrap('_el_menu', 'menu_click_second'),
+            'menu_click_third': self._wrap('_el_menu', 'menu_click_third'),
+            'menu_click_tag': self._wrap('_el_menu', 'menu_click_tag'),
+            'menu_switch_iframe': self._wrap('_el_menu', 'menu_switch_iframe'),
+            'menu_exit_iframe': self._wrap('_el_menu', 'menu_exit_iframe'),
+            'menu_get_first_menus': self._wrap('_el_menu', 'menu_get_first_menus'),
+            'menu_get_second_menus': self._wrap('_el_menu', 'menu_get_second_menus'),
+            'menu_get_tag_count': self._wrap('_el_menu', 'menu_get_tag_count'),
+            'menu_has_iframe': self._wrap('_el_menu', 'menu_has_iframe'),
+            'menu_get_iframe_name': self._wrap('_el_menu', 'menu_get_iframe_name'),
+        })
+
+    def _wrap(self, instance_name: str, method_name: str):
+        """包装方法调用
+
+        Args:
+            instance_name: 实例属性名
+            method_name: 方法名
+
+        Returns:
+            包装后的函数
+        """
+        def wrapper(*args, **kwargs):
+            instance = getattr(self, instance_name)
+            if instance is None:
+                if self._page:
+                    self._init_keyword_classes()
+                    instance = getattr(self, instance_name)
+                else:
+                    raise RuntimeError("Page 实例未设置")
+
+            method = getattr(instance, method_name)
+            return method(*args, **kwargs)
+
+        return wrapper
+
+    def set_page(self, page: Page) -> None:
+        """设置 Page 实例"""
+        super().set_page(page)
+        if page:
+            self._init_keyword_classes()
+
+    def load_menu_data(self, file_path: str) -> None:
+        """加载菜单配置文件
+
+        Args:
+            file_path: modularInformation.json 文件路径
+        """
+        if self._el_menu:
+            self._el_menu.load_menu_data(file_path)
+        elif self._page:
+            self._init_keyword_classes()
+            self._el_menu.load_menu_data(file_path)

kdtest_pw/plugins/element_plus_plugin/my.ini

@@ -0,0 +1,23 @@
+[element_plus]
+# Element Plus 插件配置
+
+# 默认等待超时 (毫秒)
+default_timeout = 5000
+
+# 下拉面板选择器
+dropdown_selector = .el-select-dropdown:visible, .el-popper:visible
+
+# 日期面板选择器
+datepicker_panel_selector = .el-date-picker:visible, .el-picker-panel:visible
+
+# 对话框选择器
+dialog_selector = .el-dialog:visible
+
+# Message 选择器
+message_selector = .el-message:visible
+
+# 是否等待 loading 消失
+wait_loading = true
+
+# loading 选择器
+loading_selector = .el-loading-mask