PO模式

学习目标

  • 提取Utils工具包
  • 提取Page页面元素
  • 抽取元素定位方式
  • 增加Base基类
  • 使用JSON文件进行测试数据管理
  • 编写testCase用例脚本
  • 配置pytest.ini

1. 哪些方法需要作为工具被单独提取

  • 浏览器驱动创建、退出
  • 数据库连接池和游标的创建、关闭
  • 文件读取
  • 浏览器截图
  • 等等一系列与业务无直接关系的公共方法,任何业务中都有可能被调用的方法,都可被提取至工具包中

2. 提取Utils操作步骤

① 在项目目录下,创建一个py文件,名为“Utils.py”

② 编写浏览器驱动的公共方法:

            
from selenium import webdriver


class UtilsWebDriver:
    driver = None

    # 浏览器驱动创建
    @classmethod
    def get_driver(cls):
        if cls.driver is None:  # 当驱动是None时
            cls.driver = webdriver.Chrome()  # 实例化浏览器驱动对象
        return cls.driver  # 返回浏览器驱动对象

    # 浏览器驱动关闭
    @classmethod
    def quit_driver(cls):
        if cls.driver is not None:  # 当驱动不为None时
            cls.driver.quit()  # 退出浏览器驱动
            cls.driver = None  # 将驱动设置回None
            
        

③ 创建数据库的公共方法:

            
import pymysql


class UtilsMysqlDriver:
    conn = None  # 数据库连接池
    cur = None  # 数据库游标

    # 创建数据库连接池和游标
    @classmethod
    def get_mysql(cls):
        if cls.conn is None or cls.cur is None:
            # 创建数据库连接池对象
            cls.conn = pymysql.connect(host='localhost', user='root', passwd='123456', db='phms', port=3309,
                                       charset='utf8')
            # 创建操作游标
            cls.cur = cls.conn.cursor()
        return cls.cur

    # 关闭数据库连接池和游标
    @classmethod
    def close_mysql(cls):
        if cls.cur is not None:
            cls.cur.close()
            cls.cur = None
        if cls.conn is not None:
            cls.conn.close()
            cls.conn = None

    # 执行查询SQL
    @classmethod
    def select_sql(cls, sql):
        row = cls.get_mysql().execute(sql)  # 查询出的行数
        data = cls.get_mysql().fetchall()  # 查询的结果
        return [row, data]  # [10,((1,2,3),(1,2,3),(1,2,3))]

    # 执行修改、新增、删除SQL
    @classmethod
    def update_sql(cls, sql):
        row = cls.get_mysql().execute(sql)
        cls.conn.commit()
        return row  # 受影响行数
            
        

④ 创建文件读取公共方法:

            
import json


class UtilsFileData:
    # 提取json文件的数据
    @classmethod
    def build_data_list(cls, file):
        with open(file, encoding='utf8') as json_file:
            login_data = json.load(json_file)
        return login_data

    @classmethod
    def build_data_object(cls, file):
        test_data = []
        with open(file, encoding='utf8') as json_file:
            json_data = json.load(json_file)
            for case_data in json_data:
                test_data.append(case_data.values())
        return test_data
            
        

⑤ 创建截图公共方法:

            
import datetime


class UtilsScreenshot:
    @classmethod
    def screenshot_png(cls):
        cur_time = datetime.datetime.now().strftime('%Y-%m-%d_%H-%M-%S-%f')
        UtilsWebDriver.get_driver().get_screenshot_as_file(f'./img/login{cur_time}.png')
            
        

3. 提取页面元素

PO的核心思想是通过对界面元素的封装减少冗余代码,同时在后期维护中,若元素定位发生变化,只需要调整页面元素封装的代码,提高测试用例的可维护性、可读性。

4. PO模式下的Page页面会被分为3层

  • 对象库层Page:封装定位元素的方法(页面中所需要的元素全部进行提取)
  • 操作层Handle:封装对元素的操作(元素可能有的操作进行提取)
  • 业务层Proxy:将一个或多个操作组合起来完成一个业务功能

3. Page操作步骤

以宠物医院登录功能为例:

① 在项目目录下,创建一个软件包,名为:page

② 在page目录下新增两个py文件,名为:LoginPage.py和MainPage.py

注意:理论上每一个前端页面,都是单独一个py文件管理,目前案例里的登录功能主要只涉及到“登录”页面和“管理主页”页面,因此只创建了两个page层的py文件

③ 在LoginPage.py文件中封装“对象库层”

            
from Utils import *
import time
from selenium.webdriver.common.by import By


