引言
RobotFramework自动化框架(以下简称RF)之前文章我们讲了通过import第三方的library(RequestsLibrary等),在实际项目中第三方的包并不能满足我们的需要,此时我们可自己编写python模块(.py文件)或者包,以实现特定的功能。
下面以一个简单的例子讲解如何在RF中引用自己打包的python包。
功能描述:编写一个python程序,实现数字的运算。
1、使用setup函数打包python程序
1.1 创建一个python文件为NumerCalc.py,并定义一个同名的class。(RF导入单个的python文件时需要文件名和class名为同一个)
#导入keyword,定义中文name,方便RF中使用
from robot.api.deco import keywordclass NumberCalc(object):@keyword (name="两个数之和")def number_sum(self,number_a:int,number_b:int):return number_a + number_b
1.2 将NumerCalc.py存放目录NumberCalc中,并创建空文件__init__.py,同时创建version.py用于存放版本号。
- 整体目录结构:
- version.py文件用于配置版本号
1.3 在umberCalc同级目录下创建setup.py文件用于打包python程序。
setup.py文件内容如下
import os
from distutils.core import setup
#获取版本号
version_file = os.path.join(os.path.dirname(__file__), "NumbeCalc", 'version.py')
exec(compile(open(version_file).read(), version_file, 'exec'))setup(name='NumbeCalc',version=VERSION,description='xxxxxxx',author='xxxxxxxx',author_email='xxxxxxx@123.com',install_requires= [],packages=['NumbeCalc'],classifiers=["'Programming Language :: Python :: 3',"],package_data={'': ['*.ini'],'bandwidth_reporter': ['*.ini']},)
#以下是一些参数的介绍
'''
name : 打包后包的文件名
version : 版本号
author : 作者
author_email : 作者的邮箱
py_modules : 要打包的.py文件
packages: 打包的python文件夹
include_package_data : 项目里会有一些非py文件,比如html和js等,这时候就要靠include_package_data 和 package_data 来指定了。package_data:一般写成{‘your_package_name’: [“files”]}, include_package_data还没完,还需要修改MANIFEST.in文件.MANIFEST.in文件的语法为: include xxx/xxx/xxx/.ini/(所有以.ini结尾的文件,也可以直接指定文件名)
license : 支持的开源协议
description : 对项目简短的一个形容
ext_modules : 是一个包含Extension实例的列表,Extension的定义也有一些参数。
ext_package : 定义extension的相对路径
requires : 定义依赖哪些模块
provides : 定义可以为哪些模块提供依赖
data_files :指定其他的一些文件(如配置文件),规定了哪些文件被安装到哪些目录中。如果目录名是相对路径,则是相对于sys.prefix或sys.exec_prefix的路径。如果没有提供模板,会被添加到MANIFEST文件中。
'''
1.4 打开cmd命令,进入以上目录,执行python setup.py sdist,会生成tar.gz结尾的压缩文件。
压缩文件位于如下目录:
1.5 在当前目录解压NumbeCalc-1,0.0.tar.gz,执行以下图中命令python setup.py install安装到默认目录,用于程序引用。
1.6 进入python默认的包安装目录,NumberCalc已经安装到该目录下。
2 RF导入安装的python包
2.1 打开RF的UI界面,在testsuite中导入library。
2.2 导入成功后按F5查看keywords。
2.3 在testcase中引用该keyword,传入参数。
2.4 点击run执行用例。
总结:基于不同的项目要求灵活实现导入功能。
- RF支持在testsuite直接导入library
- RF支持先在resource文件导入library,创建userkeyword,然后在testsuite中导入resource文件
共勉: 东汉·班固《汉书·枚乘传》:“泰山之管穿石,单极之绠断干。水非石之钻,索非木之锯,渐靡使之然也。”
-----指水滴不断地滴,可以滴穿石头;
-----比喻坚持不懈,集细微的力量也能成就难能的功劳