
- 本项目支持接口自动化测试、app ui自动化测试、web ui自动化测试、性能测试
- 本项目由以下工具组成
- pytest:python的一个单元测试框架,https://docs.pytest.org/en/latest/
- pytest-xdist:pytest的一个插件,可多进程同时执行测试用例,https://github.com/pytest-dev/pytest-xdist
- allure-pytest:用于生成测试报告,http://allure.qatools.ru/
- PyHamcrest:一个匹配器对象的框架,用于断言,https://github.com/hamcrest/PyHamcrest
- requests:http请求框架,http://docs.python-requests.org/en/master/
- Appium:移动端的自动化测试框架,https://github.com/appium/appium/tree/v1.15.1
- selenium:web ui自动化测试框架,https://www.seleniumhq.org/
- cx_Oracle:oracle操作库,https://cx-oracle.readthedocs.io/en/latest/index.html
- JPype1:用于执行java代码,https://github.com/jpype-project/jpype
- paramiko:ssh客户端,https://docs.paramiko.org/en/stable/
- Pillow:用于图片处理,https://pillow.readthedocs.io/en/latest/
- PyMySQL:用于操作MySQL数据库,https://github.com/PyMySQL/PyMySQL
- redis:redis客户端,https://pypi.org/project/redis/
- tess4j:java的图片识别工具,https://github.com/nguyenq/tess4j/
- allpairspy: 用于将参数列表进行正交分析,实现正交分析法用例覆盖,https://pypi.org/project/allpairspy/
- python-binary-memcached:用于操作memcached,https://github.com/jaysonsantos/python-binary-memcached
- kazoo:用于操作zookeeper,https://github.com/python-zk/kazoo
- websockets:用于websocket请求,https://github.com/aaugustin/websockets
- Js2Py:用于执行js代码,https://github.com/PiotrDabkowski/Js2Py
- sqlacodegen:用于根据数据库表结构生成python对象,https://github.com/agronholm/sqlacodegen
- SQLAlchemy:SQL工具包及对象关系映射(ORM)工具,https://github.com/sqlalchemy/sqlalchemy
- 当前仅支持Python>=3.6,建议安装Python V3.6.8版本
- 项目如需执行java代码(即使用jpype1),则项目目录所在的路径不可包含中文
一、环境准备
1、脚本运行环境准备
1.1、安装系统依赖
- Linux-Ubuntu:
- apt-get install libpq-dev python3-dev 【用于psycopg2-binary所需依赖】
- apt-get install g++ libgraphicsmagick++1-dev libboost-python-dev 【用于pgmagick所需依赖】
- apt-get install python-pgmagick 【pgmagick所需依赖】
- Linux-CentOS:
- yum install python3-devel postgresql-devel 【用于psycopg2-binary所需依赖】
- yum install GraphicsMagick-c++-devel boost boost-devel【用于pgmagick所需依赖】
- Windows:
1.2、安装python依赖模块
- pip3 install -r requirements.txt
- 安装pgmagick
- Linux:
- pip3 install pgmagick==0.7.6
- Windows:
- 安装xmind-sdk-python
1.3、安装allure
1.4、安装openjdk8或jdk8
- sudo add-apt-repository ppa:openjdk-r/ppa
- sudo apt-get update
- sudo apt-get install openjdk-8-jdk
1.5、安装maven
1.6、安装Oracle Instant Client
- Linux
- 安装libaio包
- Linux-CentOS:yum install libaio
- Linux-Ubuntu:apt-get install libaio1
- 配置Oracle Instant Client
- Windows
1.7、图像识别字库准备
2、selenium server运行环境准备
2.1、安装jdk1.8,并配置环境变量
- 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
2.2、安装配置selenium
- 配置selenium server
- 下载浏览器驱动
- IE浏览器设置
- 在Windows Vista、Windows7系统上的IE浏览器在IE7及以上版本中,需要设置四个区域的保护模式为一样,设置开启或者关闭都可以。
- IE10及以上版本增强保护模式需要关闭。
- 浏览器缩放级别必须设置为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
3、appium server运行环境准备
3.1、安装jdk1.8,并配置环境变量
- 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
3.2、安装配置appium server
二、修改配置
- vim config/app_ui_config.conf 配置app ui自动化的测试信息
- vim config/web_ui_config.conf 配置web ui自动化的测试信息
- vim config/projectName/projectName.conf 配置测试项目的信息
- 修改性能测试负载机的系统最大打开文件数,避免并发用户数大于最大打开文件数
三、运行测试
1、API测试
- cd AutomationTest/
- python3 -u run_api_test.py –help
- python3 -u run_api_test.py 运行cases/api/目录所有的用例
- python3 -u run_api_test.py -k keyword 运行匹配关键字的用例,会匹配文件名、类名、方法名
- python3 -u run_api_test.py -d dir 运行指定目录的用例,默认运行cases/api/目录
- python3 -u run_api_test.py -m mark 运行指定标记的用例
2、web ui测试
- cd AutomationTest/
- python3 -u run_web_ui_test.py –help
- python3 -u run_web_ui_test.py 运行cases/web_ui/目录所有的用例
- python3 -u run_web_ui_test.py -k keyword 运行匹配关键字的用例,会匹配文件名、类名、方法名
- python3 -u run_web_ui_test.py -d dir 运行指定目录的用例,默认运行cases/web_ui/目录
- python3 -u run_web_ui_test.py -m mark 运行指定标记的用例
3、app ui测试
- cd AutomationTest/
- python3 -u run_app_ui_test.py –help
- python3 -u run_app_ui_test.py 运行cases/app_ui/目录所有的用例
- python3 -u run_app_ui_test.py -tt phone -k keyword 运行匹配关键字的用例,会匹配文件名、类名、方法名
- python3 -u run_app_ui_test.py -tt phone -d dir 运行指定目录的用例,默认运行cases/app_ui/目录
- python3 -u run_app_ui_test.py -m mark 运行指定标记的用例
4、性能测试
- cd AutomationTest/
- ./start_locust_master.sh
- ./start_locust_slave.sh
四、生成测试报告
1、API测试
- cd AutomationTest/
- python3 -u generate_api_test_report.py -p 9080
- 访问地址http://ip:9080
- 在使用Ubuntu进行报告生成时,请勿使用sudo权限,否则无法生成,allure不支持
2、web ui测试
- cd AutomationTest/
- python3 -u generateReport_web_ui_test_report.py -ieport 9081 -chromeport 9082 -firefoxport 9083
- 访问地址http://ip:908[1-3]
- 在使用Ubuntu进行报告生成时,请勿使用sudo权限,否则无法生成,allure不支持
3、app ui测试
- cd AutomationTest/
- python3 -u generateReport_app_ui_test_report.py -sp 9084
- 访问地址http://ip:9084
注:在使用Ubuntu进行报告生成时,请勿使用sudo权限,否则无法生成,allure不支持
五、项目说明
1、API测试
2、web ui测试
- 元素的显式等待时间默认为30s
- 封装的显式等待类型支持:page_objects/web_ui/wait_type.py
- 封装的定位类型支持:page_objects/web_ui/locator_type.py
- 默认使用4个worker进行并行测试
- 文件下载处理暂不支持ie浏览器
- 无头浏览器暂不支持ie浏览器
- 项目
3、app ui测试
- 元素的显式等待时间默认为30s
- 封装的显式等待类型支持:page_objects/app_ui/wait_type.py
- 封装的定位类型支持:page_objects/app_ui/locator_type.py
- 项目
- base 基础请求类
- cases 测试用例目录
- common 公共模块
- common_projects 每个项目的公共模块
- config 配置文件
- init 初始化
- logs 日志目录
- output 测试结果输出目录
- packages app ui测试的安装包
- page_objects 页面映射对象
- pojo 存放自定义类对象
- test_data 测试所需的测试数据目录
- run_api_test.py 运行api测试脚本
- run_web_ui_test.py 运行web ui测试脚本
- run_app_ui_test.py 运行app ui测试脚本
- generate_api_test_report.py 生成api测试报告
- generateReport_web_ui_test_report.py 生成web ui测试报告
- generateReport_app_ui_test_report.py 生成app ui测试报告
- start_locust_master.sh 启动locust主节点
- start_locust_slave.sh 启动locust从节点
- 统一使用python 3.6.8
- 编码使用-*- coding:utf8 -*-,且不指定解释器
- 类/方法的注释均写在class/def下一行,并且用三个双引号形式注释
- 局部代码注释使用#号
- 所有中文都直接使用字符串,不转换成Unicode,即不是用【u’中文’】编写
- 所有的测试模块文件都以test_projectName_moduleName.py命名
- 所有的测试类都以Test开头,类中方法(用例)都以test_开头
- 每个测试项目都在cases目录里创建一个目录,且目录都包含有api、scenrarios两个目录
- case对应setup/teardown的fixture统一命名成fixture_[test_case_method_name]
- 每一个模块中测试用例如果有顺序要求【主要针对ui自动化测试】,则自上而下排序,pytest在单个模块里会自上而下按顺序执行
- @pytest.mark.skip(reason=’该功能已废弃’)
- @pytest.mark.parametrize(‘key1,key2’,[(key1_value1,key2_value2),(key1_value2,key2_value2)])
- @pytest.mark.usefixtures(‘func_name’)
- 运行pytest时指定的目录内应当有conftest.py,方能在其他模块中使用。@allure.step会影响fixture,故在脚本中不使用@allure.step
- 由于web ui配置的驱动是直接设置在系统环境变量,app ui指定了混合应用的浏览器驱动,在运行app ui时appium有可能会读取到系统的环境变量的配置,故运行时请排查此情况
- 数据库操作,所有表操作均进行单表操作,如需多表查询,使用代码进行聚合
- web ui测试
- 统一使用Firefox浏览器进行元素定位
- 能用id、name、link(不常变化的链接)定位的,不使用css定位,能使用css定位,不使用xpath定位
- 项目使用并发运行,故编写测试用例时,应该避免模块与模块直接的用例会相互影响测试结果
- app ui测试



自动化测试
概况
使用
一、环境准备
1、脚本运行环境准备
1.1、安装系统依赖
1.2、安装python依赖模块
1.3、安装allure
1.4、安装openjdk8或jdk8
1.5、安装maven
1.6、安装Oracle Instant Client
1.7、图像识别字库准备
2、selenium server运行环境准备
2.1、安装jdk1.8,并配置环境变量
2.2、安装配置selenium
3、appium server运行环境准备
3.1、安装jdk1.8,并配置环境变量
3.2、安装配置appium server
安装appium desktop server
Android环境准备
IOS环境准备
手机chrome环境准备
混合应用环境准备
Windows环境准备
其他更多配置:https://github.com/appium/appium/tree/v1.15.1/docs/en/drivers
二、修改配置
三、运行测试
1、API测试
2、web ui测试
3、app ui测试
4、性能测试
四、生成测试报告
1、API测试
2、web ui测试
3、app ui测试
注:在使用Ubuntu进行报告生成时,请勿使用sudo权限,否则无法生成,allure不支持
五、项目说明
1、API测试
2、web ui测试
3、app ui测试
项目结构
编码规范
pytest常用
注意点
进交流群
