Robot Framework官方教程（一）入門(mén)
Robot Framework官方教程（二）測(cè)試數(shù)據(jù)語(yǔ)法
Robot Framework官方教程（三）創(chuàng)建測(cè)試用例
Robot Framework官方教程（四）創(chuàng)建測(cè)試套件
Robot Framework官方教程（五）使用測(cè)試庫(kù)
Robot Framework官方教程（六）變量
Robot Framework官方教程（七）創(chuàng)建用戶(hù)關(guān)鍵字
Robot Framework官方教程（八） 資源和變量文件
Robot Framework官方教程（九） 執(zhí)行測(cè)試用例
Robot Framework官方教程（十）擴(kuò)展RobotFramework框架

Robot Framework測(cè)試用例是在測(cè)試用例文件中創(chuàng)建的，可以將其組織到目錄中。這些文件和目錄組成了分層測(cè)試套件結(jié)構(gòu)。

2.3.1測(cè)試用例文件

Robot Framework測(cè)試用例是使用測(cè)試用例文件中的測(cè)試用例表創(chuàng)建的。這樣的文件會(huì)自動(dòng)從它包含的所有測(cè)試用例中創(chuàng)建一個(gè)測(cè)試套件?？梢杂卸嗌贉y(cè)試用例沒(méi)有上限，但建議少于10個(gè)，除非使用數(shù)據(jù)驅(qū)動(dòng)方法，其中一個(gè)測(cè)試用例只包含一個(gè)高級(jí)關(guān)鍵字。

設(shè)置表中的以下設(shè)置可用于自定義測(cè)試套件：

• 文檔

  用于指定測(cè)試套件文檔

• 元數(shù)據(jù)

  用于將測(cè)試套件元數(shù)據(jù)設(shè)置為鍵值對(duì)。

• 套件設(shè)置，套件拆解

  指定套件設(shè)置和拆卸。還有同義詞 Suite Precondition和Suite Postcondition。

注意

所有設(shè)置名稱(chēng)都可以選擇在末尾包含冒號(hào)，例如Documentation: 。這可以使設(shè)置更容易閱讀，尤其是在使用純文本格式時(shí)。這是Robot Framework 2.5.5中的一項(xiàng)新功能。

2.3.2測(cè)試套件目錄

測(cè)試用例文件可以組織到目錄中，這些目錄可以創(chuàng)建更高級(jí)別的測(cè)試套件。從目錄創(chuàng)建的測(cè)試套件不能直接包含任何測(cè)試用例，但它包含其他帶有測(cè)試用例的測(cè)試套件。然后可以將這些目錄放入其他目錄中，從而創(chuàng)建更高級(jí)別的套件。結(jié)構(gòu)沒(méi)有限制，因此可以根據(jù)需要組織測(cè)試用例。

執(zhí)行測(cè)試目錄時(shí)，它包含的文件和目錄將按遞歸方式處理，如下所示：

• 名稱(chēng)以點(diǎn)（.）或下劃線（_）開(kāi)頭的文件和目錄將被忽略。
• 名稱(chēng)為CVS的目錄將被忽略（區(qū)分大小寫(xiě)）。
• 不在以下已識(shí)別的擴(kuò)展名（.html， .xhtml，.htm，.tsv，.txt，.rst或.rest）的文件將被忽略（不區(qū)分大小寫(xiě)）。
• 其他文件和目錄都將被處理。

如果處理的文件或目錄不包含任何測(cè)試用例，則會(huì)以靜默方式忽略它（將消息寫(xiě)入syslog）并繼續(xù)處理。

警告無(wú)效文件

通常，使用寫(xiě)入syslog的消息將忽略沒(méi)有有效測(cè)試用例表的文件。從Robot Framework 2.5.5開(kāi)始，可以使用命令行選項(xiàng)--warnonskippedfiles，它將消息轉(zhuǎn)換為測(cè)試執(zhí)行錯(cuò)誤中顯示的警告。

初始化文件

從目錄創(chuàng)建的測(cè)試套件可以具有與從測(cè)試用例文件創(chuàng)建的套件類(lèi)似的設(shè)置。因?yàn)槟夸洷旧聿荒馨欠N信息，所以必須將其放入特殊的測(cè)試套件初始化文件中。初始化文件與測(cè)試用例文件具有相同的結(jié)構(gòu)和語(yǔ)法，但它們不能包含測(cè)試用例表，并且不是所有設(shè)置項(xiàng)都支持。

初始化文件名必須始終為__init__.ext格式，其中擴(kuò)展名必須與支持的文件格式之一匹配（例如，__init__.html 或 __init__.txt。該名稱(chēng)格式來(lái)自Python，以這種方式命名文件表示該目錄是一個(gè)模塊。

初始化文件的主要用途是與測(cè)試用例文件類(lèi)似，可以指定與測(cè)試套件相關(guān)的設(shè)置，但也可以設(shè)置一些與測(cè)試用例相關(guān)的設(shè)置。初始化文件中創(chuàng)建或?qū)氲淖兞亢完P(guān)鍵字在子測(cè)試套件中不可用**，但是可以使用資源文件共享資源。

如何在初始化文件中使用設(shè)置：

• Documentation, Metadata, Suite Setup, Suite Teardown

  這些特定于測(cè)試套件的設(shè)置與測(cè)試用例文件中的工作方式相同。

• Force Tags

  指定的標(biāo)記無(wú)條件地設(shè)置為此目錄直接或遞歸包含的所有測(cè)試用例文件中的所有測(cè)試用例。

