Behave 简明教程

Behave - Configuration Files

Behave 配置文件称为 .behaverc / behave.ini / setup.cfg / tox.ini (可选择一个并根据用户选择设定)。

文件可以位于以下位置−

  1. The present working directory.

  2. User home directory.

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

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

例如，

[behave]
format = plain
dry_run = false

Types of Parameters

Behave 中的配置参数类型包括以下内容−

  1. Text − 将文本分配给配置设置。

  2. Bool − 将布尔值分配给配置设置。文本定义行为（真值包括 1、true、yes 和 on）。假值包括 0、false、no 和 off）。

  3. Sequence<text> − 接受新行上的多个值。

例如，标签表达式可以如下所示−

tags=@a, ~@b
         @c

这等效于以下标签表达式−

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

Configuration Parameters

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

  1. color − bool

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

  1. dry_run − bool

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

  1. userdata_defines − sequence<text>

声明用于 config.userdata 词典的自定义数据。

  1. exclude_re − text

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

  1. include_re − text

在执行期间包括与正则表达式模式相同的特性文件。

  1. junit − bool

添加 JUnit 报告作为输出。启用 JUnit 时，每个 stdout 和 stderr 将成为 junit 报告的一部分。（与 -capture/-no-capture 选项无关）。

  1. junit_directory − text

这是存储 JUnit 报表的位置。

  1. default_format − text

声明默认格式。默认值为 pretty。

  1. format: sequence<text>

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

  1. steps_catalog − bool

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

  1. scenario_outline_annotation_schema: text

提及场景大纲的注释模式。

  1. show_skipped − bool

在控制台打印时包含跳过的步骤。这是内置特性，并且可以覆盖配置文件设置。

  1. show_snippets − bool

在控制台打印时包括尚未实现的步骤的代码段。这是内置特性，并且可以覆盖配置文件设置。

  1. show_multiline − bool

在步骤下包含多行表格和字符串。这是内置特性，可覆盖配置文件设置。

  1. name − sequence<text>

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

  1. stdout_capture − bool

包含 stdout。这是内置特性，可覆盖配置文件设置。

  1. stderr_capture − bool

包含 stderr。这是内置特性，可覆盖配置文件设置。

  1. log_capture − bool

包含日志捕获。在故障期间，将出现和提供步骤的每一份日志。这是内置特性，可覆盖配置文件设置。

  1. logging_level − text

提及要捕获的日志级别。默认值为 INFO。

  1. logging_format − text

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

  1. logging_datefmt − text

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

  1. logging_filter − text

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

  1. logging_clear_handlers : bool

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

  1. summary − bool

执行后包括一个摘要。

  1. outfiles − sequence<text>

写入给定的文件，而不是使用 stdout。

  1. paths − sequence<text>

提及特性的文件默认路径。

  1. quiet − bool

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

  1. show-source − bool

包括打印文件和步骤定义的行，以及步骤。这是内置特性，并且可以覆盖配置文件设置。

  1. stage − text

描述测试的当前阶段。阶段名称用作环境文件的名称附加信息，以及步骤目录。

  1. stop − bool

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

  1. tags − sequence<text>

在执行中包括具有与 TAG_EXPRESSION 相同标记的特性/场景。

  1. default_tags − text

如果未给定默认标记，则声明默认标记。

  1. show_timings − bool

在控制台捕获每个步骤完成所需的时间（以秒为单位）。这是一个内置特性，并且可以覆盖配置文件设置。

  1. verbose − bool

显示加载的特性和文件。

  1. wip − bool

执行具有 wip 标记的场景。此外，我们必须使用简单的格式化程序，而不是记录 stdout 或日志输出，并在第一次失败后终止。

  1. expand − bool

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

  1. lang − text

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