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 - 文本

使用除英语以外的语言的关键字。