Behave教程：精确运行BDD场景大纲中的单个示例

本文详细介绍了在behave bdd框架中，如何精确执行`scenario outline`（场景大纲）中的特定示例。通过利用behave命令行工具，结合指定特性文件路径和目标数据行的确切行号，开发者能够精准定位并运行单个数据行，从而高效地进行测试和调试，无需执行整个示例表。

理解 Scenario Outline 与示例表

在行为驱动开发（BDD）中，Scenario Outline 是一种强大的Gherkin语法结构，它允许我们使用不同的数据集重复运行同一个场景。这通过一个 Examples 表来实现，表中每一行数据都代表一个独立的测试用例。

例如，考虑以下一个简单的加法场景大纲：

# features/calculator.feature
Feature: Calculator Operations

  Scenario Outline: Addition of many numbers
    Given I have '<num1>' and '<num2>'
    When I add them
    Then The result must be '<total>'

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

在这个例子中，Addition of many numbers 场景大纲将运行四次，每次使用 Examples 表中的一行数据。通常，我们可以使用 behave --name "Addition of many numbers" 命令来执行这个场景大纲，这将运行所有四个示例。

挑战：如何只运行特定示例？

在开发或调试过程中，我们可能只需要验证 Examples 表中的某个特定数据行，而不是所有行。例如，我们可能只想运行第二行示例 | 11 | 31 | 42 |。传统的 --name 参数无法实现这种精确的行级控制。

解决方案：通过行号精确指定

Behave 提供了一种灵活的机制来解决这个问题：通过在特性文件路径后附加冒号和精确的行号，可以直接指定要运行的场景或示例。这种语法格式为 your_feature.feature:line_number。

根据 behave --help 的输出，我们可以看到关于路径参数的说明：

positional arguments:
  paths                 Feature directory, file or file location (FILE:LINE).

这明确指出 Behave 支持 FILE:LINE 的格式来定位特定的测试点。

左手医生开放平台

左医科技医疗智能开放平台

62

查看详情

要运行 Scenario Outline 中的特定示例，我们需要找到该示例在特性文件中的确切行号。以上述 calculator.feature 文件为例，我们来确定第二行示例 | 11 | 31 | 42 | 的行号：

# features/calculator.feature
1 Feature: Calculator Operations
2
3   Scenario Outline: Addition of many numbers
4
5     Given I have '<num1>' and '<num2>'
6     When I add them
7     Then The result must be '<total>'
8
9     Examples:
10      | num1 | num2 | total |
11      | 1    | 1    | 2     |  # 第一个示例数据行
12      | 11   | 31   | 42    |  # 第二个示例数据行 - 目标行
13      | 21   | 41   | 62    |
14      | 31   | 51   | 82    |

从上述带行号的示例中可以看到，我们想要运行的第二个示例数据行 | 11 | 31 | 42 | 位于文件的第 12 行。

操作步骤与示例

要只运行 calculator.feature 文件中的第12行示例，请在命令行中执行以下命令：

behave features/calculator.feature:12

执行此命令后，Behave 将只会运行 Addition of many numbers 场景大纲中对应第12行数据（即 num1=11, num2=31, total=42）的测试用例。

注意事项

• 行号从1开始计算：文件中的行号始终从1开始计数。
• 精确指定数据行：确保你提供的行号是 Examples 表中实际数据行的行号，而不是 Examples: 关键字或表头行的行号。
• 文件路径：确保 your_feature.feature 是特性文件的正确相对或绝对路径。
• 适用场景：这种方法非常适用于调试失败的特定示例，或者在开发新功能时只关注与该功能相关的特定测试用例。
• 与其他参数结合：FILE:LINE 语法可以与Behave的其他命令行参数（如 --format, --tags 等）结合使用，以进一步定制测试执行。

总结

通过利用 Behave 的 FILE:LINE 语法，我们可以对 Scenario Outline 中的单个示例进行精确控制，极大地提升了测试的灵活性和效率。掌握这一技巧，将有助于开发者更高效地进行 BDD 测试和问题排查。

以上就是Behave教程：精确运行BDD场景大纲中的单个示例的详细内容，更多请关注php中文网其它相关文章！