提示:當用戶關鍵字使用命名參數語法時,參數名不能使用${}。例如,用戶關鍵字${arg1}=default, ${arg2}=second必須寫作arg2=override。
命名參數語法僅用參數等號前的部分和一個帶默認值的參數名相匹配時。這種匹配從給定的參數列表末尾開始直到沒有可匹配參數為止。在一些極少數特例中,可以使用“\”規避這種語法,例如nomatch\=here。
提示:命名參數語法對大小寫和空格均敏感。前者意味著如果定義一個參數arg,必須寫作arg=,Arg= 和ARG=都是不可行的。后者意味著在等號前不能有空格,等號后的空格將被視作默認值的一部分處理。
下面的例子展示了命名參數語法在包括引入測試庫等不同場景下的使用方法:
命名參數示例
Setting |
Value |
Value |
Value |
Library |
Telnet |
prompt=$ |
Test Case |
Action |
Argument |
Argument |
Argument |
Example |
Open connection |
10.0.0.42 |
port=${25} |
|
List files |
options=-lh |
|||
List files |
path=/tmp |
options=-l |
Keyword |
Action |
Argument |
Argument |
Argument |
List files |
[Arguments] |
${path}=. |
${options}= |
|
Execute command |
ls ${options} ${path} |
嵌入參數的關鍵字名
另一種完全不同的定義參數的方法是將參數嵌入關鍵字名。這種語法目前為止只支持用戶關鍵字。
2.2.3 用例名稱和文檔
測試用例名直接來自于測試用例表:它就是我們在測試用例列里直接輸入的內容。測試套件里的測試用例應該有唯一的名稱。關于這一點,你也可以用automatic variable的${Test_Name}來指明其測試名稱。不管什么時候執行用例都可以這樣使用,,包括所有的用戶級關鍵字、測試(setup)裝載和測試銷毀(teardown)。
Documentation設置允許你可以為測試用例設置自由文本說明。這些文字說明可以顯示在命令行輸出、測試日志和測試報告中。如果文本說明太長,可以將其拆分到幾個單元格中,,文本中間用空格進行連接??梢允褂煤唵蔚膆tml 格式 和變量,以文檔變得更加生動。從Robot Framework 2.1開始,文檔中一些不存在的變量被不做改變的直接記錄下來。
測試用例文檔例子 |
|||
Test Case |
Action |
Argument |
Argument |
Simple |
[Documentation] |
Simple documentation |
|
|
No Operation |
|
|
Splitting |
[Documentation] |
This documentation is a bit longer and |
it has been split into several columns. |
|
No Operation |
|
|
Formatting |
[Documentation] |
*This is bold*, _this italic_ and |
here is a link: http://robotframework.org |
|
No Operation |
|
|
Variables |
[Documentation] |
Executed at ${HOST} by ${USER} |
|
|
No Operation |
|
|
原文轉自:http://www.anti-gravitydesign.com