Robot Framework自動化測試 pybot 參數詳解

一、使用pybot執行測試用例常用方式
1、執行整個項目下的所有用例： pybot 項目路徑。例如： pybot D:\robot
2、執行某個suit中的所有用例： pybot 項目路徑\suit文件名稱。 例如：pybot D:\robot\test.txt
3、執行具體的某個用例的用例：pybot --test 用例名稱 項目路徑\suit文件名稱。例如：pybot --test case_1_user log in D:\robot\test.txt
4、執行項目中指定標簽的案例： pybot --include tagName C:\TF-Test
?
二、pybot 參數詳解?

1. -M –metadata name:value 給最頂層測試套件設置metadata (主要體現在測試報告中)?
   • a) example: –metadata version:1.2?
2. -G –gettag tag * 給所有執行的測試 case設置給出的tag?
3. -t –test name * 根據測試case的名字或全面去選擇運行。?
   • a) 名字是大小寫和空格不敏感的，同時也可以用* 匹配所有case, ?可以匹配任意字符?
   • b) 如果用 * 和 ？運行， 在控制臺是有問題的，請查看 –escape 和 –argumentfile 參數?
4. -s –suite name * 根據選擇的case 名字運行測試套件，只有測試case 在對應的測試套件中并且符合篩選標準的，才能和–test, –include 或 – exclude 同時使用時，name 參數和 –test 的name 參數標準類似。也可以使用”.” 這個符號作為父節點名的分隔符：?
   • a) 例如：-s X.Y 選擇父節點是 X 的 Y 測試套件。?
5. -i –include tag 根據給出的tag 名去選擇運行測試案例。 name 參數和–test 的參數類似。 tag 是大小寫和空格不敏感的，它可以使用 “” 和 “?” 作為通配符。 Tags 和 模式可以用 AND、OR 和 NOT 關鍵字連接：?
   • a) 例如：–include foo –include bar*?
   • b) –include fooANDbar*?
6. -e –exclude tag * 不運行帶這些給出標簽的案例。其余規則和 –include 相同?
7. -R –rerunfailed output 從之前失敗的輸出文件中選擇失敗的案例重新執行。?
   • a) 選擇相同的案例需要用分別單獨使用–test 參數?
8. –runfailed output (RF 2.8.4 版本以后已經被–rerunfailed 替代)?
9. -c –critical tag * 案例給予Tag被認為是重要的。 如果沒有設置重要標簽，那么所有的案例都被認為是重要的。 Tag 可以賦予一個模式例如 –include?
10. -n –noncritical tag 被賦予Tag 的案例，被認為是不重要的，即使他被設置了critical 標簽。 Tag 可以用模式來表達例如： –include test?
11. -v –variable name:value * 在測試數據中設置變量。 只支持 scalar 變量，變量名不需要帶’′.請參考–escape參數去使用特殊字符和–variablefile參數去設置更多功能的變量，同樣可以使用list變量。?a)例如：–variablestr:Hello=>′.請參考–escape參數去使用特殊字符和–variablefile參數去設置更多功能的變量，同樣可以使用list變量。?a)例如：–variablestr:Hello=>{str}=’Hello’?
    • b) -v str:HelloWorld -E space: =>str=′HelloWorld′?c)?vx:?vy:42=>str=′HelloWorld′?c)?vx:?vy:42=>{x}='',${y}=’42’?
12. -V –variablefile path * 變量文件的路徑：?
    • a) 樣例文件：?
      i.?
    • b) 等同于：?
      i.?
13. -d –outputdir dir 存放輸出文件的路徑。默認目錄是測試案例執行的目錄，給出的目錄也是相對于案例執行的目錄，除非設置的目錄是絕對路徑。?
14. -o –output file XML 輸出文件，給出路徑，和 –log , –report , –xunit , and –debugfile, 相似，基于 –outputdir 的目錄，除非給出的是絕對路徑。 其他輸出文件都是基于案例執行后的xml 輸出文件生成的。 XML 輸出文件也可以為以后的robot 工具提供數據?？梢越o出 NONE 字符串禁止這個功能，同時還會禁止 log (日志) 和 report (報告) 功能。?
15. -l –log file HTML 日志文件。 可以給出 NONE 禁止輸出，默認輸出 log.html?
    • a) 例如：–log mylog.html?
    • b) -l NONE?