# 对象库层:获取页面元素
class LoginPage:
    def __init__(self):
        self.driver = UtilsWebDriver.get_driver()   # 获取工具包里的驱动对象

    # 获取用户名输入框
    def get_username(self):
        return self.driver.find_element(By.ID, 'name')

    # 获取密码输入框
    def get_pwd(self):
        return self.driver.find_element(By.ID, 'password')

    # 获取登录按钮
    def get_login_button(self):
        return self.driver.find_element(By.CLASS_NAME, 'input3')

    # 获取用户名气泡提示
    def get_user_msg(self):
        return self.driver.find_element(By.CLASS_NAME, 'userName-msg')

    # 获取密码气泡提示
    def get_pwd_msg(self):
        return self.driver.find_element(By.CLASS_NAME, 'pass-msg')

    # 获取弹窗提示
    def get_alter_msg(self):
        return self.driver.find_element(By.CLASS_NAME, 'layui-layer-padding')
            
        

④ 在LoginPage.py文件中封装“操作层”

            
# 操作层:元素可以执行的操作
class LoginHandle:
    def __init__(self):
        self.login_page = LoginPage()

    # 用户名:输入
    def input_username(self, username):
        self.login_page.get_username().send_keys(username)

    # 密码:输入
    def input_pwd(self, pwd):
        self.login_page.get_pwd().send_keys(pwd)

    # 登录按钮:点击
    def click_login_button(self):
        self.login_page.get_login_button().click()

    # 用户名提示气泡:获取文本
    def get_username_msg_text(self):
        return self.login_page.get_user_msg().text

    # 密码提示气泡:获取文本
    def get_pwd_msg_text(self):
        return self.login_page.get_pwd_msg().text

    # 弹窗提示:获取文本
    def get_alter_msg_text(self):
        return self.login_page.get_alter_msg().text
            
        

⑤ 在LoginPage.py文件中封装“业务层”

    
# 业务层:操作能拼装成的业务
class LoginProxy:
    def __init__(self):
        self.login_handle = LoginHandle()

    # 登录
    def login(self, username, pwd):
        self.login_handle.input_username(username)  # 输入用户名
        self.login_handle.input_pwd(pwd)            # 输入密码
        self.login_handle.click_login_button()      # 点击登录按钮

    # [登录失败-用户名气泡]的断言
    def username_msg_assert(self, msg):
        time.sleep(0.5)
        assert msg == self.login_handle.get_username_msg_text()

    # [登录失败-密码气泡]的断言
    def pwd_msg_assert(self, msg):
        time.sleep(0.5)
        assert msg == self.login_handle.get_pwd_msg_text()

    # [登录失败-弹窗提示]的断言
    def alter_msg_assert(self, msg):
        time.sleep(1)
        assert msg == self.login_handle.get_alter_msg_text()
    

⑥ 按照LoginPage.py的编写思路,完成MainPage.py文件的编写:

    
from Utils import *
import time
from selenium.webdriver.common.by import By

# 对象库层
class MainPage:
    def __init__(self):
        self.driver = UtilsWebDriver.get_driver()           # 获取浏览器驱动

    def get_hello(self):
        return self.driver.find_element(By.XPATH,'/html/body/table/tbody/tr[1]/td/div/table/tbody/tr/td[3]/div/span[1]')        # 定位元素

# 操作层
class MainHandle:
    def __init__(self):
        self.main_page = MainPage()                         # 实例化page层

    def get_hello_text(self):
        return self.main_page.get_hello().text              # 获取元素的文本操作

# 业务层
class MainProxy:
    def __init__(self):
        self.main_handle = MainHandle()                     # 实例化操作层

    def hello_assert(self, msg):
        time.sleep(2)
        assert msg in self.main_handle.get_hello_text()     # 断言文本是否符合预期

    

4. 抽取元素定位方式

把对象库层的元素定位信息定义在对象的属性中,便于集中管理。

5. 抽取元素定位方式操作步骤:

① 将LoginPage.py文件中“对象库层”的结构进行重写:

            
class LoginPage:
    def __init__(self):
        self.driver = UtilsWebDriver.get_driver()   # 获取工具包里的驱动对象
        self.username = By.ID, 'name'
        self.pwd = By.ID, 'password'
        self.login_button = By.CLASS_NAME, 'input3'
        self.user_msg = By.CLASS_NAME, 'userName-msg'
        self.pwd_msg = By.CLASS_NAME, 'pass-msg'
        self.alter_msg = By.CLASS_NAME, 'layui-layer-padding'

    # 获取用户名输入框
    def get_username(self):
        return self.driver.find_element(*self.username)     # *号表示传递的参数为元组,即多个参数值

    # 获取密码输入框
    def get_pwd(self):
        return self.driver.find_element(*self.pwd)

    # 获取登录按钮
    def get_login_button(self):
        return self.driver.find_element(*self.login_button)

    # 获取用户名气泡提示
    def get_user_msg(self):
        return self.driver.find_element(*self.user_msg)

    # 获取密码气泡提示
    def get_pwd_msg(self):
        return self.driver.find_element(*self.pwd_msg)

    # 获取弹窗提示
    def get_alter_msg(self):
        return self.driver.find_element(*self.alter_msg)
            
        

