- CLI + Web 双平台,基于 LLM 的 TDD+DDD 自动化测试生成 - 集成 unified-test-platform 903 个 D-Cloud 用例 + 13 个 Robogo 场景 - Agent 5 步流水线: 扫描 -> DDD -> LLM 生成测试 - 精确回归 + UI 变更检查 - 可视化 HTML 测试报告 - 暗色/亮色主题切换 - 19 个 API 端点 + 6 个 SPA 页面 - 15/15 项 TDD+DDD 合规
617 lines
22 KiB
Python
617 lines
22 KiB
Python
"""
|
||
素材库模块 Page Object
|
||
|
||
封装素材库的UI元素和操作
|
||
功能: 工作流素材管理、文件上传、自动挂载
|
||
操作: 新建文件夹、上传、复制路径
|
||
说明: 工作流启动时自动挂载到 input 目录
|
||
"""
|
||
|
||
from playwright.sync_api import Page, Locator
|
||
from typing import List, Optional
|
||
import time
|
||
from tests.base.base_page import BasePage
|
||
from tests.logger import log_ui
|
||
|
||
|
||
class MaterialLibraryPage(BasePage):
|
||
"""素材库页面"""
|
||
|
||
# 页面URL
|
||
url = "https://cloud-fat.d-robotics.cc/d-cloud/data-create/library"
|
||
|
||
# 元素选择器
|
||
SELECTORS = {
|
||
# 页面标题和面包屑
|
||
"page_title": "text=素材库",
|
||
"breadcrumb": ".ant-breadcrumb",
|
||
|
||
# 操作按钮
|
||
"new_folder_button": "button:has-text('新建文件夹')",
|
||
"upload_button": "button:has-text('上 传')", # 注意:按钮文本有空格
|
||
"refresh_button": "button:has-text('刷新')",
|
||
"back_button": "button:has-text('返回上一级')",
|
||
"copy_path_button": "button:has-text('复制路径')",
|
||
"delete_button": "button:has-text('删除')",
|
||
|
||
# 文件列表相关 - 页面使用卡片式文件列表,不是表格
|
||
# 根据实际页面,文件项是img+text组合
|
||
"file_list_container": "body", # 文件列表容器
|
||
"file_item": ".file-item, [class*='file'], [class*='item']", # 单个文件项
|
||
|
||
# 文件夹/文件图标
|
||
"folder_icon": "svg[data-icon='folder']",
|
||
"file_icon": "svg[data-icon='file']",
|
||
|
||
# 搜索框
|
||
"search_input": "input[placeholder*='搜索']",
|
||
"clear_search_button": ".ant-input-clear-icon",
|
||
|
||
# 空状态
|
||
"empty_state": ".ant-empty",
|
||
"empty_state_text": ".ant-empty-description",
|
||
|
||
# 加载状态
|
||
"loading_spinner": ".ant-spin",
|
||
|
||
# 对话框
|
||
"dialog": ".ant-modal",
|
||
"dialog_title": ".ant-modal-title",
|
||
"dialog_input": "input[placeholder*='请输入文件夹名称']",
|
||
"dialog_confirm_button": "button:has-text('确 定')",
|
||
"dialog_cancel_button": "button:has-text('取 消')",
|
||
"dialog_close_button": ".ant-modal-close",
|
||
|
||
# 上传相关
|
||
"upload_dialog": ".ant-upload",
|
||
"upload_input": "input[type='file']",
|
||
"upload_drop_area": ".ant-upload-drag-container",
|
||
"upload_list": ".ant-upload-list",
|
||
"upload_progress": ".ant-progress",
|
||
"upload_success_icon": ".ant-upload-success-icon",
|
||
|
||
# 文件操作菜单
|
||
"file_menu": ".ant-dropdown-menu",
|
||
"menu_copy_path": ".ant-dropdown-menu-item:has-text('复制路径')",
|
||
"menu_download": ".ant-dropdown-menu-item:has-text('下载')",
|
||
"menu_delete": ".ant-dropdown-menu-item:has-text('删除')",
|
||
"menu_rename": ".ant-dropdown-menu-item:has-text('重命名')",
|
||
|
||
# 路径导航
|
||
"path_breadcrumb": ".ant-breadcrumb",
|
||
"path_item": ".ant-breadcrumb-link",
|
||
"current_path": ".ant-breadcrumb-link:last-child",
|
||
}
|
||
|
||
def __init__(self, page: Page):
|
||
super().__init__(page)
|
||
|
||
def navigate_to_material_library(self) -> None:
|
||
"""导航到素材库页面"""
|
||
self.navigate(self.url)
|
||
self.wait_for_page_ready()
|
||
self.wait_for_file_table_load()
|
||
log_ui.info("已导航到素材库页面")
|
||
|
||
def wait_for_file_table_load(self, timeout: int = 15000) -> None:
|
||
"""等待文件列表加载完成(支持空状态)
|
||
|
||
说明:页面不是表格结构,文件项是img+text组合
|
||
"""
|
||
# 安全等待加载动画消失(忽略如果不存在)
|
||
try:
|
||
self.page.locator(self.SELECTORS["loading_spinner"]).wait_for(state="hidden", timeout=5000)
|
||
except Exception:
|
||
pass # 加载动画可能不存在,继续执行
|
||
|
||
# 等待页面关键元素出现:新建文件夹按钮或上传按钮
|
||
# 这表示页面已加载完成
|
||
start_time = self.page.evaluate("Date.now()")
|
||
while True:
|
||
# 检查新建文件夹按钮是否可见
|
||
if self.page.locator(self.SELECTORS["new_folder_button"]).is_visible():
|
||
return
|
||
|
||
# 检查上传按钮是否可见
|
||
if self.page.locator(self.SELECTORS["upload_button"]).is_visible():
|
||
return
|
||
|
||
# 检查空状态
|
||
if self.page.locator(self.SELECTORS["empty_state"]).is_visible():
|
||
return
|
||
|
||
elapsed = self.page.evaluate("Date.now()") - start_time
|
||
if elapsed > timeout:
|
||
raise TimeoutError(f"等待页面加载超时: 关键元素未在 {timeout}ms 内出现")
|
||
|
||
self.page.wait_for_timeout(200)
|
||
|
||
# ==================== 基础操作 ====================
|
||
|
||
def click_new_folder(self) -> None:
|
||
"""点击新建文件夹按钮"""
|
||
self.click(self.SELECTORS["new_folder_button"])
|
||
log_ui.debug("点击新建文件夹按钮")
|
||
|
||
def click_upload(self) -> None:
|
||
"""点击上传按钮"""
|
||
self.click(self.SELECTORS["upload_button"])
|
||
log_ui.debug("点击上传按钮")
|
||
|
||
def click_refresh(self) -> None:
|
||
"""点击刷新按钮"""
|
||
self.click(self.SELECTORS["refresh_button"])
|
||
self.wait_for_file_table_load()
|
||
log_ui.debug("点击刷新按钮")
|
||
|
||
def click_back(self) -> None:
|
||
"""点击返回上一级按钮"""
|
||
self.click(self.SELECTORS["back_button"])
|
||
self.wait_for_file_table_load()
|
||
log_ui.debug("点击返回上一级按钮")
|
||
|
||
# ==================== 文件夹操作 ====================
|
||
|
||
def create_folder(self, folder_name: str) -> bool:
|
||
"""
|
||
创建文件夹
|
||
|
||
Args:
|
||
folder_name: 文件夹名称
|
||
|
||
Returns:
|
||
bool: 是否创建成功
|
||
"""
|
||
try:
|
||
# 点击新建文件夹按钮
|
||
self.click_new_folder()
|
||
|
||
# 等待对话框出现
|
||
if not self.wait_for_selector_safe(self.SELECTORS["dialog"], state="visible", timeout=3000):
|
||
log_ui.warning("创建文件夹对话框未出现")
|
||
return False
|
||
|
||
# 输入文件夹名称
|
||
dialog_input = self.page.locator(self.SELECTORS["dialog_input"])
|
||
dialog_input.fill(folder_name)
|
||
|
||
# 点击确定按钮
|
||
self.click(self.SELECTORS["dialog_confirm_button"])
|
||
|
||
# 等待对话框关闭
|
||
self.wait_for_element_hidden(self.SELECTORS["dialog"])
|
||
|
||
# 等待表格刷新
|
||
self.wait_for_file_table_load()
|
||
|
||
log_ui.info(f"创建文件夹: {folder_name}")
|
||
return True
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"创建文件夹失败: {str(e)}")
|
||
return False
|
||
|
||
def enter_folder(self, folder_name: str) -> bool:
|
||
"""
|
||
进入指定文件夹
|
||
|
||
Args:
|
||
folder_name: 文件夹名称
|
||
|
||
Returns:
|
||
bool: 是否成功进入
|
||
"""
|
||
try:
|
||
row = self.get_file_row(folder_name)
|
||
if row:
|
||
# 点击文件夹名称(通常是一个链接)
|
||
folder_link = row.locator(self.SELECTORS["file_name_column"])
|
||
folder_link.click()
|
||
|
||
# 等待页面加载
|
||
self.wait_for_file_table_load()
|
||
|
||
# 检查当前路径是否包含文件夹名称
|
||
current_path = self.get_current_path()
|
||
if folder_name in current_path:
|
||
log_ui.info(f"进入文件夹: {folder_name}")
|
||
return True
|
||
return False
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"进入文件夹失败: {str(e)}")
|
||
return False
|
||
|
||
# ==================== 文件操作 ====================
|
||
|
||
def upload_file(self, file_path: str) -> bool:
|
||
"""
|
||
上传文件
|
||
|
||
Args:
|
||
file_path: 本地文件路径
|
||
|
||
Returns:
|
||
bool: 是否上传成功
|
||
"""
|
||
try:
|
||
# 点击上传按钮
|
||
self.click_upload()
|
||
|
||
# 等待上传对话框出现
|
||
if not self.wait_for_selector_safe(self.SELECTORS["upload_input"], state="visible", timeout=3000):
|
||
log_ui.warning("上传文件对话框未出现")
|
||
return False
|
||
|
||
# 设置文件输入
|
||
file_input = self.page.locator(self.SELECTORS["upload_input"])
|
||
file_input.set_input_files(file_path)
|
||
|
||
# 等待上传进度完成
|
||
self.wait_for_element_hidden(self.SELECTORS["upload_progress"], timeout=60000) # 最长等待60秒
|
||
|
||
# 检查上传成功标志
|
||
if self.wait_for_selector_safe(self.SELECTORS["upload_success_icon"], state="visible", timeout=5000):
|
||
# 关闭上传对话框(如果有)
|
||
if self.wait_for_selector_safe(self.SELECTORS["dialog_close_button"], state="visible", timeout=2000):
|
||
self.click(self.SELECTORS["dialog_close_button"])
|
||
|
||
# 等待表格刷新
|
||
self.wait_for_file_table_load()
|
||
|
||
log_ui.info(f"上传文件成功: {file_path}")
|
||
return True
|
||
|
||
log_ui.warning("文件上传可能未完成")
|
||
return False
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"上传文件失败: {str(e)}")
|
||
return False
|
||
|
||
def copy_file_path(self, file_name: str) -> bool:
|
||
"""
|
||
复制文件路径
|
||
|
||
Args:
|
||
file_name: 文件名
|
||
|
||
Returns:
|
||
bool: 是否复制成功
|
||
"""
|
||
try:
|
||
row = self.get_file_row(file_name)
|
||
if row:
|
||
# 找到复制路径按钮(可能在操作列)
|
||
copy_btn = row.locator("button:has-text('复制路径')")
|
||
if copy_btn.count() > 0:
|
||
copy_btn.click()
|
||
|
||
# 检查是否有成功提示(通常是短暂出现的消息)
|
||
# 这里可以添加对成功提示的检查
|
||
log_ui.info(f"复制文件路径: {file_name}")
|
||
return True
|
||
|
||
# 如果没有直接的按钮,可能需要在操作菜单中
|
||
menu_btn = row.locator("button:has-text('操作')")
|
||
if menu_btn.count() > 0:
|
||
menu_btn.click()
|
||
self.click(self.SELECTORS["menu_copy_path"])
|
||
log_ui.info(f"通过菜单复制文件路径: {file_name}")
|
||
return True
|
||
|
||
log_ui.warning(f"未找到文件或复制路径按钮: {file_name}")
|
||
return False
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"复制文件路径失败: {str(e)}")
|
||
return False
|
||
|
||
def delete_file(self, file_name: str) -> bool:
|
||
"""
|
||
删除文件/文件夹
|
||
|
||
Args:
|
||
file_name: 文件名
|
||
|
||
Returns:
|
||
bool: 是否删除成功
|
||
"""
|
||
try:
|
||
row = self.get_file_row(file_name)
|
||
if row:
|
||
# 找到删除按钮(可能在操作列)
|
||
delete_btn = row.locator("button:has-text('删除')")
|
||
if delete_btn.count() > 0:
|
||
delete_btn.click()
|
||
else:
|
||
# 如果没有直接的按钮,可能需要在操作菜单中
|
||
menu_btn = row.locator("button:has-text('操作')")
|
||
if menu_btn.count() > 0:
|
||
menu_btn.click()
|
||
self.click(self.SELECTORS["menu_delete"])
|
||
|
||
# 等待确认对话框
|
||
if self.wait_for_selector_safe(self.SELECTORS["dialog"], state="visible", timeout=3000):
|
||
# 点击确认删除
|
||
self.click(self.SELECTORS["dialog_confirm_button"])
|
||
|
||
# 等待对话框关闭
|
||
self.wait_for_element_hidden(self.SELECTORS["dialog"])
|
||
|
||
# 等待表格刷新
|
||
self.wait_for_file_table_load()
|
||
|
||
log_ui.info(f"删除文件: {file_name}")
|
||
return True
|
||
|
||
log_ui.warning(f"未找到文件或删除按钮: {file_name}")
|
||
return False
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"删除文件失败: {str(e)}")
|
||
return False
|
||
|
||
# ==================== 文件列表操作 ====================
|
||
|
||
def get_file_list(self) -> List[dict]:
|
||
"""
|
||
获取文件/文件夹列表
|
||
|
||
Returns:
|
||
List[dict]: 文件信息列表,每个元素包含:
|
||
- name: 文件名
|
||
- type: 文件类型 (folder/file)
|
||
- size: 文件大小 (可选)
|
||
- modified: 修改时间 (可选)
|
||
"""
|
||
try:
|
||
files = []
|
||
|
||
# 使用JavaScript直接获取文件项
|
||
# 根据页面结构,文件项是img+text组合
|
||
file_data = self.page.evaluate('''() => {
|
||
const items = [];
|
||
const knownFiles = ['3d', 'test', '1732775567.084000.jpg', '20250630-133345.png'];
|
||
|
||
// 查找所有文本节点
|
||
const walker = document.createTreeWalker(
|
||
document.body,
|
||
NodeFilter.SHOW_TEXT,
|
||
null,
|
||
false
|
||
);
|
||
|
||
let node;
|
||
while (node = walker.nextNode()) {
|
||
const text = node.textContent?.trim();
|
||
// 过滤掉空文本和已知的UI文本
|
||
if (text && text.length > 0 && !text.includes('新建文件夹') && !text.includes('上传')) {
|
||
// 检查是否是文件名(包含扩展名或是已知文件)
|
||
const hasExtension = /\\.[a-zA-Z0-9]{2,4}$/.test(text);
|
||
const isKnown = knownFiles.some(f => text.includes(f));
|
||
|
||
if (hasExtension || isKnown || text.length < 30) {
|
||
items.push({
|
||
name: text,
|
||
type: hasExtension ? 'file' : 'folder'
|
||
});
|
||
}
|
||
}
|
||
}
|
||
|
||
return items;
|
||
}''')
|
||
|
||
files = file_data if file_data else []
|
||
|
||
log_ui.info(f"获取到 {len(files)} 个文件/文件夹")
|
||
return files
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"获取文件列表失败: {str(e)}")
|
||
return []
|
||
|
||
def get_file_count(self) -> int:
|
||
"""
|
||
获取文件数量
|
||
|
||
Returns:
|
||
int: 文件数量
|
||
"""
|
||
try:
|
||
# 如果表格为空状态,返回0
|
||
if self.page.locator(self.SELECTORS["empty_state"]).is_visible():
|
||
return 0
|
||
|
||
# 获取文件列表长度
|
||
files = self.get_file_list()
|
||
return len(files)
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"获取文件数量失败: {str(e)}")
|
||
return 0
|
||
|
||
def get_file_row(self, file_name: str) -> Optional[Locator]:
|
||
"""
|
||
根据文件名获取文件元素
|
||
|
||
Args:
|
||
file_name: 文件名
|
||
|
||
Returns:
|
||
Optional[Locator]: 包含文件名的文本元素,如果未找到则返回None
|
||
"""
|
||
try:
|
||
# 查找包含文件名的文本元素
|
||
# 页面结构是img+text,直接用文本定位
|
||
file_locator = self.page.locator(f"text={file_name}").first
|
||
|
||
if file_locator.count() > 0:
|
||
return file_locator
|
||
return None
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"查找文件元素失败: {str(e)}")
|
||
return None
|
||
|
||
def is_file_exists(self, file_name: str) -> bool:
|
||
"""
|
||
检查文件是否存在
|
||
|
||
Args:
|
||
file_name: 文件名
|
||
|
||
Returns:
|
||
bool: 是否存在
|
||
"""
|
||
row = self.get_file_row(file_name)
|
||
return row is not None
|
||
|
||
# ==================== 搜索操作 ====================
|
||
|
||
def search_files(self, keyword: str) -> bool:
|
||
"""
|
||
搜索文件
|
||
|
||
Args:
|
||
keyword: 搜索关键词
|
||
|
||
Returns:
|
||
bool: 是否成功执行搜索
|
||
"""
|
||
try:
|
||
# 使用基类的search方法
|
||
success = self.search(keyword, "搜索")
|
||
|
||
if success:
|
||
# 等待搜索结果
|
||
self.wait_for_file_table_load()
|
||
log_ui.info(f"搜索文件: {keyword}")
|
||
|
||
return success
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"搜索文件失败: {str(e)}")
|
||
return False
|
||
|
||
def clear_search(self) -> bool:
|
||
"""
|
||
清除搜索条件
|
||
|
||
Returns:
|
||
bool: 是否成功清除
|
||
"""
|
||
try:
|
||
# 使用基类的clear_search方法
|
||
success = self.clear_search("搜索")
|
||
|
||
if success:
|
||
# 等待表格刷新
|
||
self.wait_for_file_table_load()
|
||
log_ui.info("清除搜索条件")
|
||
|
||
return success
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"清除搜索失败: {str(e)}")
|
||
return False
|
||
|
||
# ==================== 路径操作 ====================
|
||
|
||
def get_current_path(self) -> str:
|
||
"""
|
||
获取当前路径
|
||
|
||
Returns:
|
||
str: 当前路径
|
||
"""
|
||
try:
|
||
# 获取面包屑文本
|
||
breadcrumb = self.page.locator(self.SELECTORS["path_breadcrumb"])
|
||
if breadcrumb.is_visible():
|
||
path_items = breadcrumb.locator(self.SELECTORS["path_item"]).all_text_contents()
|
||
return " / ".join(path_items)
|
||
return ""
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"获取当前路径失败: {str(e)}")
|
||
return ""
|
||
|
||
def navigate_to_path(self, path: str) -> bool:
|
||
"""
|
||
导航到指定路径(通过面包屑)
|
||
|
||
Args:
|
||
path: 路径名称(面包屑项)
|
||
|
||
Returns:
|
||
bool: 是否导航成功
|
||
"""
|
||
try:
|
||
# 找到对应的面包屑项
|
||
path_item = self.page.locator(f"{self.SELECTORS['path_item']}:has-text('{path}')")
|
||
if path_item.is_visible():
|
||
path_item.click()
|
||
self.wait_for_file_table_load()
|
||
log_ui.info(f"导航到路径: {path}")
|
||
return True
|
||
return False
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"导航到路径失败: {str(e)}")
|
||
return False
|
||
|
||
# ==================== 批量操作 ====================
|
||
|
||
def select_all_files(self) -> bool:
|
||
"""
|
||
全选文件
|
||
|
||
Returns:
|
||
bool: 是否成功全选
|
||
"""
|
||
try:
|
||
# 查找全选复选框(通常在表头第一个单元格)
|
||
select_all_checkbox = self.page.locator(f"{self.SELECTORS['file_table_headers']} input[type='checkbox']")
|
||
if select_all_checkbox.is_visible():
|
||
select_all_checkbox.check()
|
||
log_ui.info("全选文件")
|
||
return True
|
||
return False
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"全选文件失败: {str(e)}")
|
||
return False
|
||
|
||
def get_selected_count(self) -> int:
|
||
"""
|
||
获取选中文件数量
|
||
|
||
Returns:
|
||
int: 选中文件数量
|
||
"""
|
||
try:
|
||
# 查找已选中的复选框
|
||
selected_checkboxes = self.page.locator(f"{self.SELECTORS['file_table_rows']} input[type='checkbox']:checked")
|
||
return selected_checkboxes.count()
|
||
|
||
except Exception as e:
|
||
log_ui.error(f"获取选中文件数量失败: {str(e)}")
|
||
return 0
|
||
|
||
# ==================== 断言方法 ====================
|
||
|
||
def expect_file_exists(self, file_name: str) -> None:
|
||
"""断言文件存在"""
|
||
assert self.is_file_exists(file_name), f"文件不存在: {file_name}"
|
||
|
||
def expect_file_count(self, expected_count: int) -> None:
|
||
"""断言文件数量"""
|
||
actual_count = self.get_file_count()
|
||
assert actual_count == expected_count, f"文件数量不匹配: 期望 {expected_count}, 实际 {actual_count}"
|
||
|
||
def expect_current_path_contains(self, path_part: str) -> None:
|
||
"""断言当前路径包含指定部分"""
|
||
current_path = self.get_current_path()
|
||
assert path_part in current_path, f"当前路径不包含 '{path_part}': {current_path}" |