robotframework笔记1

机器人框架是一个基于Python的，可扩展的关键字驱动的自动化测试最终到终端的验收测试和验收测试驱动开发（ATDD）框架。它可用于检测分布式异类应用程序，其中，验证要求感人几种技术和接口。

下面列出了不同的方法来安装机器人框架本身和解释 更彻底地在随后的部分。

安装与pip

使用pip推荐的方法是安装机器人框架。 随着 标准的Python包管理器包含在最新的Python, Jython和IronPython版本。 如果你已经pip,你 可以执行:

pip install robotframework

从源代码安装

这种方法不管操作系统和Python 解释器使用。 你可以通过下载的源代码 源分布 PyPI 和提取,或者克隆 GitHub库 。

独立的JAR分布

如果运行测试与Jython就够了,最简单的方法是下载 独立的 robotframework——<版本> . jar 从 Maven。JAR包含Jython和分布,因此机器人框架 只需要有 Java 安装。

手动安装

如果你有特殊需要的,没有其他的工作,你总是可以做的 一个定制的手动安装。

请注意

机器人框架3.0之前,也有单独的窗口 Python安装32位和64位版本。 因为Python 2.7.9和 更新包含 皮普 在Windows和Python 3需要两个 更多的安装程序,这是决定 Windows安装程序不 创建了 。 推荐的安装方法也 窗户是 使用pip 。

先决条件

机器人框架支持 Python (包括Python 2和Python 3), Jython (JVM)和 IronPython (. net)和运行也 PyPy 。 翻译你想使用应该安装在安装之前 框架本身。

使用哪个翻译取决于所需的测试库和测试 环境一般。 一些图书馆使用工具或模块,只有工作 与Python,而其他可能需要Jython或需要使用Java工具 。因此IronPython。 也有许多工具和库运行。

如果没有特殊需要或只是想试试这个框架, 推荐使用Python。 这是最成熟的实现, 速度大大快于Jython或IronPython(尤其是启动时间 更快),也可用在大部分类unix操作系统。 另一个不错的选择是使用 独立的JAR分布 那 只有Java作为前提。

Python 2 vs Python 3

Python 2和Python 3大多是同一种语言,但他们并不完全 与彼此兼容。 主要的区别在于,在Python 3 Unicode字符串是在Python 2默认字符串字节,但 也有其他一些向后不兼容的更改。 最后一个Python 2 Python 2.7版本是在2010年发行,并将之前的支持 2020年。 看到 我应该使用Python 2或3吗? 更多的信息 差异,使用哪个版本,如何编写代码来处理 版本,等等。

机器人Framework 3.0是第一个机器人框架版本支持Python 3。 它还支持Python 2,计划继续支持Python 2 只要Python 2本身是官方支持。 我们希望的作者 库和工具在更广泛的生态系统也开始寻找机器人框架 Python 3支持现在核心框架支持它。

Python安装

在大部分类unix系统,如Linux和OS X Python 安装 默认情况下。 如果你在Windows或其他需要安装Python自己, 一个良好的开端 http://python.org 。 你可以下载一个合适的 安装程序和获得更多的信息关于安装过程和Python 一般来说。

机器人框架3.0支持Python 2.6,3.0,2.6新,但该计划 来 Python 2.6支持在射频3.1下降 。 如果你需要使用旧版本, 机器人框架2.5 - -2.8支持Python 2.5和2.0 - -2.1机器人框架 Python 2.3和2.4的支持。

在Windows上建议安装所有用户和运行Python 安装程序作为管理员。 此外,环境变量 PYTHONCASEOK 不能设置。

在安装Python,你可能仍然需要配置 路径 为了使 Python本身以及 机器人 和 rebot 跑脚本 在命令行中执行。

提示

最新的Python的Windows安装程序允许设置 路径 作为的一部分 安装。 默认情况下是禁用的,但是 添加python.exe 到路径 可以启用 自定义Python 屏幕上。

Jython安装

使用测试库实现 Java 或在内部使用Java工具 需要运行机器人框架 Jython ,进而需要Java 运行时环境(JRE)或Java开发工具包(JDK)。 要么安装 这些Java分布的这些指令的范围,但是 例如,你可以找到更多的信息 http://java.com 。

安装Jython是一个相当简单的过程,第一步是 一个安装程序从 http://jython.org 。 安装程序是一个可执行JAR 包,您可以从命令行运行 java jar jython_installer——<版本> . jar 。 根据系统配置, 也可以双击安装程序。

