robotframework笔记1--安装与卸载

机器人框架 实现与 Python 和支持也 Jython (JVM)和 IronPython (. net)。 在安装框架之前, 一个明显的 先决条件 就是安装至少一个。

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

安装与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程序 他们不需要 在这种情况下即使目录路径将包含空格。

设置 路径 在类unix系统中

在类unix系统中你通常需要编辑一些系统或用户 特定的配置文件。 文件编辑和如何取决于系统, 你需要咨询你的操作系统文档以了解更多的细节。

设置 https_proxy

如果你是 安装与pip后面一个代理,你需要设置 的 https_proxy 环境变量。 需要在安装 皮普本身,当用它来安装机器人框架和其他Python 包。

如何设置 https_proxy 取决于操作系统类似 配置路径 。 这个变量的值必须是一个URL的代理, 例如, http://10.0.0.42:8080 。

与pip安装

标准的Python包管理器pip ,但还有其他 选择等 构建。 和 easy_install 。 这些指令 使用脉冲只覆盖,但其他包管理器应该能够安装 机器人框架。

最新的Python,Jython和IronPython版本包含pip捆绑。 哪一个 版本控制和如何可能激活部分中讨论 在下面。 看到pip如果最新的安装说明如果你项目页面 需要安装它。

请注意

只有机器人Framework 2.7和更新可以使用pip安装。 如果你 需要一个旧版本,你必须使用其他安装方法。

Python安装pip

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

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

如果你有多个安装了皮普的Python版本,版本 时使用的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安装脉冲

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

ipy -X:Frames -m ensurepip

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

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,脚本通常在脚本或安装目录下的目录。

1.3.8卸载

最简单的方法卸载正在使用机器人框架 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

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

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