本教程详细介绍了在 behave bdd 框架中，如何通过指定特征文件路径和精确的行号，来运行 scenario outline 中特定的一个示例数据行。这种方法提供了细粒度的测试执行控制，对于调试或聚焦测试场景非常有用，避免了运行所有相关示例的开销。
在行为驱动开发（BDD）实践中，Scenario Outline 结合 Examples 表是实现参数化测试的强大工具。它允许我们使用不同的数据集重复执行相同的场景步骤，从而提高测试的覆盖率和效率。然而，在某些情况下，例如进行特定场景的调试或聚焦于某个失败的示例时，我们可能需要精确地运行 Scenario Outline 中 Examples 表里的某一行数据，而不是全部。
理解 Scenario Outline 与 Examples
Scenario Outline 结构允许您定义一个包含占位符（如 <num1>）的场景，这些占位符会在 Examples 表中的每一行数据中被替换。
考虑以下一个简单的加法场景：
Feature: Addition
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" 命令来运行这个 Scenario Outline 的所有示例。
精确运行单个示例的挑战
当我们需要只运行 Examples 表中的某一行，例如第二行 | 11 | 31 | 42 | 时，传统的 --name 参数无法直接实现。直接尝试附加索引或行号（如 --name "Addition of many numbers @2"）是无效的。
解决方案：使用文件路径和行号定位
Behave 框架提供了一种通过指定特征文件路径和精确行号来运行特定场景或示例的机制。根据 behave --help 的输出，paths 参数支持 FILE:LINE 的格式。这意味着我们可以通过指定特征文件以及该示例数据行所在的行号来精确执行它。
执行步骤：
确定特征文件路径： 找到您的 .feature 文件，例如 your_feature.feature。
-
定位示例数据行的行号： 打开您的 .feature 文件，找到您想要运行的特定示例数据行。请注意，行号是从文件顶部开始计算的，通常从 1 开始。
以上述加法场景为例，假设它存储在 your_feature.feature 文件中，并且文件内容如下（为便于理解，我们添加了行号）：
1 Feature: Addition 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 Examples: 9 | num1 | num2 | total | 10 | 1 | 1 | 2 | 11 | 11 | 31 | 42 | 12 | 21 | 41 | 62 | 13 | 31 | 51 | 82 |
如果我们要运行第二行示例 | 11 | 31 | 42 |，它位于文件的第 11 行。
-
执行命令： 使用 behave your_feature.feature:line_number 格式执行命令。
对于上述示例，要运行第 11 行的示例，命令将是：
behave your_feature.feature:11
执行此命令后，Behave 将只会运行 Scenario Outline: Addition of many numbers 中使用 num1=11, num2=31, total=42 这组数据所对应的场景步骤。
注意事项
- 行号精确性： 确保您提供的行号精确指向 Examples 表中的目标数据行，而不是 Examples: 关键字或表格的头部。行号必须是目标数据行开始的行号。
- 调试与效率： 这种方法在调试特定失败示例时尤其有用，因为它避免了运行整个 Scenario Outline 的所有示例，从而节省了时间和资源。
- 文件路径： 确保 your_feature.feature 的路径是相对于您执行 behave 命令的当前目录的正确路径，或者提供绝对路径。
总结
通过利用 Behave 框架提供的 FILE:LINE 语法，我们可以对 Scenario Outline 中的单个示例进行精确控制和执行。这极大地提升了 BDD 测试的灵活性和调试效率，使得开发者和测试人员能够更专注于特定行为的验证，从而加速开发和修复周期。掌握这一技巧，将使您在 Behave 测试实践中更加得心应手。