机器人框架3.0支持Jython 2.7需要Java 7或更新。 如果需要旧的Jython或Java版本,机器人框架2.5 - -2.8支持 Jython 2.5(需要Java 5或更新)和机器人框架2.0 - -2.1的支持 Jython 2.2。

安装Jython之后,你可能仍然需要配置 路径 为了使 Jython本身以及 机器人 和 rebot 跑脚本 在命令行中执行。

IronPython安装

IronPython 允许运行机器人框架 。 网络平台 以及其他。net和c#和互动 语言和api。 只有IronPython 2.7支持。

当使用IronPython时,额外的依赖正在安装 elementtree 模块1.2.7预览版编写。 这是必需的,因为 elementtree 分布式与IronPython模块 破碎的 。 你可以安装 包下载源分布,测定它并运行 国际极地年设置。 py安装 在命令提示符创建目录。

安装IronPython之后,你可能仍然需要配置 路径 为了使 IronPython本身以及 机器人 和 rebot 跑脚本 在命令行中执行。

配置 路径

的 路径 环境变量列表位置命令执行 搜索系统。 使用机器人框架更容易的 命令提示符下,建议添加的位置 跑步者 脚本 安装到 路径 。 通常它也有用 翻译本身的 路径 很容易执行。

当在类unix机器上使用Python Python本身和脚本 安装应该是自动的 路径 没有额外的行动 需要的。 在Windows和其他翻译 路径 必须配置 分开。

提示

最新的Python的Windows安装程序允许设置 路径 作为的一部分 安装。 默认情况下是禁用的,但是 添加python.exe 到路径 可以启用 自定义Python 屏幕上。 它将 添加Python安装目录和 脚本 目录的 路径 。

目录添加到什么 路径

目录需要添加什么 路径 取决于译员和 操作系统。 第一个位置的安装目录(例如 C: Python27 ),另一个是位置 安装脚本解释器。 Python和IronPython 安装脚本 脚本 在安装目录下的目录 在Windows上(如 C: Python27 脚本 Jython)和使用 本 目录不管操作系统(如。 C: jython2.7.0 bin )。

请注意, 脚本 和 本 目录可能不会创建 作为翻译的一部分,安装,但后来当机器人框架 或其他第三方模块安装。

设置 路径 在Windows上

在Windows上您可以配置 路径 遵循下面的步骤。 请注意 精确设置名称可能是不同的在不同的Windows版本, 但是基本的方法仍然是相同的。

1. 开放 系统控制面板> >高级>环境变量 。 在那里 是 用户变量 和 系统变量 和之间的区别 它们是用户变量只影响当前用户,而系统 变量影响所有用户。
2. 编辑现有的 路径 值,选择 编辑 并添加 < ScriptsDir >,< InstallationDir >; 最后的价值(如。 ;C: Python27;C: Python27 脚本 )。 注意,分号( ; ) 重要,因为他们把不同的条目。 添加一个新 路径 值,选择 新 并设置名称和值,这一次没有 领先的分号。
3. 退出对话框, 好吧 保存更改。
4. 开始一个新的命令提示符的更改生效。

请注意,如果你安装了多个Python版本,执行 机器人 或 rebot 跑脚本 总是使用一个吗 第一个 在 路径 无论在什么脚本的Python版本 安装。 要避免这一点,你可以执行 机器人安装模块 直接 就像 C: Python27 python。 exe - m机器人 。

还需要注意的是,你不应该添加引号目录添加到 的 路径 (如。 “C: Python27 脚本” )。 报价 可能导致的问题 Python程序 他们不需要 在这种情况下即使目录路径将包含空格。

与pip安装

最新的Python，Jython和IronPython的版本包含在画中画捆绑在一起。

Python安装pip

从Python 2.7.9,标准的Windows安装程序默认安装 和激活pip。 假设你也有配置 路径 并有可能 集 https_proxy ,您可以运行 pip安装robotframework 之后 Python安装。

外窗和旧的Python版本你需要安装pip。 你可以做到使用系统包经理喜欢Apt或百胜在Linux上, 但是你总是可以使用手动安装说明发现的pip项目页面。

如果你有多个安装了pip的Python版本,版本 时使用的pip命令执行取决于pip是第一的 路径。 另一种方法是执行pip使用选中的Python模块 版本直接:

python -m pip install robotframework
python3 -m pip install robotframework

Jython安装pip