16. -r –report file HTML 報告文件?？梢再x予 NONE 禁止輸出，默認輸出：report.html。 類似于 –log 參數。?
17. -x –xunit file xUnite 兼容性 測試文件。 除非特別聲明，否則不會被創建。?
    • a) –unitfile file (已經廢棄 用 –xunit 代替)?
    • b) –xunitskipnoncritical 標記非重要案例在 xUnit 輸出結果中跳過。?
18. -b –debugfile file 運行期間的調試文件，除非特別聲明，否則不被創建。?
19. -T –timestampoutputs 當使用這個參數時，時間戳格式 ‘YYYYMMDD-hhmmss’ 將被應用于所有輸出文件名的基本名和擴展名之間。?
    • a) 例如： -T -o ouputxml -r report.html -l none?
    • b) 創建文件：ouput-20161023-121011.xml 和 report-20161023-121012.xml?
    • c) –splitlog 分割日志文件成小文件，用瀏覽器打開更清晰?
    • d) –logtitle title 生成日志的標題。默認標題是測試套件的名字。 所有測試標題中的下劃線都被轉換成空格。?
    • e) –reportbackgroud colors 測試報告的背景設置。?
    • • i. ‘all_passed:critical_passed:failed’ 或者 ‘passed:failed’ 顏色和代碼都可以。?
    • • • 1. 例如：–reportbackgroud green:yellow:red?
    • • • 2. –reportbackgroud #00E:#E00?
20. -L –loglevel level 設置日志級別?？捎眉墑e：TRACE,DEBUG,INFO (默認級別). WARN,NONE(no loging)。使用語法：LOGLEVEL:DEFAULT?
    • a) 例子：–loglevel DEBUG?
    • b) –loglevel DEBUG:INFO?
21. –suitestatleve level 在日志和測試報告中顯示多少層。 默認顯示所有層.?
    • a) 例子：–suitestatlevel 3?
22. –tagstatinclude tag * 只在測試套件統計和測試細節在日志和報告中顯示匹配的TAG。Tag默認在所有測試案例中顯示。給出的Tag 可以寫成一個簡單的模式（參考 –test 例子）?
23. –tagstatexclude tag * 只在 按測試套件統計和測試細節的log 和測試報告中不顯示匹配的TAG. 這個選項不能和 –tagstatinclude 一起使用，類似 –exclude 和 –include 同時使用。?
24. –tagstatcombine tags:name * 根據tag 創建綜合統計，這些統計會被添加到按TAG 統和匹配的測試案例細節中。 如果可選項 name 沒有給出，綜合統計的名字會從指定的tags 里面獲取。 Tags 將結合–include 給出的規則一起使用。?
    • a) 例子： –tagstatcombine requrement-*?
    • b) —tagstatcombine tag1ANDtag2:My_name?
25. –tagdoc pattern:doc 為符合條件的tag 添加文檔說明。文檔會顯示在測試細節中，同樣也會以 工具提示的形式顯示在’Statistics by Tag’ 中。 模式可以包含 匹配所有，和’?’ 匹配任意單個字符。 文檔可以包含格式，類似于 –doc 選項。?
    • a) 例子： –tagdoc mytag:My_documentation?
    • b) –tagdoc regression:See_http://info.html?
    • c) –tagdoc owner-*:Original_author?
26. –tagstatlink pattern:link:title 在按tag統計中添加額外的連接地址。pattern 可以包含 匹配所有 和 ? 匹配任意字符。字符串通配符表達式可以用 %N 這種語法應用在連接 和 標題中。N 是從第幾位開始匹配。 在標題中下劃線會被自動轉換成空格。?
    • a) 例子：–tagstatlink mytag:http://my.domain:Link?
    • b) –tagstatlink bug-*:http:/tracker/id=%1:Bug_Tracker?
