機器人框架是一個基於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版本, 但是基本的方法仍然是相同的。
- 開放
系統控制面板> >高級>環境變量
。 在那里 是用戶變量
和系統變量
和之間的區別 它們是用戶變量只影響當前用戶,而系統 變量影響所有用戶。 - 編輯現有的 路徑 值,選擇
編輯
並添加< ScriptsDir >,< InstallationDir >;
最后的價值(如。;C:\ Python27;C:\ Python27 \腳本
)。 注意,分號(;
) 重要,因為他們把不同的條目。 添加一個新 路徑 值,選擇新
並設置名稱和值,這一次沒有 領先的分號。 - 退出對話框,
好吧
保存更改。 - 開始一個新的命令提示符的更改生效。
請注意,如果你安裝了多個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文件。
手動安裝
如果你不想使用任何自動的方式安裝機器人框架, 你可以手動安裝以下步驟:
- 獲得源代碼。 一個目錄中的所有代碼(在Python包) 被稱為 機器人 。 如果你有一個 源分布 或一個版本 控制付款,你可以找到它的 src 目錄,但你 也可以從早前安裝。
- 你要復制源代碼。
- 決定 如何運行測試 。
驗證安裝
安裝成功后,您應該能夠創建執行 跑腳本 與 ——版本 選擇並獲得兩個機器人框架 結果:和翻譯版本
$ 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
執行機器人框架這種方式尤其方便如果你已經這么做了 一個 手動安裝 。
本文是直譯了國外的文檔,有很多的詞匯都不是很清楚