(这个是内部分享文档,侧重于测试报告的生成以及持续集成,至于接口框架的内部组织可以按照自己的想法来实现,有问题欢迎留言)
1.环境:
• 操作系统:windows 64位
• 软件环境:python3.4.4;jdk1.8;jenkins1.65
2.基本环境配置:
• python 添加到系统变量
• jdk环境配置(注意,jdk安装路径中不要包含括号、空号,否则执行allure命令时会报 此时不应有 \java\jdk1.8.0_111 错误,原因是allure的bat文件解析java home的时存没有处理)
• jenkins安装
3.第三方库安装
• pytest安装:在cmd命令下使用 pip install pytest ;
测试:在python 语言环境下import pytest 如果未报错表示安装成功
• pytest_allure_adaptor安装:在cmd命令下使用 pip install pytest_allure_adaptor
安装pytest_allure_adaptor注意事项
pytest_allure_adaptor依赖一些python的第三方库,其中lxml库在安装过程中容易出现 error: Microsoft Visual C++ 10.0 is required (Unable to find vcvarsall.bat).导致整个安装失败。
原因:是python安装编译会调用本版本所用编译器进行编译。所以关键是找到正确的编译器以及commontools路径。2.7版本使用VS9编译,对于3.4版本,是使用VS10编译的.
解决办法:
1.在cmd命令下执行 pip install wheel
2.在http://www.lfd.uci.edu/~gohlke/pythonlibs/#lxml 下载对应的,一定要是和python版本+系统版本对应的的lxml*.whl文件(如:lxml-3.4.4-cp34-none-win_amd64.whl 注意:3.4.4表示lxml版本;cp表示python版本;amd64表示系统环境64位)
3.pip install lxml*.whl
• 其他库的安装:都可以使用pip install 库名称
• 下载allure执行工具:https://github.com/allure-framework/allure-core/releases/tag/allure-core-1.4.23 ;可以将allure执行工具的bin目录添加到系统变量path中。
4.生成allure所需要的测试结果文件
• 在cmd命令执行测试代码:py.test 测试用例目录 –alluredir=./allure-result
生成allure所需要的测试结果文件
py.test 测试用例目录 –alluredir=./allure-result
其中 –alluredir 表示生成测试结果保存路径; ./allure-result 表示当前路径下的allure-result文件下;在生成报告前会将报告存放路径下的文件夹清空
• 使用allure执行工具生成报告
使用allure工具生成报告
在allure执行工具的bin目录下对于linux与windows都有对应的脚本支持。
使用方法:
前提:执行测试后生成了对应xml结果文件,如 allure-result
生成测试报告:在cmd命令行中使用 allure generate allure-result 执行后会在该目录下生成allure-report文件,再使用allure report open 可以在本地查看报告.(备注:allure的报告需要有Server服务器apache、tomcat、jetty等才能被查看)
(在cmd命令下使用 allure help 可以查看详细的参数说明)
5.用例中使用allure(需要 import allure):
• 在报告中增加步骤显示,如下:使用 with pytest.allure.step(‘描述’): or with allure.step(‘描述’):
在报告中增加步骤显示
@pytest.allure.testcase("http://www.qq.com")
def test_steps_demo(self):
with pytest.allure.step('step one'):
driver = webdriver.Chrome()
driver.get('http://www.baidu.com')
with pytest.allure.step('step two'):
driver.find_element_by_id('kw').send_keys('hello')
driver.find_element_by_id('su').click()
time.sleep(5)
with pytest.allure.step('step three'):
driver.save_screenshot("b.png")
f = open('./b.png','rb').read()
allure.attach('this is a img',f,allure.attach_type.PNG)
with pytest.allure.step('step four'):
driver.quit()
• 在报告中增加额外的信息:allure.attach(’arg1’,’arg2’,’arg3’):
arg1:是在报告中显示的名称
arg2:表示添加的内容
arg3:表示添加的类型(支持类型:HTML,JPG,PNG,JSON,OTHER,TEXTXML)
向报告中添加额外信息
allure.attach(‘this is a attach’,’llllllll llllll aaaaa’)
往报告中添加图片
f = open(‘./b.png’,’rb’).read()
allure.attach(‘this is a img’,f,allure.attach_type.PNG)
• 添加环境信息(注:建议放到一个用例中)
添加环境信息
allure.environment(report=’Allure report’,browser=’chrome’,version=’JiuYiBao2.0.6’)
• 利用Feature 和 Story 组织用例,如:一个大模块M 下包含几个小模块A、B、C ;可以将M 设置为Feature,A、B、C 设置为不同的Story
添加Featrue和Story
@allure.feature('Feature1')
@allure.story('Story1')
def test_mminor():
assert Fals
6.整合jenkins
• jenkins 分别安装插件 Allure Jenkins Plugin 、HTML Publisher plugin
• 在系统设置中将JDK / Maven 等其他一些基本配置(建议jdk版本1.8)
• 在jenkins中添加allure执行工具
jenkins添加allure执行工具
1.先下上面提到的allure执行的压缩文件(allure-commandline.zip)
2.在jenkins的系统配置—–Allure Commandline —-去掉自动安装勾选框—-填写name及刚下载的文件夹的根目录路径
3.点击保存
• 新建job,在job中添加步骤 Allure report(Results:第一行表示xml文件的路径;第二行表示生成报告的路径)
目前做法
目前job的整个流程:
1.构建时,从svn上拉取最新的测试代码
2.执行测试脚本并且生成allure需要xml结果文件
3.通过Allure report生成测试报告
4.设置问题追踪
(在Allure Report 下选择增加:Key: allure.issues.tracker.pattern Value: http://tracker.company.com/%s)
• 由于jenkins1.5.2以上版本对插件的安全性做了限制必须要在jenkins —统管理–脚本命令行中执行代码
执行权限代码
System.setProperty(“hudson.model.DirectoryBrowserSupport.CSP”, “default-src ‘self’; script-src ‘self’ ‘unsafe-inline’ ‘unsafe-eval’; style-src ‘self’ ‘unsafe-inline’;”)