② 按照LoginPage.py文件的编写思路,对MainPage.py文件的编写中“对象库层”的结构进行重写:

            
class MainPage:
    def __init__(self):
        self.driver = UtilsWebDriver.get_driver()
        self.hello = By.XPATH, '/html/body/table/tbody/tr[1]/td/div/table/tbody/tr/td[3]/div/span[1]'

    def get_hello(self):
        return self.driver.find_element(*self.hello)
            
        

6. 增加Base基类

把共同操作、需优化的操作提取封装到父类中,子类直接调用父类的方法,避免代码冗余。

7. 增加Base的操作步骤:

① 在项目目录下,新增一个软件包,名为base

② 在base目录下,可对page文件的“对象库层”、“操作层”、“业务层”的共同操作、需优化的操作进行提取

③ 当前案例,仅需对“对象库层”进行优化,因此只创建一个BasePage.py即可

④ 编写BasePage.py优化方法:

            
from Utils import *
from selenium.webdriver.support.wait import WebDriverWait


class BasePage:
    def __init__(self):
        self.driver = UtilsWebDriver.get_driver()

    # 获取元素
    def get_element(self, location):
        """
        获取元素时加上元素等待
        :param location: 需要被寻找的元素信息
        :return: 元素对象
        """
        wait = WebDriverWait(self.driver, 10, 0.5)
        element = wait.until(lambda x: x.find_element(*location))
        return element
            
        

⑤ 修改page目录下的LoginPage.py中的“对象库层”代码:

            

from base.BasePage import BasePage
class LoginPage(BasePage):
    def __init__(self):
        super().__init__()
        self.username = By.ID, 'name'
        self.pwd = By.ID, 'password'
        self.login_button = By.CLASS_NAME, 'input3'
        self.user_msg = By.CLASS_NAME, 'userName-msg'
        self.pwd_msg = By.CLASS_NAME, 'pass-msg'
        self.alter_msg = By.CLASS_NAME, 'layui-layer-padding'

    # 获取用户名输入框
    def get_username(self):
        return self.get_element(self.username)

    # 获取密码输入框
    def get_pwd(self):
        return self.get_element(self.pwd)

    # 获取登录按钮
    def get_login_button(self):
        return self.get_element(self.login_button)

    # 获取用户名气泡提示
    def get_user_msg(self):
        return self.get_element(self.user_msg)

    # 获取密码气泡提示
    def get_pwd_msg(self):
        return self.get_element(self.pwd_msg)

    # 获取弹窗提示
    def get_alter_msg(self):
        return self.get_element(self.alter_msg)
            
        

⑥ 按照LoginPage.py的思路,修改MainPage.py中的“对象库层”代码:

                
from base.BasePage import BasePage
class MainPage(BasePage):
    def __init__(self):
        super().__init__()
        self.hello = By.XPATH, '/html/body/table/tbody/tr[1]/td/div/table/tbody/tr/td[3]/div/span[1]'

    def get_hello(self):
        return self.get_element(self.hello)
                
            

8. 数据驱动?

是以数据来驱动整个测试用例的执行,也就是测试数据决定测试结果。比如我们要测试加法,我们的测试数据是1和1,测试结果就是2,如果测试数据是1和2,测试结果就是3

9. 数据驱动的特点:

  • 数据驱动本身不是一个工业级标准的概念,因此在不同的公司都会有不同的解释
  • 可以把数据驱动理解为一种模式或者一种思想
  • 数据驱动技术可以将用户把关注点放在对测试数据的构建和维护上,而不是直接维护脚本,可以利用同样的过程对不同的数据输入进行测试
  • 数据驱动的实现要依赖参数化的技术

10. 传入数据的方式(测试数据的来源)

  • 直接定义在测试脚本中(简单直观,但代码和数据未实现真正的分离,不方便后期维护)
  • 从文件读取数据,如JSON、excel、xml、txt等格式文件(性价比最高)
  • 从数据库中读取数据
  • 直接调用接口获取数据源
  • 本地封装一些生成数据的方法

