python3 webUi自动化测试框架

# webTest框架介绍 ### 简介 本框架基于Python3+selenium3+unittest组成，用户以Page Object的模式编写用例。 元素的定位和操作按照页面划分，达到Web端自动化回归测试的目的， 并生成测试报告。浏览器兼容性暂时未完善。 本例子展示了一个必应首页搜索"龙珠超"的测试用例，比较简陋。 列举一下相关的亮点: - ❤️ 支持xmind文件转为测试用例，目前存在部分问题 - 💛 支持chrome驱动自动下载 - 💚 支持用例重跑及自动错误截图 - 💙 使用antd美化html报告 - 💜 采用po模式，定位元素与实际操作分离，同一个页面的操作代码可复用 - 🖤 优化api，智能等待用例，拒绝代码中time.sleep等待元素 - 💔 其他（可在下方留言或github issue提需求） ### 运行日志  ### 过程截图  ### 效果展示  ### 快速上手 - 从远程仓库拉取代码 ```git clone https://github.com/wuranxu/webTest.git```  - 安装依赖包 进入下载好的webTest目录，并在此目录运行安装依赖, 需要安装好pip(默认自带的就行) mac/Linux/windows: ```pip3 install -r requirements.py -i https://pypi.douban.com/simple``` - 运行demo 在webTest目录输入命令(确保chrome浏览器已安装, 驱动会自行下载): ```python3 start_test.py```  #### 配置说明 见config.py，大部分说明都有对应的描述，RETRY是全局重试次数。可以参考XmindTest.py文件里面的retry字段，设置单个用例的重试次数。 ### 环境配置 ##### 注: 无桌面版Linux目前只做到支持firefox - os: Windows/Mac os x/Linux - Python3.x - Chrome浏览器 ### 目录结构 ``` project └───error | └───database | └───logs | └───xmind | └───page | └───report | └───tests | | base_case.py | └───templates | | report_templates.html └───result | | report_templates.html | | generator.py | | text_test_result.py | └───chromedriver │ │ chromedriver.exe | └───util | | chrome.py | | decorator.py | | driver.py | | utils.py | | logger.py | | web_tool.py | │ README.md │ run_case.py | requirements.txt │ config.py | webdriver_test.log ``` ### 内容介绍 - chromedriver 存放chromedriver驱动, 若本机未安装chromedriver则自动匹配本机chrome版本下载对应驱动。 - database 存放Mysql和Mongodb的连接类 - error 异常分类 - screenshot 存放出错截图, 目前根据用例名称创建文件夹并存放。 - logs 存放所有日志文件, 目前只有webdriver_test.log, 主要目的是将日志区分开来。 - page 页面目录, 可扩展, 针对不同模块的页面可设计不同目录结构。一般存放该页面的操作(Action)以及元素(Location), 用例具体断言不建议写于此处(因人而异)。 - Report 存放测试报告，为html形式，可右键通过浏览器打开，使用chrome效果尤佳。 - templates 存放html模板，传入测试结果以生成测试报告。 - result - generator.py 是组织测试结果, 生成测试报告, 填入数据至html报告模板的方法。 - text_test_result.py 继承自unittest.TextTestResult类, 存放测试结果。 - tests 测试套件目录, 可扩展, 子目录为某个测试集。测试集中存放测试用例。 - base_case.py 存放基础测试用例。 - util - chrome.py 用于更新/下载chromedriver, 目前只支持mac os和windows系统。 - decorator.py 用于存放自动截图/重跑等装饰器, 主要是为测试函数添加错误截图以及重跑等功能。 - driver.py 继承自WebDriver类, 主要用于简化原生api以及添加切换frame/handle等api。 - logger.py 记录日志的功能函数。 - web_tool.py 用于Web自动化测试的工具类, 包括截图、获取用例等方法。 - xmind_reader.py 用于解析xmind文件，暂时不支持过于复杂的xmind。用例的大概编写方式如下图。  - xmind 存放Xmind文件, xmind文件用于编写测试用例。 - config.py 用于存放绝大部分配置。继承于BaseConf类, 可拥有自己的配置。 - requirements.txt 用于存放本框架所需库。 - start_test.py 存放组织用例, 生成测试套件, 运行测试用例等函数。 - webdriver_test.log 存放测试用例执行时候的有关操作和错误信息等。 #### 注: 以上目录结构/命名可能并不合理, 还望海涵。 --- ### 使用手册 ##### 以下内容若已安装, 可跳过。 - 安装Python3 [Python3.6下载地址](https://www.python.org/downloads/release/python-364/) 下载对应操作系统的Python版本并安装。 - 下载IDE(非必须) 推荐Pycharm [Pycharm下载地址](https://www.jetbrains.com/pycharm/) - 安装必须的库 目录中有install.py, 安装好Python之后, 在终端窗口中输入如下命令: Linux/mac: ```python3 install.py``` windows: ```python install.py``` 注意: 安装时需要带上install.py路径或者进入该文件所在目录。 - Pycharm配置(若有) - 第一步: 配置项目Python环境 File->Open  选择webTest目录, 点击窗口右下角的Open  打开Preferences, 在Project Interpreter里选择刚才安装Python的地址, 点击OK  - 第二步: 配置start_test.py 点击Edit Configurations  如果没有Python配置的话, 点击图中"+"图标, 然后选择Python并添加   配置脚本  - 第三步: 运行用例 右击start_test.py, 选择Run则为运行模式, Debug则为调试模式  - 用例编写规则 Python: - 可参考Search.py编写用例(最好用例的类名不重复) - 用例需要写在TestSuite/测试集/这种目录下 - 用例需要继承base_case.py - 用例需要以test开头如test_bmp - 用例的test函数需要带上screenshot的装饰