Jython 2.7包含pip捆绑,但它需要被激活之前使用它 通过运行下面的命令:

jython -m ensurepip

Jython安装皮普进入 < JythonInstallation > / bin 目录中。 并运行 pip安装robotframework实际或可能使用它 其他pip版本取决于pip是第一的 路径。 另一种选择 正在执行的 皮普 直接使用Jython模块:

jython -m pip install robotframework

为IronPython安装pip

IronPython包含捆绑pip从 2.7.5版本 。 同样作为 用Jython,它需要首先激活:

ipy -X:Frames -m ensurepip

请注意,与IronPython - x:框架 命令行选项是必需的 当激活时,使用pip。

IronPython pip安装到 < IronPythonInstallation > /脚本 目录中。 并运行 pip安装robotframework 实际或可能使用它 其他pip版本取决于pip是第一的 路径 。 另一种选择 正在执行的 皮普 模块直接使用IronPython:

ipy -X:Frames -m pip install robotframework

2.7.5之前IronPython版本并不正式支持皮普。

使用pip

一旦你有了pip安装,设置 https_proxy 是你背后 代理,在命令行上使用它是很容易的。 最简单的方法使用 pip是让它找到并下载包安装的 Python包指数(PyPI) ,但它也可以安装包 分别从PyPI下载。 最常见的用法如下所示 和pip文档的更多信息和示例。

# Install the latest version
pip install robotframework

# Upgrade to the latest version
pip install --upgrade robotframework

# Install a specific version
pip install robotframework==2.9.2

# Install separately downloaded package (no network connection needed)
pip install robotframework-3.0.tar.gz

# Uninstall
pip uninstall robotframework

注意,pip 1.4和更新只会默认安装稳定版本。 如果你想安装一个α,β或候选版本,你需要 显式地指定版本或使用 ——前 选择:

# Install 3.0 beta 1
pip install robotframework==3.0b1

# Upgrade to the latest version even if it is a pre-release
pip install --pre --upgrade robotframework

从源代码安装

这种安装方法可以与任何在任何操作系统上使用的。 安装 从源 也许听起来有点吓人,但是 过程实际上是很简单的。

获得源代码

您通常被下载源代码 源发布包 在 gz 格式。 更新包是可用的 PyPI ,但是机器人框架 2.8.1发布及以上可以从旧的找到 谷歌代码下载页面 。 一旦你下载你需要的包,提取它的某个地方, 作为一个结果,你得到一个目录命名 robotframework——<版本> 。 的 目录包含源代码和安装所需的脚本。

另一种方法获得源代码是克隆项目 GitHub库 直接。 默认情况下你会得到最新的代码,但是 你可以很容易地切换到不同的发布版本或其他标记。

安装

机器人从源代码安装使用Python的标准框架 setup . py 脚本。 包含源目录中的脚本,您可以运行 从命令行中使用任何支持的翻译:

python setup.py install
jython setup.py install
ipy setup.py install

的 setup . py 允许脚本接受几个参数,例如, 安装到一个非缺省位置,不需要管理 的权利。 它也用于创建不同的分配方案。 运行 python的设置。 py——帮助 为更多的细节。

独立JAR分布

机器人框架也分布作为一个独立的Java的档案文件,包含 这两个 Jython 和机器人框架,只需要 Java 一个依赖项。 它是 一个简单的方法让一切都放在一个包,不需要安装, 但是有一个缺点,它不正常工作 Python 。

包的命名 robotframework——<版本> . jar 它是可用的 在 Maven 。 在下载了这个包后,您可以执行测试 就像:

java -jar robotframework-3.0.jar mytests.robot
java -jar robotframework-3.0.jar --variable name:value mytests.robot

如果你想 后处理输出 使用或使用其他内置室内可容纳 支持工具 ,你需要给命令名称 rebot , libdoc , testdoc 或 整洁第一个参数的JAR文件:

java -jar robotframework-3.0.jar rebot output.xml
java -jar robotframework-3.0.jar libdoc MyLibrary list

对不同命令的更多信息,执行JAR 参数。

除了Python标准库和机器人框架模块 独立的JAR版本从2.9.2也包含PyYAML依赖 需要处理变量yaml文件。

手动安装

如果你不想使用任何自动的方式安装机器人框架, 你可以手动安装以下步骤:

1. 获得源代码。 一个目录中的所有代码(在Python包) 被称为 机器人 。 如果你有一个 源分布 或一个版本 控制付款,你可以找到它的 src 目录,但你 也可以从早前安装。
2. 你要复制源代码。
3. 决定 如何运行测试 。

