- 本项目采用UI MAP和Page Object设计模式
- 本项目由pytest、pytest-xdist、assertpy、selenium、PyMySQL、allure、redis的python模块组成
- pytest是python的一个单元测试框架,https://docs.pytest.org/en/latest/
- pytest-xdist是pytest的一个插件,可多进程同时执行测试用例,https://github.com/pytest-dev/pytest-xdist
- assertpy是一个包含丰富的断言库,支持pytest,https://github.com/ActivisionGameScience/assertpy
- selenium是ui自动化测试框架,https://www.seleniumhq.org/
- PyMySQL用于操作MySQL数据库,https://github.com/PyMySQL/PyMySQL
- allure用于生成测试报告,http://allure.qatools.ru/
- pip install -r requirements.txt
- 源安装
- sudo apt-add-repository ppa:qameta/allure
- sudo apt-get update
- sudo apt-get install allure
- 其他安装方式：https://github.com/allure-framework/allure2
- 手动安装
- 下载2.4.1版本:https://github.com/allure-framework/allure2/releases
- 解压allure-2.4.1.zip
- 加入系统环境变量:export PATH=/home/john/allure-2.4.1/bin:$PATH
- sudo add-apt-repository ppa:openjdk-r/ppa
- sudo apt-get update
- sudo apt-get install openjdk-8-jdk
- linux
- 安装libaio包
- centos:yum install libaio
- ubuntu:apt-get install libaio1
- 配置Oracle Instant Client
-
下载地址:http://www.oracle.com/technetwork/topics/linuxx86-64soft-092277.html
-
下载安装包instantclient-basic-linux.x64-18.3.0.0.0dbru.zip
-
解压zip包,并配置/etc/profile
- unzip instantclient-basic-linux.x64-18.3.0.0.0dbru.zip
- export LD_LIBRARY_PATH=/home/john/oracle_instant_client/instantclient_18_3:$LD_LIBRARY_PATH
-
中文编码设置
import os os.environ['NLS_LANG'] = 'SIMPLIFIED CHINESE_CHINA.UTF8'
-
- 安装libaio包
- Windows
- 下载地址:http://www.oracle.com/technetwork/topics/winx64soft-089540.html
- 下载安装包instantclient-basic-windows.x64-11.2.0.4.0.zip
- 解压zip包,并配置环境变量
- 系统环境变量加入D:\instantclient-basic-windows.x64-11.2.0.4.0\instantclient_11_2
- 配置中文编码,环境变量创建NLS_LANG=SIMPLIFIED CHINESE_CHINA.UTF8
- 注意:如果使用64位,python和instantclient都需要使用64位
- export JAVA_HOME=/usr/lib/jvm/jdk8
- export JRE_HOME=${JAVA_HOME}/jre
- export CLASSPATH=.:${JAVA_HOME}/lib:${JRE_HOME}/lib
- export PATH=${JAVA_HOME}/bin:$PATH
- 配置selenium server
- 下载selenium-server-standalone-3.14.0.jar
- 下载地址:http://selenium-release.storage.googleapis.com/index.html
- 以管理员身份启动服务:java -jar selenium-server-standalone-3.14.0.jar -log selenium.log
- 下载浏览器驱动
- 谷歌浏览器：https://chromedriver.storage.googleapis.com/index.html
- 火狐浏览器：https://github.com/mozilla/geckodriver/
- IE浏览器(建议使用32位,64位操作极慢)：http://selenium-release.storage.googleapis.com/index.html
- 将驱动所在目录加入到selenium server服务器系统环境变量:export PATH=/home/john/selenium/:$PATH
- IE浏览器设置
- 在Windows Vista、Windows7系统上的IE浏览器在IE7及以上版本中，需要设置四个区域的保护模式为一样，设置开启或者关闭都可以。
- 工具-->Internet选项-->安全
- IE10及以上版本增强保护模式需要关闭。
- 工具-->Internet选项-->高级
- 浏览器缩放级别必须设置为100%，以便本地鼠标事件可以设置为正确的坐标。
- 针对IE11需要设置注册表以便于浏览器驱动与浏览器建立连接
- Windows 64位：HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE
- Windows 32位：HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Internet Explorer\Main\FeatureControl\FEATURE_BFCACHE
- 如果FEATRUE_BFCACHE项不存在，需要创建一个，然后在里面创建一个DWORD(32位)，命名为iexplore.exe，值为0
- Windows 64位两个注册表建议都设置
- IE8及以上版本设置支持inprivate模式，以便多开IE窗口时cookies能够独享
- HKKY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main 下建一个名为TabProcGrowth的DWORD(32位)，值为0
- 重启系统
- 注:https://github.com/SeleniumHQ/selenium/wiki/InternetExplorerDriver#required-configuration
- 在Windows Vista、Windows7系统上的IE浏览器在IE7及以上版本中，需要设置四个区域的保护模式为一样，设置开启或者关闭都可以。
- vim config/config.conf 配置测试信息
- vim config/init.conf 配置需要初始化的项目
- vim config/projectName/projectName.conf 配置测试项目的信息
- cd WEBUIAutomationTest/
- python runTest.py --help
- python runTest.py 运行cases目录所有的用例
- python runTest.py -k keyword 运行匹配关键字的用例，会匹配文件名、类名、方法名
- python runTest.py -d dir 运行指定目录的用例，默认运行cases目录
- cd WEBUIAutomationTest/
- python generateReport.py -ieport 9080 -chromeport 9081 -firefoxport 9082
- 访问地址http://ip:908[0-3]
- 在使用Ubuntu进行报告生成时，请勿使用sudo权限，否则无法生成，allure不支持
- 元素的显式等待时间默认为30s
- 封装的显式等待类型支持:page_objects/wait_type.py
- 封装的定位类型支持:page_objects/locator_type.py
- 默认使用4个worker进行并行测试
- 项目
- demoProject
- 例子项目
- demoProject
- base 基础请求类
- cases 测试用例目录
- common 公共模块
- config 配置文件
- init 初始化
- logs 日志目录
- output 测试结果输出目录
- page_objects 页面元素映射和页面对象
- pojo 存放自定义类对象
- test_data 测试所需的测试数据目录
- runTest.py 测试运行脚本
- generateReport.py 报告生成脚本
- 统一使用python 2.7
- 编码使用-*- coding:utf8 -*-,且不指定解释器
- 所有中文都直接使用字符串，不转换成Unicode，即不是用【u'中文'】编写
- 类/方法的注释均写在class/def下一行，并且用三个双引号形式注释
- 局部代码注释使用#号
- 所有的测试模块文件都以test_projectName_moduleName.py命名
- 所有的测试类都以Test开头，类中方法(用例)都以test_开头
- case对应setup/teardown的fixture统一命名成fixture_[test_case_method_name]
- 每一个模块中测试用例如果有顺序要求，则自上而下排序，pytest在单个模块里会自上而下按顺序执行
- @pytest.mark.skip(reason='该功能已废弃')
- @pytest.mark.parametrize('key1,key2',[(key1_value1,key2_value2),(key1_value2,key2_value2)])
- @pytest.mark.usefixture('func_name')
- 运行pytest时指定的目录内应当有conftest.py，方能在其他模块中使用。@allure.step会影响fixture，故在脚本中不使用@allure.step
- 统一使用Firefox浏览器进行元素定位
- 能用id、name、link(不常变化的链接)定位的，不使用css定位，能使用css定位，不使用xpath定位
- 项目使用并发运行，故编写测试用例时，应该避免模块与模块直接的用例会相互影响测试结果
