python_selenium自動化測試框架

設計思路

 本文整理歸納以往的工作中用到的東西，現匯總成基礎測試框架提供分享。

框架采用python3 + selenium3 + PO + yaml + ddt + unittest等技術編寫成基礎測試框架，能適應日常測試工作需要。

1、使用Page Object模式將頁面定位和業務操作分開，分離測試對象（元素對象）和測試腳本（用例腳本），一個頁面建一個對象類，提高用例的可維護性；

2、使用yaml管理頁面控件元素數據和測試用例數據。例如元素ID等發生變化時，不需要去修改測試代碼，只需要在對應的頁面元素yaml文件中修改即可；

3、分模塊管理，互不影響，隨時組裝，即拿即用。

GitHub項目地址：https://github.com/yingoja/DemoUI

測試框架分層設計

 

• 把常見的操作和查找封裝成基礎類，不管是什么產品，可直接拿來復用
• 業務層主要是封裝對象頁面類，一個頁面建一個類，業務層頁面繼承基礎層
• 用例層針對產品頁面功能進行構造摸擬執行測試
• 框架層提供基礎組件，支撐整個流程執行及功能擴展，給用例層提供各頁面的元素數據、用例測試數據，測試報告輸出等

 測試框架目錄結構

如下思維導圖目錄結構介紹：

 編寫用例方法

 1 testinfo:  2 - id: test_login001  3  title: 登錄測試  4  info: 打開抽屜首頁  5 testcase:  6 - element_info: login-link-a  7  find_type: ID  8  operate_type: click  9  info: 打開登錄對話框 10 - element_info: mobile 11  find_type: ID 12  operate_type: send_keys 13  info: 輸入手機號 14 - element_info: mbpwd 15  find_type: ID 16  operate_type: send_keys 17  info: 輸入密碼 18 - element_info: //input[@class='keeplogin'] 19  find_type: XPATH 20  operate_type: click 21  info: 單擊取消自動登錄單選框 22 - element_info: //span[text()='登錄'] 23  find_type: XPATH 24  operate_type: click 25  info: 單擊登錄按鈕 26 - element_info: userProNick 27  find_type: ID 28  operate_type: perform 29  info: 鼠標懸停賬戶菜單 30 - element_info: //a[@class='logout'] 31  find_type: XPATH 32  operate_type: click 33  info: 選擇退出 34 check: 35 - element_info: //div[@class='box-mobilelogin']/div[1]/span 36  find_type: XPATH 37  info: 檢查輸入手機號或密碼，登錄異常提示 38 - element_info: userProNick 39  find_type: ID 40  info: 成功登錄 41 - element_info: reg-link-a 42  find_type: ID 43 info: 檢查退出登錄是否成功

例如，我們要新增登錄功能測試用例：

首先，只需在testyaml目錄下新增一個頁面對象yaml文件，參考login.yaml格式編寫即可。這些文件是提供給封裝頁面對象類調用並執行定位識別操作。

 1 -
 2 id: test_login001.1  3  detail : 手機號和密碼為空登錄  4  screenshot : phone_pawd_empty  5  data:  6 phone: ""  7 password: ""  8  check :  9 - 手機號不能為空 10 - 11 id: test_login001.2 12  detail : 手機號為空登錄 13  screenshot : phone_empty 14  data : 15 phone: "" 16  password : aa 17  check : 18 - 手機號不能為空 19 - 20 id: test_login001.3 21  detail : 密碼為空登錄 22  screenshot : pawd_empty 23  data : 24 phone : 13511112222 25 password: "" 26  check : 27 - 密碼不能為空 28 - 29 id: test_login001.4 30  detail : 非法手機號登錄 31  screenshot : phone_error 32  data : 33  phone : abc 34  password: aa 35  check : 36 - 手機號格式不對 37 - 38 id: test_login001.5 39  detail : 手機號或密碼不匹配 40  screenshot : pawd_error 41  data : 42 phone : 13511112222 43  password: aa 44  check : 45 - 賬號密碼錯誤 46 - 47 id: test_login001.6 48  detail : 手機號和密碼正確 49  screenshot : phone_pawd_success 50  data : 51 phone : 13865439800 52 password: ******** 53  check : 54 - yingoja 55 56 login_data.yaml

