Behave框架：精确执行Scenario Outline中的特定示例

本文将详细介绍在behave bdd框架中，如何针对`scenario outline`中的多个示例（examples）表，仅执行其中特定的一个或一部分示例，而非全部。我们将探讨常见的挑战，并提供一种基于文件路径和行号的精确控制方法，通过具体的代码示例和命令行指令，帮助开发者高效地进行局部测试和调试。

引言

在行为驱动开发（BDD）中，Behave框架广泛用于定义和执行业务需求。Scenario Outline是Behave中一个强大的特性，它允许我们使用相同的步骤定义来测试多个不同的输入数据集。这些数据集通过Examples表提供，Behave会为表中的每一行数据运行一次场景。

然而，在开发或调试过程中，我们可能只需要验证Examples表中的某个特定数据行，而不是运行所有的示例。例如，当某个特定的输入组合导致测试失败时，我们希望能够快速定位并只运行该失败的示例，以提高调试效率。

常规执行方式及其局限

通常，我们可以使用behave --name "Scenario Outline名称"来执行一个Scenario Outline及其所有的示例。例如，对于以下场景：

Feature: 加法运算

  Scenario Outline: 多个数字相加
    Given 我有 '' 和 ''
    When 我将它们相加
    Then 结果必须是 ''

  Examples:
    | num1 | num2 | total |
    | 1    | 1    | 2     |
    | 11   | 31   | 42    |
    | 21   | 41   | 62    |
    | 31   | 51   | 82    |

如果这个Feature文件名为 addition.feature，我们可以通过以下命令运行所有示例：

behave --name "多个数字相加"

这个命令会依次执行Examples表中的所有四行数据。但如果我们的目标是仅运行第二行示例 | 11 | 31 | 42 |，直接使用--name参数是无法实现的。尝试在名称后添加索引或其他标识符（例如--name "多个数字相加 [2]"）通常不会奏效，因为Behave的--name参数主要用于匹配场景的文本名称，而非其内部的示例索引。

精确执行方案：利用文件和行号

Behave提供了一种更为精确的执行机制，允许我们通过指定Feature文件的路径和特定的行号来运行测试。这种方法对于只执行Scenario Outline中的一个示例尤为有效。

其基本语法是：

behave :

其中：

• 是包含目标场景的Feature文件的路径。
• 是指Feature文件中，你希望执行的特定示例数据行（Examples表中的某一行）的起始行号。

Behave的命令行工具会解析这个FILE:LINE格式的参数，并精确地执行该行号所对应的场景或示例。如果行号指向Scenario Outline的Examples表中的一个数据行，Behave将仅执行该行数据对应的示例。

北极象沉浸式AI翻译

免费的北极象沉浸式AI翻译 - 带您走进沉浸式AI的双语对照体验

下载

实战演示

让我们以上述addition.feature为例，演示如何精确执行第二行示例 | 11 | 31 | 42 |。

首先，确保你的addition.feature文件内容如下，并假设Feature关键字位于文件的第一行：

# addition.feature
Feature: 加法运算

  Scenario Outline: 多个数字相加
    Given 我有 '' 和 ''
    When 我将它们相加
    Then 结果必须是 ''

  Examples:
    | num1 | num2 | total |
    | 1    | 1    | 2     |
    | 11   | 31   | 42    |  # 这是我们想要运行的第二个示例
    | 21   | 41   | 62    |
    | 31   | 51   | 82    |

为了找到目标示例的行号，我们需要手动计算或使用文本编辑器的行号显示功能。根据上述文件内容，我们可以得出：

1. Feature: 加法运算 - 第1行
2. (空行) - 第2行
3. Scenario Outline: 多个数字相加 - 第3行
4. (空行) - 第4行
5. Given 我有 '' 和 '' - 第5行
6. When 我将它们相加 - 第6行
7. Then 结果必须是 '' - 第7行
8. (空行) - 第8行
9. Examples: - 第9行
10. | num1 | num2 | total | - 第10行 (表头)
11. | 1 | 1 | 2 | - 第11行 (第一个示例)
12. | 11 | 31 | 42 | - 第12行 (第二个示例，目标行)
13. | 21 | 41 | 62 | - 第13行 (第三个示例)
14. | 31 | 51 | 82 | - 第14行 (第四个示例)

从计数结果可知，我们希望执行的第二个示例 | 11 | 31 | 42 | 位于文件的第12行。

现在，我们可以使用以下命令来精确执行这个特定的示例：

behave addition.feature:12

执行此命令后，Behave将只会运行Scenario Outline: 多个数字相加中的第二个示例，即使用num1=11, num2=31, total=42这组数据进行测试。

注意事项

• 行号精确性： 行号必须精确指向Examples表中特定数据行的起始位置。任何空行或注释行都会影响行号计数。
• 1-基于索引： Behave的行号是基于1的索引，即文件的第一行是行号1。
• 文件路径： 确保提供的Feature文件路径是正确的，可以是相对路径或绝对路径。
• 调试效率： 这种方法对于快速定位和调试Scenario Outline中特定数据场景的失败非常有效，避免了不必要的全量测试运行。

总结

通过behave :这一简洁而强大的命令，我们可以在Behave框架中精确控制Scenario Outline的执行范围，实现对特定示例的按需测试。这不仅提升了测试和调试的效率，也使得BDD测试的粒度控制更为精细。掌握这一技巧，将使你在Behave框架下的测试工作更加灵活和高效。