这是一个关于python的WebUI自动化测试的项目,之前用的是unittest测试框架,现在改成pytest测试框架,Python+PageObject+Pytest
实现页面元素、页面对象及业务、测试数据分离
项目结构:说明
.
|-- assets
| `-- style.css
|-- cases --------------------- 测试用例模块
| |-- conftest.py
| |-- __init__.py
| |-- logincases --------------------- 测试模块1
| | |-- conftest.py
| | |-- __init__.py
| | `-- test_login.py
| `-- usercases --------------------- 测试模块2
| |-- conftest.py
| |-- __init__.py
| `-- test_user_add.py
|-- Common --------------------- 配置和功能函数
| |-- config
| | `-- config.ini --------------------- 配置文件, 日志、报告、截图的目录等
| |-- __init__.py
| |-- plugs --------------------- 功能函数
| | |-- basepage.py --------------------- 封装的 webdriver Api (后续可以自己添加,目前只是封装的少许)
| | |-- get_config.py --------------------- 获取配置文件方法
| | |-- get_log.py --------------------- 日志的配置方法
| | |-- __init__.py
|-- Locators --------------------- 测试页面定位
| |-- __init__.py
| |-- LoginLocators --------------------- 登录模块的页面对象定位
| | |-- __init__.py
| | |-- login_locators.py
| `-- UserLocators --------------------- 用户模块的页面对象定位
| |-- __init__.py
| `-- user_locators.py
|-- OutPuts --------------------- 输出
| |-- image --------------------- 截图
| |-- log --------------------- 日志
| `-- reports --------------------- 报告
| `-- report.html
|-- PageObjects ---------------------- 业务流程
| |-- IndexPage ---------------------- 主页模块的页面对象
| | |-- index_page.py
| | |-- __init__.py
| |-- __init__.py
| |-- LoginPage ---------------------- 登录模块的页面对象
| | |-- __init__.py
| | |-- login_page.py
| `-- UserPage ---------------------- 用户模块的页面对象
| |-- __init__.py
| `-- user_page.py
|-- README.md
`-- TestDatas ---------------------- 测试数据
|-- GobalDatas ---------------------- 全局的测试数据
| |-- gobal_datas.py
| |-- __init__.py
|-- __init__.py
|-- LoginDatas ---------------------- 登录模块的正常、异常测试数据
| |-- __init__.py
| |-- login_datas.py
`-- UserDatas ---------------------- 用户模块的正常、异常测试数据
|-- __init__.py
`-- user_add_datas.py
以下是简单说明:
case: pytest的参数化 fixture的使用 conftest全局和本地的配置
Cases/conftest:测试类的前置和后置,单个测试用例的前置和后置
@pytest.fixture(scope='session')
def project_session_start():
logger.info("==========开始 XX项目 执行测试===========")
global driver
driver = webdriver.Chrome()
driver.maximize_window()
yield driver
driver.quit()
logger.info("==========结束 XX项目 测试===========")
@pytest.fixture(scope='module')
def project_module_start():
logger.info("==========开始 XX模块 执行测试===========")
global driver
driver = webdriver.Chrome()
driver.maximize_window()
yield driver
driver.quit()
logger.info("==========结束 XX模块 测试===========")
测试用例:参数的正常和异常用例
pytest.mark.usefixtures('start_session')
@pytest.mark.usefixtures('refresh_page')
class TestUserAdd:
@pytest.mark.smoke
def test_add_user(self, start_session):
logger.info(" 执行 {0} 测试用例 ".format(sys._getframe().f_code.co_name))
logger.info('正常新增用户测试用例')
start_session[1].add_user(UAD.success_data['username'], UAD.success_data['password'],
UAD.success_data['email'],
UAD.success_data['phone'])
logger.info("期望值:{0}".format(UAD.success_data['Msg']))
logger.info("实际值:{0}".format(start_session[1].get_add_result_msg()))
try:
assert start_session[1].get_add_result_msg() == UAD.success_data['Msg']
logger.info(" 结束执行 {0} 测试用例, 测试结果 --- PASS ".format(sys._getframe().f_code.co_name))
start_session[1].save_pictuer("{0}-正常截图".format(UAD.success_data['name']))
except:
logger.info(" 结束执行 {0} 测试用例, 测试结果 --- False ".format(sys._getframe().f_code.co_name))
start_session[1].save_pictuer("{0}-异常截图".format(UAD.success_data['name']))
raise
@pytest.mark.parametrize('data', UAD.error_usernameFormat_data)
def test_add_usernameFormat_error(self, data, start_session):
print(" 执行 {0} 测试用例 ".format(sys._getframe().f_code.co_name))
logger.info(" 异常测试用例:{0} ".format(data['name']))
start_session[1].add_user(data['username'], data['password'], data['email'], data['phone'])
logger.info("期望值:{0}".format(data['Msg']))
logger.info("实际值:{0}".format(start_session[1].get_add_result_msg()))
try:
assert start_session[1].get_add_result_msg() == data['Msg']
logger.info(" 结束执行 {0} 测试用例, 测试结果 --- PASS ".format(sys._getframe().f_code.co_name))
start_session[1].save_pictuer("{0}-正常截图".format(data['name']))
except:
logger.info(" 结束执行 {0} 测试用例, 测试结果 --- False ".format(sys._getframe().f_code.co_name))
start_session[1].save_pictuer("{0}-异常截图".format(data['name']))
raise
@pytest.mark.parametrize('data', UAD.error_usernameFormat_data)
def test_add_passwordFormat_error(self, data, start_session):
logger.info(" 执行 {0} 测试用例 ".format(sys._getframe().f_code.co_name))
logger.info(" 异常测试用例:{0} ".format(data['name']))
start_session[1].add_user(data['username'], data['password'], data['email'], data['phone'])
logger.info("期望值:{0}".format(data['Msg']))
logger.info("实际值:{0}".format(start_session[1].get_add_result_msg()))
try:
assert start_session[1].get_add_result_msg() == data['Msg']
logger.info(" 结束执行 {0} 测试用例, 测试结果 --- PASS ".format(sys._getframe().f_code.co_name))
start_session[1].save_pictuer("{0}-正常截图".format(data['name']))
except:
logger.info(" 结束执行 {0} 测试用例, 测试结果 --- False ".format(sys._getframe().f_code.co_name))
start_session[1].save_pictuer("{0}-异常截图".format(data['name']))
raise
Locators: #页面的元素
class LoginLocator:
username_loc = (By.XPATH, '//*[@id="app"]/div/form/div[1]/div/div/input')
password_loc = (By.XPATH, '//*[@id="app"]/div/form/div[2]/div/div/input')
login_btn_loc = (By.XPATH, '//*[@type="button"]')
error_msg_loc = (By.CLASS_NAME, 'el-message__content')
PageObjects: # 业务功能流程
class LoginPage(BasePage):
# 登录
def login(self, username, password):
doc = '登录页面_登录功能_查找元素失败'
self.input_element(loc.username_loc, username, doc)
self.input_element(loc.password_loc, password, doc)
self.click_element(loc.login_btn_loc, doc)
# 获取错误提示
def get_login_errMsg(self):
doc = '登录页面_登录功能错误信息_查找元素失败'
# self.wait_eleVisible(loc.error_msg_loc)
return self.get_element_text(loc.error_msg_loc, doc)
TestDatas # 测试数据
# 正常场景测试数据
success_data = {'name': '登录功能-正常测试', 'username': 'admin', 'password': '123456'}
# 异常场景测试 - username
error_usernameFormat_data = [
{'name': '登录功能-异常测试-用户名为空', 'username': '', 'password': '123456', 'errorMsg': '参数错误'},
{'name': '登录功能-异常测试-用户名不存在', 'username': 'xxoo', 'password': '123456', 'errorMsg': '用户名不存在'},
]
# 异常场景测试 - password
error_passwordFormat_data = [
{'name': '登录功能-异常测试-密码为空', 'username': 'admin', 'password': '', 'errorMsg': '参数错误'},
{'name': '登录功能-异常测试-密码错误', 'username': 'admin', 'password': '1234567', 'errorMsg': '密码错误'},
]