验证安装

安装成功后,您应该能够创建执行 跑脚本 与 ——版本 选择并获得两个机器人框架 结果:和翻译版本

$ robot --version
Robot Framework 3.0 (Python 2.7.10 on linux2)

$ rebot --version
Rebot 3.0 (Python 2.7.10 on linux2)

如果跑脚本运行失败消息说命令 没有发现或承认,第一步是双击 路径 配置。 如果不帮助,这是一个好主意重读相关 部分从这些指令之前从互联网或搜索帮助 在请求帮助robotframework-users 邮件列表或 其他地方。

安装文件在哪里

当使用自动安装程序时,机器人框架源代码复制 到一个目录,其中包含外部Python模块。 在类unix操作 系统中,Python是预装该目录的位置不同。 如果你已经安装了翻译自己,这是正常 Lib /网站 翻译安装目录下 的例子, C: Python27 Lib 网站 。 实际的机器人 框架代码目录命名 机器人 。

机器人框架 跑脚本 创建和复制到另一个 特定于平台的位置。 当使用Python在类unix系统中,他们 通常去 工作 或 /usr/local/bin 。 在Windows和 Jython和IronPython,脚本通常在脚本或安装目录下的目录。

卸载

最简单的方法卸载正在使用机器人框架 pip:

pip uninstall robotframework

在皮普是一个不错的功能,可以卸载包即使它们 从源安装。 如果你没有pip可用或所做的 一个 手动安装 一个自定义的位置,你需要找到 在文件 安装 和手动删除它们。

如果你有设置 路径 或配置环境,否则,你需要单独撤销这些变化。

就开始升级

如果您使用的是pip,升级到新版本需要使用 的 ——升级 选择或显式地指定要使用的版本:

pip install --upgrade robotframework
pip install robotframework==2.9.2

使用脉冲时,它会自动卸载以前的版本 安装。 如果你是 从源代码安装 ,应该是安全的 只需安装在现有的安装。 如果你遇到问题, 卸载 安装前可能会有所帮助。

当升级机器人框架,总有新版本的改变 影响现有的测试或测试包含向后不兼容的更改 基础设施。 这种变化是非常罕见的在像2.8.7或次要版本 2.9.2,但更常见于等主要版本2.9和3.0。 向后 不兼容的更改和弃用功能是解释说 指出,这是一个好主意来研究尤其在升级的时候出现 一个新的主要版本。

执行机器人框架

使用 机器人和 rebot脚本

从机器人Framework 3.0开始,测试执行使用 机器人 脚本和结果进行后期处理 rebot 脚本:

robot tests.robot
rebot output.xml

这两个脚本的一部分正常的安装和安装 可以直接从命令行执行如果 路径 正确地设置。 他们是使用Python实现除了Windows批处理文件的地方。

老版本没有机器人框架 机器人 脚本和 rebot 只与Python脚本安装。 相反,他们翻译 特定的脚本 pybot , jybot 和 ipybot 测试执行和 jyrebot 和 ipyrebot 对后处理输出。 这些脚本还 工作,但他们在未来将被弃用和删除。

执行安装 机器人模块

另一种方式来运行测试是执行安装 机器人 模块 或它的子模块 robot.run 直接使用Python的 - m命令行 选项 。 这是特别有用如果机器人使用多个框架 Python版本:

python -m robot tests.robot
python3 -m robot.run tests.robot
jython -m robot tests.robot
/opt/jython/jython -m robot tests.robot

支持 python - m 机器人 方法是机器人中的一个新特性 3.0框架,但是旧版本支持 python - m robot.run 。 后者也必须使用Python 2.6。

后处理输出使用相同的方法可行,但模块 运行是 robot.rebot :

python -m robot.rebot output.xml

执行安装 机器人目录

如果你知道机器人安装框架,您还可以执行 安装 机器人 目录或 run.py 文件里面直接:

python path/to/robot/ tests.robot
jython path/to/robot/run.py tests.robot

运行该目录是机器人Framework 3.0中的一个新特性,但年长的 版本支持运行 机器人/ run.py 文件。

后处理输出使用 机器人/ rebot.py 文件相同的工作 方法:

python path/to/robot/rebot.py output.xml

执行机器人框架这种方式尤其方便如果你已经这么做了 一个 手动安装 。

本文是直译了国外的文档，有很多的词汇都不是很清楚