[TOC]

ui_checker

麻辣诱惑后台管理系统UI自动化测试项目，基于python + selenium + unittest

主要特性

1. 采用PageObject模式封装每个操作页面，支持页面与元素分离
2. 支持selenium_easy模式，按人类习惯，通过链接/按钮文字，Form前置标签识别/操作控件，支持多个相同标签控件的识别
3. 支持Json/XML/CSV/Excel/Config类型的数据文件解析，支持将数据文件完整解析成dict格式，或从中获取某个值
4. 支持数据连接及对比数据库的值
5. 支持Chrome Headless无界面模式运行，支持Grid分布式运行或Remote模式
6. 支持按模块并发执行用例，每个模块生成各自的报告
7. 支持邮件/截图/log
8. 支持显示webdriver各项操作消耗时间，支持time_out设置，支持多线程重复某一操作， 支持制定test case level
9. 支持 Windows/Linux + python2./python3.

使用方法

运行环境

推荐 Windows 7/10 + Python 3.* + selenium3.5 + Chrome 62以上 或 CentOS 7.* + Python2.7 + selenium3.5 + google-chrome-stable最新版

以Windows为例：

1. 下载安装Chrome最新版
2. 下载安装Git Windows客户端
3. 下载安装python3.6.3（自动安装pip和配置好环境变量）
4. 安装python第三方库，打开cmd

pip install selenium
pip install pymysql
pip install xlrd

使用项目

1. 克隆项目，打开cmd

git@192.168.100.240:hanzhichao/ui_checker.git
cd ui_checker

2. 配置项目

打开conf/default.conf
修改[env]下base_url及登录用户名和密码,保存

3. 执行所有用例

python run_all_test.py

编写用例

1. 完善page_obj对象

1.1 根据页面菜单url确定所在模块，如"综合管理系统>部门管理>新增部门" 页面链接为.../admin/ADepartment/create
1.2 打开page_obj/目录下对应的模块下对应的py文件，如page_obj/admin/ADepartment/create.py
1.3 完善menu和subject：
    如menu='综合管理系统','部门管理','新增部门'（用于加载页面，注意：中间为英文逗号），
    subject='部门信息'（页面主体，第一个头部主题，用于判断页面是否加载成功）
1.4 封装页面操作，3种方式，参考page_obj/customer/CCustumer/下的：
    index.py(selenium_easy模式)
    index2.py(标准PageObj模式)
    index3.py+index3.property(元素分离模式)

2. 编写测试用例

进入test_case/相应模块下，如test_case/admin
新建test_adepartment_create.py文件
编写该页面相关的用例，参考test_case/customer/test_ccustomer_index.py

3. page_obj示例

# !/usr/bin/env python
# -*- coding=utf-8 -*-

from time import sleep

from page_obj.base_page import BasePage
from page_obj.index.index.login import LoginPage
from util.browser import Chrome
from util.db import DB
from util.selenium_easy import Element, Input


class IndexPage(BasePage):
    menu = ('客服管理系统', '综合管理', '综合信息')
    subject = '会员信息'
 
    def search_phone(self, phone):
        self.type('电话搜索：', phone)
        self.click_btn('搜索')
        self.sleep()
        
    def save_work_bill(self):
        self.click("显示更多内容")
        
        self.select("来电原由", "订单")
        self.select("来电原由", "创建订单", 2)
        self.type_area("备注", "自动化测试", 2)
        self.click_btn("保存", 2)
        
    def create_order(self, phone, station, code):
        self.search_phone(phone)
        self.save_work_bill()
        self.click("显示更多内容", 4)
        self.select("配送站点", station)
        self.type("请输入要查询商品的简码", code)
        sleep(1)
        self.click_text("麻酱烧饼")
        self.select("订单渠道：", "电话")
        self.select("订单区域", "北京")
        self.click_input("是否预定送餐时间", 4)
        self.click_btn("当前")
        self.click_btn("确认")
        self.check("支付方式", 1)
        self.select("支付方式", "支付宝")
        self.type_area("备注", "自动化测试下单", 3)
        self.click_btn("保存", 3)
        
        
if __name__ == '__main__':
    d = Chrome.normal()
    # d = Chrome.headless()
    d.maximize_window()
    l = LoginPage(d)
    l.login()
    p = IndexPage(d)
    p.load()
    p.create_order('18010181267', '花家地', 'M')
    sleep(10)
    d.quit()

4. 测试用例示例 test_case/customer/test_ccustomer_index.py

# !/usr/bin/env python
# -*- coding=utf-8 -*-
import sys
sys.path.append("..")
from page_obj.customer.CCustomer.index import IndexPage
from test_case.base_case import BaseCase
import unittest
from util.decorator import level


class TestCcustomerIndex(BaseCase):
    
    @classmethod
    def setUpClass(cls):
        super(TestCcustomerIndex, cls).setUpClass()
        cls.page = IndexPage(cls.driver)
        cls.page.load()
    
    def test_search_exist_customer(self):
        """
        pre-condition: 18010181267 customer exists
        no cleaning need
        """
        phone = '18010181267'
        self.page.search_phone(phone)
        # assert page_obj value and search value
        customer_phone = self.page.get_input_value('会员电话：')
        self.assertEqual(customer_phone, phone)

    @level(2)
    def test_search_not_exist_customer(self):
        """
            pre-condition: 18010181261 customer not exists
            no cleaning need
        """
        phone = '18010181261'
        self.page.search_phone(phone)
        customer_phone = self.page.get_input_value('会员电话：')
        self.assertFalse(customer_phone)

if __name__ == '__main__':  
    unittest.main(verbosity=2)

项目结构

• conf--配置文件目录
• driver---浏览器驱动目录
• page_obj---页面对象目录，包含各个模块
• report---报告目录，包含log/snapshot
• support---环境及项目需要的软件
• test_case---测试用例，分模块
• tools---一些工具，包含自动生成所有页面对象
• util---公共方法库 browser.py---封装浏览器驱动 config.py---解析conf/default.conf项目配置文件 data_file_parser.py---解析各种数据文件，支持Json/Config/XML/Excel/CSV db.py---连接数据，查询数据 decorator.py---装饰器，包含显示执行时间，超时，多线程等装饰器 HTMLTestRunner.py---python2.*英文版报告生成包 HTMLTestRunnerCN.py---python3.*中文版报告生成包 log.py---log控制 root.py---项目一些常量，包含解析项目绝对目录 selenium_easy.py---基于xpath封装了许多页面元素定位及操作方法