Behave - 配置檔案

---

---

Behave 配置檔案被稱為 .behaverc/behave.ini/setup.cfg/tox.ini（任選其一，根據使用者選擇設定）。

這些檔案可以位於以下位置：

• 當前工作目錄。

• 使用者主目錄。

• 對於 Windows 使用者，位於 %APPDATA% 目錄。

命令 behave –v 將顯示所有配置詳細資訊。配置檔案應以關鍵字 [behave] 開頭，並遵循 Windows INI 樣式格式。

例如：

[behave]
format = plain
dry_run = false

引數型別

Behave 中的配置引數型別包括以下幾種：

• 文字 - 為配置設定分配文字。

• 布林值 - 為配置設定分配布林值。文字定義行為（真值包括 1、true、yes 和 on）。假值包括 0、false、no 和 off）。

• Sequence<text> - 在新行上接受多個值。

例如，標籤表示式可以如下所示：

tags=@a, ~@b
         @c

這等效於以下標籤表示式：

--tags @a, ~@b --tags @c

配置引數

下面解釋 Behave 中的一些配置引數：

• color - 布林值

使用 ANSI 顏色轉義符。這是一個內建特性，可以覆蓋配置檔案中的設定。

• dry_run - 布林值

呼叫格式化程式而不執行步驟。

• userdata_defines - sequence<text>

宣告 config.userdata 字典的自定義資料。

• exclude_re - 文字

從執行中排除與正則表示式模式相同的特性檔案。

• include_re - 文字

在執行期間包含與正則表示式模式相同的特性檔案。

• junit - 布林值

新增 JUnit 報告作為輸出。啟用 JUnit 時，每個 stdout 和 stderr 都將成為 junit 報告的一部分。（與 -capture/-no-capture 選項無關）。

• junit_directory - 文字

這是儲存 JUnit 報告的目錄位置。

• default_format - 文字

宣告預設格式化程式。預設值為 pretty。

• format: sequence<text>

定義格式化程式。如果省略，則使用內建格式化程式。–format-help 命令將顯示所有可用的格式。

• steps_catalog - 布林值

顯示所有現有步驟定義的目錄。

• scenario_outline_annotation_schema: 文字

提及場景大綱的註釋模式。

• show_skipped - 布林值

在控制檯中列印時包含跳過的步驟。這是一個內建特性，可以覆蓋配置檔案設定。

• show_snippets - 布林值

在控制檯中列印尚未實現的步驟的程式碼片段。這是一個內建特性，可以覆蓋配置檔案設定。

• show_multiline - 布林值

包含步驟下的多行表和字串。這是一個內建特性，可以覆蓋配置檔案設定。

• name - sequence<text>

包含執行中與指定名稱相同的特性元素。如果多次提供此選項，它將匹配所有指定的名稱。

• stdout_capture - 布林值

包含 stdout。這是一個內建特性，可以覆蓋配置檔案設定。

• stderr_capture - 布林值

包含 stderr。這是一個內建特性，可以覆蓋配置檔案設定。

• log_capture - 布林值

包含日誌捕獲。步驟的每個日誌都將在失敗時存在並可用。這是一個內建特性，可以覆蓋配置檔案設定。

• logging_level - 文字

提及要捕獲的日誌級別。預設值為 INFO。

• logging_format - 文字

提及使用者定義的列印語句格式。預設值為 %(levelname)s:%(name)s:%(message)s。

• logging_datefmt - 文字

提及使用者定義的列印語句日期和時間格式。

• logging_filter - 文字

提及要過濾的語句。預設情況下捕獲所有語句。如果輸出過長，我們可以使用此選項過濾掉不必要的輸出。

• logging_clear_handlers : 布林值

移除所有用於記錄的控制代碼。

• summary - 布林值

執行後包含摘要。

• outfiles - sequence<text>

寫入給定檔案而不是使用 stdout。

• paths - sequence<text>

提及特性檔案的預設路徑。

• quiet - 布林值

別名用於 –no-snippets –no-source。

• show-source - 布林值

包含列印步驟定義的檔案和行以及步驟。這是一個內建特性，可以覆蓋配置檔案設定。

• stage - 文字

描述測試的當前階段。階段名稱用作環境檔案的名稱字尾以及步驟的目錄。

• stop - 布林值

遇到第一次失敗後終止執行測試。

• tags - sequence<text>

包含在執行中具有與 TAG_EXPRESSION 相同的標籤的特性/場景。

• default_tags - 文字

如果沒有給出，則宣告預設標籤。

• show_timings - 布林值

在控制檯中捕獲每個步驟完成所花費的秒數。這是一個內建特性，可以覆蓋配置檔案設定。

• verbose - 布林值

顯示載入的特性和檔案。

• wip - 布林值

執行具有 wip 標籤的場景。此外，我們必須使用普通格式化程式，而不是記錄 stdout 或日誌輸出，並在第一次失敗後終止。

• expand - 布林值

在輸出中展平場景大綱的表。

• lang - 文字

使用除英語以外的語言的關鍵字。