其次，在testdata目錄下新增一個login_data.yaml文件提供給登錄接口傳參的測試數據，編寫格式參考login_data.yaml文件。

  1 #!/usr/bin/env python  2 # _*_ coding:utf-8 _*_  3 __author__ = 'YinJia'  4  5 import os,sys  6 sys.path.append(os.path.dirname(os.path.dirname(os.path.dirname(__file__))))  7 from config import setting  8 from selenium.webdriver.support.select import Select  9 from selenium.webdriver.common.action_chains import ActionChains  10 from selenium.webdriver.common.by import By  11 from public.page_obj.base import Page  12 from time import sleep  13 from public.models.GetYaml import getyaml  14  15 testData = getyaml(setting.TEST_Element_YAML + '/' + 'login.yaml')  16  17 class login(Page):  18 """  19  用戶登錄頁面  20 """  21 url = '/'  22 dig_login_button_loc = (By.ID, testData.get_elementinfo(0))  23 def dig_login(self):  24 """  25  首頁登錄  26  :return:  27 """  28 self.find_element(*self.dig_login_button_loc).click()  29 sleep(1)  30  31 # 定位器，通過元素屬性定位元素對象  32 # 手機號輸入框  33 login_phone_loc = (By.ID,testData.get_elementinfo(1))  34 # 密碼輸入框  35 login_password_loc = (By.ID,testData.get_elementinfo(2))  36 # 取消自動登錄  37 keeplogin_button_loc = (By.XPATH,testData.get_elementinfo(3))  38 # 單擊登錄  39 login_user_loc = (By.XPATH,testData.get_elementinfo(4))  40 # 退出登錄  41 login_exit_loc = (By.ID, testData.get_elementinfo(5))  42 # 選擇退出  43 login_exit_button_loc = (By.XPATH,testData.get_elementinfo(6))  44  45 def login_phone(self,phone):  46 """  47  登錄手機號  48  :param username:  49  :return:  50 """  51 self.find_element(*self.login_phone_loc).send_keys(phone)  52  53 def login_password(self,password):  54 """  55  登錄密碼  56  :param password:  57  :return:  58 """  59 self.find_element(*self.login_password_loc).send_keys(password)  60  61 def keeplogin(self):  62 """  63  取消單選自動登錄  64  :return:  65 """  66 self.find_element(*self.keeplogin_button_loc).click()  67  68 def login_button(self):  69 """  70  登錄按鈕  71  :return:  72 """  73 self.find_element(*self.login_user_loc).click()  74  75 def login_exit(self):  76 """  77  退出系統  78  :return:  79 """  80 above = self.find_element(*self.login_exit_loc)  81  ActionChains(self.driver).move_to_element(above).perform()  82 sleep(2)  83 self.find_element(*self.login_exit_button_loc).click()  84  85 def user_login(self,phone,password):  86 """  87  登錄入口  88  :param username: 用戶名  89  :param password: 密碼  90  :return:  91 """  92  self.open()  93  self.dig_login()  94  self.login_phone(phone)  95  self.login_password(password)  96 sleep(1)  97  self.keeplogin()  98 sleep(1)  99  self.login_button() 100 sleep(1) 101 102 phone_pawd_error_hint_loc = (By.XPATH,testData.get_CheckElementinfo(0)) 103 user_login_success_loc = (By.ID,testData.get_CheckElementinfo(1)) 104 exit_login_success_loc = (By.ID,testData.get_CheckElementinfo(2)) 105 106 # 手機號或密碼錯誤提示 107 def phone_pawd_error_hint(self): 108 return self.find_element(*self.phone_pawd_error_hint_loc).text 109 110 # 登錄成功用戶名 111 def user_login_success_hint(self): 112 return self.find_element(*self.user_login_success_loc).text 113 114 # 退出登錄 115 def exit_login_success_hint(self): 116 return self.find_element(*self.exit_login_success_loc).text