11. 数据驱动操作步骤:

① 新建一个data目录,根据不同的测试用例创建对应的json文件,如:登录功能,创建一个文件为“loginData.json”

② 准备数据的json写法,一般分成以下两种:

Ⅰ. 用[]列表填写数据:

            
[
  ["", "", "用户名不能为空", "密码长度不能小于5个字符", "", ""],
  ["", "123456", "用户名不能为空", "", "", ""],
  ["admin", "", "", "密码长度不能小于5个字符", "", ""],
  ["admin", "111111", "", "", "用户名或密码错误", ""],
  ["root123", "123456", "", "", "用户名或密码错误", ""],
  ["root123", "111111", "", "", "用户名或密码错误", ""],
  ["admin", "123456", "", "", "", "你好"]
]
            
        

Ⅱ. 用{}对象填写数据:

            
[
  {
    "username": "",
    "pwd": "",
    "username_expect": "用户名不能为空",
    "pwd_expect": "密码长度不能小于5个字符",
    "alter_expect": "",
    "hello": ""
  },{
    "username": "",
    "pwd": "123456",
    "username_expect": "用户名不能为空",
    "pwd_expect": "",
    "alter_expect": "",
    "hello": ""
  },{
    "username": "admin",
    "pwd": "",
    "username_expect": "",
    "pwd_expect": "密码长度不能小于5个字符",
    "alter_expect": "",
    "hello": ""
  },{
    "username": "admin",
    "pwd": "111111",
    "username_expect": "",
    "pwd_expect": "",
    "alter_expect": "用户名或密码错误",
    "hello": ""
  },{
    "username": "root123",
    "pwd": "123456",
    "username_expect": "",
    "pwd_expect": "",
    "alter_expect": "用户名或密码错误",
    "hello": ""
  },{
    "username": "root123",
    "pwd": "111111",
    "username_expect": "",
    "pwd_expect": "",
    "alter_expect": "用户名或密码错误",
    "hello": ""
  },{
    "username": "admin",
    "pwd": "123456",
    "username_expect": "",
    "pwd_expect": "",
    "alter_expect": "",
    "hello": "你好"
  }
]
            
        

12. 调整testCase用例脚本

由于提取了Utils工具包、Page页面元素,大大节约用例脚本层的代码量,因此需要配合着调整testCase用例脚本

13. 调整testCase的操作步骤:

① 在项目目录下,新增一个软件包,名为testCase

② 将之前使用pytest框架编写的登录测试脚本TestLogin.py放入testCase目录下

③ 对TestLogin.py进行调整:

            
import pytest
from Utils import *
from page.LoginPage import LoginProxy
from page.MainPage import MainProxy


class TestLogin:

    def setup_class(self):
        self.driver = UtilsWebDriver.get_driver()   # V4:调用工具包的获取浏览器驱动方法
        self.driver.get('http://localhost:8080/')
        self.driver.implicitly_wait(10)             # 全局等待
        self.login_proxy = LoginProxy()             # 实例化登录页的业务层
        self.main_proxy = MainProxy()

    def setup(self):
        self.driver.refresh()

    @pytest.mark.parametrize(('username', 'pwd', 'user_msg', 'pwd_msg', 'alter_msg', 'hello_msg'),
                             UtilsFileData.build_data_object(r'../data/loginData.json'))
    def test_login(self, username, pwd, user_msg, pwd_msg, alter_msg, hello_msg):
        self.login_proxy.login(username, pwd)
        if user_msg:
            self.login_proxy.username_msg_assert(user_msg)
        if pwd_msg:
            self.login_proxy.pwd_msg_assert(pwd_msg)
        if alter_msg:
            self.login_proxy.alter_msg_assert(alter_msg)
        if hello_msg:
            self.main_proxy.hello_assert(hello_msg)
        UtilsScreenshot.screenshot_png()  # 截图

    def teardown(self):
        pass

    def teardown_class(self):
        UtilsWebDriver.quit_driver()    # 调用工具包的退出浏览器方法
            
        

14. pytest.ini配置文件操作步骤:

① 在项目目录下,新建文件:pytest.ini

② 编写配置文件内容:

            
[pytest]
addopts = -s -v --html=report/report.html --reruns 3
testpaths = ./testCase
python_files = Test*.py
python_classes = Test*
python_functions = test*
            
        

③ 在项目目录下添加目录:img。用于存放截图

④ 使用终端运行:pytest

注意,使用终端运行需要修改读取json文件的相对路径“../data/loginData.json”改为“./data/loginData.json”,或使用绝对路径。