Behave - 配置文件

文件可以位于以下位置 −

• 当前工作目录。

• 用户主目录。

• 对于 Windows 用户，在目录 %APPDATA% 中。

命令behave –v，应显示所有配置细节。 配置文件应以关键字 [behave] 开头，并遵循 Windows INI 样式格式。

例如，

[behave]
format = plain
dry_run = false

参数类型

Behave中的配置参数类型包括以下几种 −

• Text − 为配置设置分配文本。

• Bool −为配置设置指定布尔值。 文本定义了行为（true 值包括 1、true、yes 和 on）。 false 值包括 0、false、no 和 off）。

• Sequence<text> − 在新行上接受多个值。

例如标签表达式可以如下 −

tags=@a, ~@b
         @c

这相当于下面的标签表达式 −

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

配置参数

Behave中的一些配置参数解释如下 −

• color − bool

利用 ANSI 颜色转义。 这是一个内置特性，可以否决配置文件中的设置。

• dry_run − bool

调用格式化程序而不运行这些步骤。

• userdata_defines − sequence<text>

为 config.userdata 字典声明自定义数据。

• exclude_re − text

从执行中排除与正则表达式模式相同的特征文件。

• include_re − text

在执行过程中包含与正则表达式模式相同的特征文件。

• junit − bool

添加 JUnit 报告作为输出。 当打开 JUnit 时，每个 stdout 和 stderr 都将成为 junit 报告的一部分。 （不考虑 -capture/-no-capture 选项）。

• junit_directory − text

这是存储 JUnit 报告的目录位置。

• default_format − text

声明默认格式化程序。 默认值是 pretty。

• format: sequence<text>

定义格式化程序。 如果省略，则使用内置格式化程序。 –format-help 命令应显示所有可用格式。

• steps_catalog − bool

显示所有现有步骤定义的目录。

• scenario_outline_annotation_schema: text

提及场景大纲的注释架构。

• show_skipped − bool

在控制台中打印时包括跳过的步骤。 这是一个内置特性，可以否决配置文件设置。

• show_snippets − bool

在控制台中打印步骤时包含片段，这些步骤仍未实现。 这是一个内置特性，可以否决配置文件设置。

• show_multiline − bool

在步骤下包含多行表格和字符串。 这是一个内置特性，可以否决配置文件设置。

• name − sequence<text>

在运行中包含与指定名称相同的特征元素。 如果多次提供该选项，它将匹配所有指定的名称。

• stdout_capture − bool

包括标准输出。 这是一个内置特性，可以否决配置文件设置。

• stderr_capture − bool

包括标准错误。 这是一个内置特性，可以否决配置文件设置。

• log_capture − bool

包括日志捕获。 在失败期间，步骤的每个日志都将存在并可用。 这是一个内置特性，可以否决配置文件设置。

• logging_level − text

提及要捕获的日志记录级别。 默认值是 INFO。

• logging_format − text

提及用于打印语句的用户定义格式。 默认值为 %(levelname)s:%(name)s:%(message)s。

• logging_datefmt − text

提及用于打印报表的用户定义的日期和时间格式。

• logging_filter − text

提及要过滤的语句。 默认情况下会捕获所有语句。 如果输出太长，我们可以利用该选项过滤掉不需要的输出。

• logging_clear_handlers : bool

删除所有用于日志记录的处理程序。

• summary − bool

包括执行后的摘要。

• outfiles − sequence<text>

写 given 文件而不是使用 stdout。

• paths − sequence<text>

提及功能文件的默认路径。

• quiet − bool

别名用于–no-snippets –no-source。

• show-source − bool

包括打印文件和步骤定义行以及步骤。 这是一个内置特性，可以否决配置文件设置。

• stage − text

描述测试的当前阶段。 阶段名称用作环境文件的名称后缀以及步骤的目录。

• stop − bool

遇到第一个失败后终止执行测试。

• tags − sequence<text>

在执行中包括具有与 TAG_EXPRESSION 相同的标签的功能/场景。

• default_tags − text

如果没有给出则声明默认标签。

• show_timings − bool

在控制台中捕获每一步完成所需的持续时间（以秒为单位）。 这是一个内置特性，可以否决配置文件设置。

• verbose − bool

显示加载的功能和文件。

• wip − bool

执行带有wip标签的场景。 此外，我们必须使用普通格式化程序而不是记录标准输出或日志输出并终止首次失败后。

• expand − bool

将输出中的场景大纲表格展平。

• lang − text

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