然后，在page_obj目錄下新增一個loginPage.py文件，是用來封裝登錄頁面對象類，執行登錄測試流程操作。

 1 #!/usr/bin/env python  2 # _*_ coding:utf-8 _*_  3 __author__ = 'YinJia'  4  5  6 import os,sys  7 sys.path.append(os.path.dirname(os.path.dirname(__file__)))  8 import unittest,ddt,yaml  9 from config import setting 10 from public.models import myunit,screenshot 11 from public.page_obj.loginPage import login 12 from public.models.log import Log 13 14 try: 15 f =open(setting.TEST_DATA_YAML + '/' + 'login_data.yaml',encoding='utf-8') 16 testData = yaml.load(f) 17 except FileNotFoundError as file: 18 log = Log() 19 log.error("文件不存在：{0}".format(file)) 20 21 @ddt.ddt 22 class Demo_UI(myunit.MyTest): 23 """抽屜新熱榜登錄測試""" 24 def user_login_verify(self,phone,password): 25 """ 26  用戶登錄 27  :param phone: 手機號 28  :param password: 密碼 29  :return: 30 """ 31  login(self.driver).user_login(phone,password) 32 33 def exit_login_check(self): 34 """ 35  退出登錄 36  :return: 37 """ 38  login(self.driver).login_exit() 39 40 @ddt.data(*testData) 41 def test_login(self,datayaml): 42 """ 43  登錄測試 44  :param datayaml: 加載login_data登錄測試數據 45  :return: 46 """ 47 log = Log() 48 log.info("當前執行測試用例ID-> {0} ; 測試點-> {1}".format(datayaml['id'],datayaml['detail'])) 49 # 調用登錄方法 50 self.user_login_verify(datayaml['data']['phone'],datayaml['data']['password']) 51 po = login(self.driver) 52 if datayaml['screenshot'] == 'phone_pawd_success': 53 log.info("檢查點-> {0}".format(po.user_login_success_hint())) 54 self.assertEqual(po.user_login_success_hint(), datayaml['check'][0], "成功登錄，返回實際結果是->: {0}".format(po.user_login_success_hint())) 55 log.info("成功登錄，返回實際結果是->: {0}".format(po.user_login_success_hint())) 56 screenshot.insert_img(self.driver, datayaml['screenshot'] + '.jpg') 57 log.info("-----> 開始執行退出流程操作") 58  self.exit_login_check() 59 po_exit = login(self.driver) 60 log.info("檢查點-> 找到{0}元素,表示退出成功！".format(po_exit.exit_login_success_hint())) 61 self.assertEqual(po_exit.exit_login_success_hint(), '注冊',"退出登錄，返回實際結果是->: {0}".format(po_exit.exit_login_success_hint())) 62 log.info("退出登錄，返回實際結果是->: {0}".format(po_exit.exit_login_success_hint())) 63 else: 64 log.info("檢查點-> {0}".format(po.phone_pawd_error_hint())) 65 self.assertEqual(po.phone_pawd_error_hint(),datayaml['check'][0] , "異常登錄，返回實際結果是->: {0}".format(po.phone_pawd_error_hint())) 66 log.info("異常登錄，返回實際結果是->: {0}".format(po.phone_pawd_error_hint())) 67 screenshot.insert_img(self.driver,datayaml['screenshot'] + '.jpg') 68 69 if __name__=='__main__': 70 unittest.main()

最后，在testcase目錄下創建測試用例文件login_sta.py，采用ddt數據驅動讀取yaml測試數據文件

綜上所述，編寫用例方法只需要按以上四個步驟創建->編寫即可。

執行如下主程序，可看輸出的實際結果。

 1 #!/usr/bin/env python  2 # _*_ coding:utf-8 _*_  3 __author__ = 'YinJia'  4  5 import os,sys  6 sys.path.append(os.path.dirname(__file__))  7 from config import setting  8 import unittest,time  9 from package.HTMLTestRunner import HTMLTestRunner 10 from public.models.newReport import new_report 11 from public.models.sendmail import send_mail 12 13 # 測試報告存放文件夾，如不存在，則自動創建一個report目錄 14 if not os.path.exists(setting.TEST_REPORT):os.makedirs(setting.TEST_REPORT + '/' + "screenshot") 15 16 def add_case(test_path=setting.TEST_DIR): 17 """加載所有的測試用例""" 18 discover = unittest.defaultTestLoader.discover(test_path, pattern='*_sta.py') 19 return discover 20 21 def run_case(all_case,result_path=setting.TEST_REPORT): 22 """執行所有的測試用例""" 23 now = time.strftime("%Y-%m-%d %H_%M_%S") 24 filename = result_path + '/' + now + 'result.html' 25 fp = open(filename,'wb') 26 runner = HTMLTestRunner(stream=fp,title='抽屜新熱榜UI自動化測試報告', 27 description='環境：windows 7 瀏覽器：chrome', 28 tester='Jason') 29  runner.run(all_case) 30  fp.close() 31 report = new_report(setting.TEST_REPORT) #調用模塊生成最新的報告 32 send_mail(report) #調用發送郵件模塊 33 34 if __name__ =="__main__": 35 cases = add_case() 36 run_case(cases)

測試結果展示

• HTML報告日志

• HTML報告點擊截圖，彈出截圖

• 測試報告通過的日志

• 自動截圖存放指定的目錄

• 郵件測試報告