27. –removekeywords all|passed|for|wuks|name: * 從生成的日志文件中移除關鍵字數據。 關鍵中如果包含警告則不會被移除，除非選項參數是all .?
    • a) all: 從所有關鍵字中移除數據?
    • b) passed: 從成功的測試案例和套件中移除關鍵字數據。?
    • c) for: 從for循環成功的迭代中移除關鍵字數據。?
    • d) wuks: 移除所有處理最后失敗的關鍵字， 包含在’BuiltIn.Wait Until Keyword Succeds’?
    • e) name:: 從符合匹配模式的關鍵字中移除數據。模式會針對關鍵字全面做匹配。?
    • i. 例如：’MyLib.Keyword’,’resource.Secdon Keyword’?
    • f) 大小寫，空格，下劃線不敏感， 可以包含 * 和 ? 作為通配符。?
    • i. 例子：–removekeywords name:Lib.HugeKw?
    • ii. –removekeywords name:myresource.*?
28. –flattenkeywords for|foritem|name: * Flattens matching keywords in the generated log file. Matching keywords get all log messages from their child keywords and children are discarded otherwise.?
    • a) for: flatten for loops fully?
    • b) foritem: flatten individual for loop iterations?
    • c) name:: flatten matched keywords using same matching rules as with?
    • • i. ‘–removekeywords name:’?
29. –listener class * 一個用于監視測試執行的類。 獲取通知的示例當一個測試案例開始和結束時。監聽類的參數可以跟在類名后面，用 ‘:’ 作為分隔符。?
    • a) 例如：–listener MyListenerClass:arg1:arg2?
30. –warnonskippedfiles 如果使用了該選項，跳過的測試數據文件會在控制臺和日志文件中產生一個可見 的警告信息。默認的跳過的文件只會產生一個信息基本的系統日志信息。?
31. –nostatusrc 設置返回碼為0 不管測試案例中的失敗。錯誤碼正常返回。?
32. –runemptysuite 如果頂層測試套件為空也同樣執行。如果和–include/–exclude 一起使用時，如果沒有匹配的測試案例，這種場景下很有用。?
33. –dryrun 驗證測試數據并且執行測試，以便測試庫關鍵字不執行。?
34. –exitonfailure 任何 critical 基本的案例失敗，停止測試。?
35. –exitonerror 當發生任何錯誤就停止測試?
36. –skipteardownonexit 如果測試執行暫停，就跳過teardown 退出。?
37. –randomize all|suites|tests|none 隨機執行。?
    • a) all: 隨機執行測試套件和測試案例。?
    • b) suites: 隨機執行測試套件?
    • c) tests: 隨機執行測試案例。?
    • d) none: 不隨機執行，默認。?
    • e) 使用語法 ‘VALUE:SEED’ 賦予一個用戶隨機種子，必須是整數。?
    • • i. –randomize all?
    • • ii. –randomize tesets:1234?
38. –runmode mode * 2.8版本已經廢棄，請分別獨立使用：–dryrun, –exitonfailure,–skipteardownonexit, 或者 –randomize 選項代替。?
39. -W –monitorwidth chars 監視器的輸出寬度。 默認是 78?
40. -C –monitorcolors auto|on|ansi|off 在控制臺使用顏色輸出。?
    • a) auto: 當輸出沒有重定向時使用顏色輸出。?
    • b) on: 總是使用顏色。?
    • c) ansi: 想on 參數一樣，但是在windows 使用ANSI 顏色。?
    • d) off: 禁止顏色?
    • e) 注意Jpython 在windows 不顯示顏色。?
41. -K –monitormarkers auto|on|off 當頂層關鍵字在測試案例中結束時，在控制臺顯示 ‘.’ 成功 或 ‘F’ 失敗。 和–monitorcolors 參數的用法一直。?
42. -P –pythonpath path * 添加額外的路徑（directories,ZIPs,JARs）去搜索測試庫當他們被導入時。多個路徑可以用: 做分隔符。?
    • a) 例子：–pythonpath libs/?
    • b) –pythonpath /opt/testlibs:mylibs.zip:yourlib?
    • c) -E star:STAR -P lib/STAR.jra -P mylib.jar?
43. -E –escape what:with * 在控制臺有問題的轉移字符。?
    • a) what 代表轉移字符的名字，with 是要轉移成的字符?
    • b) 需要謹慎選擇和使用轉移字符。?
    • c) amp <&>,apos<’>,at<@>,bslash<>,colon<:>,comma<,>,curly1<{>,curly2<}>,dollar