• Test Setup, Test Teardown, Test Timeout

  將test setup/teardown或test timeout的默認(rèn)值設(shè)置為此目錄包含的所有測(cè)試用例?？梢栽谳^低級(jí)別覆蓋。Robot Framework 2.7中添加了對(duì)初始化文件中定義測(cè)試超時(shí)的支持。

• Default Tags, Test Template

  初始化文件不支持。

  Setting	Value	Value
  Documentation	Example suite
  Suite Setup	Do Something	${MESSAGE}
  Force Tags	example
  Library	SomeLibrary

  Variable	Value	Value
  ${MESSAGE}	Hello, world!

  Keyword	Action	Argument	Argument
  Do Something	[Arguments]	${arg}
  	Some Keyword	${arg}
  	Another Keyword

2.3.3測(cè)試套件名稱(chēng)和文檔

測(cè)試套件名稱(chēng)由文件或目錄名構(gòu)成。創(chuàng)建套件名稱(chēng)好處是可以忽略文件的擴(kuò)展名，下劃線使用空格替換，完全小寫(xiě)的名稱(chēng)將轉(zhuǎn)為標(biāo)題格式。例如，some_tests.html變?yōu)?code>Some Tests， My_test_directory變?yōu)?code>My test directory。

注意

在Robot Framework 2.5中，創(chuàng)建測(cè)試套件名稱(chēng)的規(guī)則略有不同。

文件或目錄名稱(chēng)可以包含用于控制套件執(zhí)行順序的前綴。前綴通過(guò)兩個(gè)下劃線與基本名稱(chēng)分隔，并且在構(gòu)造實(shí)際測(cè)試套件名稱(chēng)時(shí)，前綴和下劃線都將被刪除。例如，文件 01__some_tests.txt和02__more_tests.txt分別創(chuàng)建測(cè)試套件Some Tests和More Tests，前者在后者之前執(zhí)行。

使用 “設(shè)置”表中的“Documentation”設(shè)置測(cè)試套件的文檔。它可以在測(cè)試用例文件中使用，也可以在更高級(jí)別的套件中用于測(cè)試套件初始化文件。測(cè)試套件文檔用法和之前創(chuàng)建測(cè)試用例章節(jié)中的用法一樣。

在測(cè)試執(zhí)行中，可以覆蓋頂級(jí)測(cè)試套件的名稱(chēng)和文檔。這可以分別使用命令行選項(xiàng)--name和--doc來(lái)完成，如設(shè)置元數(shù)據(jù)一節(jié)中所述。

2.3.4測(cè)試套件元數(shù)據(jù)

測(cè)試套件還可以包含除文檔之外的其他元數(shù)據(jù)。此元數(shù)據(jù)使用“Metadata”設(shè)置。以這種方式設(shè)置的元數(shù)據(jù)顯示在測(cè)試報(bào)告和日志中。

對(duì)元數(shù)據(jù)的名稱(chēng)和值參見(jiàn)下表。該值的處理方式與文檔類(lèi)似，這意味著它可以拆分為多個(gè)單元格（用空格連接在一起）或分成幾行（用換行連接在一起），簡(jiǎn)單的HTML格式化，甚至可以使用變量。

對(duì)于頂級(jí)測(cè)試套件，也可以使用--metadata命令行選項(xiàng)設(shè)置元數(shù)據(jù) 。這在“ 設(shè)置元數(shù)據(jù)”一節(jié)中有更詳細(xì)的討論。

2.3.5套件設(shè)置和拆卸

測(cè)試用例和測(cè)試套件都可以進(jìn)行設(shè)置和拆卸。在運(yùn)行任何套件或子測(cè)試套件的測(cè)試用例之前執(zhí)行套件設(shè)置，并在它們之后執(zhí)行測(cè)試拆卸。所有測(cè)試套件都可以進(jìn)行設(shè)置和拆卸; 對(duì)于從目錄創(chuàng)建的套件，必須在測(cè)試套件初始化文件中指定它們。

與測(cè)試用例類(lèi)似，套件設(shè)置和拆解是一個(gè)可以帶參數(shù)的關(guān)鍵字。它們分別在設(shè)置表中使用Suite Setup和Suite Teardown設(shè)置進(jìn)行定義 。它們也有類(lèi)似的同義詞，Suite Precondition和Suite Postcondition，作為測(cè)試用例設(shè)置和拆解。關(guān)鍵字名稱(chēng)和可能的參數(shù)位于設(shè)置名稱(chēng)后面的列中。

如果套件設(shè)置失敗，則會(huì)立即為其中的所有測(cè)試用例及其子測(cè)試套件分配一個(gè)失敗狀態(tài)，并且它們實(shí)際上并未執(zhí)行。這使得套件設(shè)置非常適合檢查在運(yùn)行測(cè)試用例之前必須滿(mǎn)足的前提條件。

在執(zhí)行完所有測(cè)試用例后，套件拆卸通常用于清理。即使同一套件的設(shè)置失敗，也會(huì)執(zhí)行它。如果套件拆卸失敗，則套件中的所有測(cè)試用例都標(biāo)記為失敗，無(wú)論其原始執(zhí)行狀態(tài)如何。從Robot Framework 2.5開(kāi)始，即使其中一個(gè)關(guān)鍵字失敗，也會(huì)執(zhí)行套件拆解中的所有關(guān)鍵字。

作為設(shè)置或拆卸執(zhí)行的關(guān)鍵字的名稱(chēng)可以是變量。通過(guò)從命令行提供關(guān)鍵字名稱(chēng)作為變量，這有助于在不同環(huán)境中進(jìn)行不同的設(shè)置或拆卸。