Python PageFactory-使用配置文件动态生成页面PageObject

朱雀 2023-10-09 10:08 83阅读 0赞

## 需求 ##

在Python Selenium 的 PageObject模式中,一般每个页面需要写一个类, 一种PageObject的写法如下:

class BaiduPageObject(object):
        def __init__(self, driver):   # 一般通过继成BasePage类实现该方法
            self.driver = driver
    
        # 页面元素 -----
        search_ipt_loc = ('id', 'kw')
        search_btn_loc = ('id', 'su')
    
        # 页面操作 -----
        def input_search_ipt(self, keyword):
            search_ipt = self.driver.find_element(*search_ipt_loc)
            search_ipt.clear()
            search_ipt.send_keys(keyword):
    
        def click_search_btn(self):
            self.driver.find_element(*search_btn_loc).click()
    
        def search(self, keyword):
            self.input_search_ipt(keyword)
            self.click_search_btn()

对于一个成型的UI项目来说, 在编写用例前, 动辄要先编写数十上百个这种PageObject类. 鉴于每个PageObject类的格式相似, 可以采用  
**Page Factory(页面工厂)+配置文件(yaml) -> PageObject**  
的方式来动态生成每一个页面对象

> **PageFactory**本是Selenium Java SDK中的一种基于PageObject的设计模式, 使用`@FindBy(id = "kw")`语法糖来标记页面元素, 并支持使用`@CacheLookup`来缓存页面元素(这样元素只需要查找一次)  
> 完整介绍: [https://github.com/SeleniumHQ/selenium/wiki/PageFactory][https_github.com_SeleniumHQ_selenium_wiki_PageFactory]

> 鉴于 Python的动态特性, 这里的Page Factory的实现方式与Selenium Java SDK中的完全不同

## 设计与实现 ##

首先设计及约定页面配置文件的格式如下:

# filename: baidu.yaml
    url: https://www.baidu.com  # 可选字段, 用于打开网页
    title: 百度一下，你就知道   # 可选字段, 用于判断是否在当前网页
    elements:   # 页面元素
      search_ipt: [id, kw]  # 支持id, name, class name, tag name, link text
      search_btn: [id, su]  # partial link text, xpath, css selector
    
    actions:  # 可选字段, 页面操作
      search:
        input: [search_ipt, 默认值]  # input: 固定字段, 第一参数为上面的元素, 第二个为输入的文本 
        click: search_btn  # click: 固定字段, 参数为上面配置的元素

page\_factory.py

# page_factory.py
    from types import MethodType  # 用于为实例动态绑定方法
    from collections import OrderedDict  # 有序字典, 用于按顺序遍历actions中的操作步骤
    import yaml
    from selenium import webdriver
    
    
    class Page(object):
        def __init__(self, driver, from_yaml=None, **kwargs):
            self.driver = driver
            self.url = kwargs.get('url', None)
            self.title = kwargs.get('title', None)
            self.elements = kwargs.get('elements', {})
            self.actions = kwargs.get('url', OrderedDict())
            if from_yaml is not None:
                self.init_page(from_yaml)
    
        def init_page(self, from_yaml):
            with open(from_yaml, encoding='utf-8') as f:
                data = yaml.load(f)
                self.url = data.get('url', None)
                self.title = data.get('title', None)
                self.elements = data.get('elements', {})
                self.actions = OrderedDict(data.get('actions', {}))
    
        def open(self):  # 打开页面url
            if self.url is not None:
                self.driver.get(self.url)
    
        def on_page(self):  # 通过title判断是否在当前页面上
            if self.title is not None:
                return self.title in self.driver.title
    
        def input(self, element, text):  # 输入操作, 指定配置中的元素名及文本
            element = self.__getattr__(element)  #
            element.clear()
            element.send_keys(text)
    
        def click(self, element):  # 点击操作, 指定元素名
            element = self.__getattr__(element)
            element.click()
    
        def _handle_element(self, item):  # 处理要查找的页面元素
            element_loc = self.elements.get(item, None)
            if element_loc is not None:
                element = self.driver.find_element(*element_loc)  # todo try
                setattr(Page, item, element)  # 缓存元素作为页面属性
                return element
    
        def _handle_action(self, item):   # 处理要查找的操作方法
            action = self.actions.get(item, None)
            if action is not None:
    
                def pack_action(self, text=None):  # 解析约定的action格式, 组装操作方法
                    for step, params in action.items():
                        if step == 'input':
                            if text is not None and isinstance(params, list) and len(params)>1:
                                params[1] = text  # 使用调用时的text参数替换input: [search_ipt, $keyword]的第2个参数
                            self.input(*params)
                        elif step == 'click':
                            self.click(params)
    
                return MethodType(pack_action, self)  # 为实例绑定操作方法并返回
    
        def __getattr__(self, item):   # 查找页面属性和操作方法
            if not hasattr(Page, item):  # 如无该属性/方法则动态为页面添加元素属性和操作方法
                return self._handle_element(item) or self._handle_action(item)
    
    
    if __name__ == '__main__':   # 使用方法
        driver = webdriver.Chrome()
        baidu = Page(driver, 'baidu.yaml')  
        baidu.open()
        baidu.search('临渊')

## TODO ##

*  异常捕获
 *  单url框架页面的加载, 每个action的返回页面, 页面之间的流转
 *  缓存页面对象, 比如不同用例中多次调用baidu = PageFactory(driver, ...), 使用同一个退休
 *  增加更多的action支持, 如select, hover, switch等等
 *  独立模板解析parser方法, 支持更多的变量, 如`$1, $2/$keyword, $func(a)`等
 *  为Page增加hooks方法让使用更灵活

> **PS:**  
> 使用该Page Factory(页面工厂)方法暂时还没有减轻, 数十上百的页面编写工作, 只是从原来的编写Python类改为编写yaml配置文件, 然而,静态的配置文件相对与Python类来说, 有以下好处:

1.  实现了数据(页面元素定位器)与代码的分离
2.  PageFactory支持传入字典格式的配置参数来生成页面, 数据可以来源于yaml文件,也可以来源于页面表单/数据库,甚至爬虫爬取, 便于集成前端web页面, 或爬虫自动生成Pages

转载于:https://www.cnblogs.com/superhin/p/11454875.html

[https_github.com_SeleniumHQ_selenium_wiki_PageFactory]: https://github.com/SeleniumHQ/selenium/wiki/PageFactory