From 1d87ac7aebaf3399c73a3edbe90256dc8fe9aac5 Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Tue, 16 Oct 2018 18:27:17 +0800 Subject: [PATCH 1/2] PRF:20180528 What is behavior-driven Python.md @Flowsnow --- ...20180528 What is behavior-driven Python.md | 107 +++++++++--------- 1 file changed, 56 insertions(+), 51 deletions(-) diff --git a/translated/tech/20180528 What is behavior-driven Python.md b/translated/tech/20180528 What is behavior-driven Python.md index 16edc3c802..943d96e5f1 100644 --- a/translated/tech/20180528 What is behavior-driven Python.md +++ b/translated/tech/20180528 What is behavior-driven Python.md @@ -1,26 +1,29 @@ -什么是行为驱动的Python？ +什么是行为驱动的 Python？ ====== + +> 使用 Python behave 框架的行为驱动开发模式可以帮助你的团队更好的协作和测试自动化。 + ![](https://opensource.com/sites/default/files/styles/image-full-size/public/lead-images/checklist_hands_team_collaboration.png?itok=u82QepPk) -您是否听说过[行为驱动开发][1]（BDD），并想知道所有的新奇事物是什么？ 也许你已经发现了团队成员在使用“gherkin”了，并感到被排除在外无法参与其中。 或许你是一个Python爱好者，正在寻找更好的方法来测试你的代码。 无论在什么情况下，了解BDD都可以帮助您和您的团队实现更好的协作和测试自动化，而Python的`行为`框架是一个很好的起点。 +您是否听说过[行为驱动开发][1]behavior-driven development（BDD），并好奇这是个什么东西？也许你发现了团队成员在谈论“嫩瓜”（LCTT 译注：“嫩瓜gherkin” 是一种简单的英语文本语言，工具 cucumber 通过解释它来执行测试脚本，见下文），而你却不知所云。或许你是一个 Python 人Pythonista，正在寻找更好的方法来测试你的代码。 无论在什么情况下，了解 BDD 都可以帮助您和您的团队实现更好的协作和测试自动化，而 Python 的 [behave][21] 框架是一个很好的起点。 -### 什么是BDD？ +### 什么是 BDD？ + +在软件中，*行为*是指在明确定义的输入、动作和结果场景中功能是如何运转的。 产品可以表现出无数的行为，例如： * 在网站上提交表单 * 搜索想要的结果 * 保存文档 - * 进行REST API调用 + * 进行 REST API 调用 * 运行命令行界面命令 -在软件中，行为是指在明确定义的输入，行为和结果场景中功能是如何运转的。 产品可以表现出无数的行为，例如： - -根据产品的行为定义产品的功能可以更容易地描述产品，并对其进行开发和测试。 BDD的核心是：使行为成为软件开发的焦点。 在开发早期使用示例语言的规范来定义行为。 最常见的行为规范语言之一是Gherkin，Cucumber项目中的Given-When-Then场景格式。 行为规范基本上是对行为如何工作的简单语言描述，具有一致性和焦点的一些正式结构。 通过将步骤文本“粘合”到代码实现，测试框架可以轻松地自动化这些行为规范。 +根据产品的行为定义产品的功能可以更容易地描述产品，并对其进行开发和测试。 BDD 的核心是：使行为成为软件开发的焦点。在开发早期使用示例语言的规范来定义行为。最常见的行为规范语言之一是 Gherkin，Cucumber项目中的Given-When-Then场景格式。 行为规范基本上是对行为如何工作的简单语言描述，具有一致性和焦点的一些正式结构。 通过将步骤文本“粘合”到代码实现，测试框架可以轻松地自动化这些行为规范。 下面是用Gherkin编写的行为规范的示例： -根据产品的行为定义产品的功能可以更容易地描述产品，开发产品并对其进行测试。 这是BDD的核心：使行为成为软件开发的焦点。 在开发早期使用[示例规范][2]的语言来定义行为。 最常见的行为规范语言之一是[Gherkin][3]，[Cucumber][4]项目中的Given-When-Then场景格式。 行为规范基本上是对行为如何工作的简单语言描述，具有一致性和焦点的一些正式结构。 通过将步骤文本“粘合”到代码实现，测试框架可以轻松地自动化这些行为规范。 +根据产品的行为定义产品的功能可以更容易地描述产品，开发产品并对其进行测试。 这是BDD的核心：使行为成为软件开发的焦点。 在开发早期使用[示例规范][2]的语言来定义行为。 最常见的行为规范语言之一是[Gherkin][3]，来自 [Cucumber][4] 项目中的 Given-When-Then 场景格式。 行为规范基本上是对行为如何工作的简单语言描述，具有一致性和聚焦点的一些正式结构。 通过将步骤文本“粘合”到代码实现，测试框架可以轻松地自动化这些行为规范。 -下面是用Gherkin编写的行为规范的示例： +下面是用 Gherkin 编写的行为规范的示例： ``` Scenario: Basic DuckDuckGo Search @@ -31,44 +34,45 @@ Scenario: Basic DuckDuckGo Search 快速浏览一下，行为是直观易懂的。 除少数关键字外，该语言为自由格式。 场景简洁而有意义。 一个真实的例子说明了这种行为。 步骤以声明的方式表明应该发生什么——而不会陷入如何如何的细节中。 -[BDD的主要优点][5]是良好的协作和自动化。 每个人都可以为行为开发做出贡献，而不仅仅是程序员。 从流程开始就定义并理解预期的行为。 测试可以与它们涵盖的功能一起自动化。 每个测试都包含一个单一的，独特的行为，以避免重复。 最后，现有的步骤可以通过新的行为规范重用，从而产生雪球效果。 +[BDD 的主要优点][5]是良好的协作和自动化。 每个人都可以为行为开发做出贡献，而不仅仅是程序员。从流程开始就定义并理解预期的行为。测试可以与它们涵盖的功能一起自动化。每个测试都包含一个单一的、独特的行为，以避免重复。最后，现有的步骤可以通过新的行为规范重用，从而产生雪球效果。 -### Python的behave框架 +### Python 的 behave 框架 -`behave`是Python中最流行的BDD框架之一。 它与其他基于Gherkin的Cucumber框架非常相似，尽管没有得到官方的Cucumber定名。 `behave`有两个主要层： +behave 是 Python 中最流行的 BDD 框架之一。 它与其他基于 Gherkin 的 Cucumber 框架非常相似，尽管没有得到官方的 Cucumber 定名。 behave 有两个主要层： -1. 用Gherkin的`.feature`文件编写的行为规范 -2. 用Python模块编写的步骤定义和钩子，用于实现Gherkin步骤 +1. 用 Gherkin 的 `.feature` 文件编写的行为规范 +2. 用 Python 模块编写的步骤定义和钩子，用于实现 Gherkin 步骤 -如上例所示，Gherkin场景有三部分格式： +如上例所示，Gherkin 场景有三部分格式： -1. 鉴于一些初始状态 -2. 当行为发生时 -3. 然后验证结果 +1. 鉴于（Given）一些初始状态 +2. 每当（When）行为发生时 +3. 然后（Then）验证结果 -当`behave`运行测试时，每个步骤由装饰器“粘合”到Python函数。 +当 behave 运行测试时，每个步骤由装饰器“粘合”到 Python 函数。 ### 安装 -作为先决条件，请确保在你的计算机上安装了Python和`pip`。 我强烈建议使用Python 3.（我还建议使用[`pipenv`][6]，但以下示例命令使用更基本的`pip`。） +作为先决条件，请确保在你的计算机上安装了 Python 和 `pip`。 我强烈建议使用 Python 3.（我还建议使用 [pipenv][6]，但以下示例命令使用更基本的 `pip`。） -`behave`框架只需要一个包： +behave 框架只需要一个包： ``` pip install behave ``` 其他包也可能有用，例如： + ``` -pip install requests    # 用于调用REST API -pip install selenium    # 用于web浏览器交互 +pip install requests    # 用于调用 REST API +pip install selenium    # 用于 web 浏览器交互 ``` -GitHub上的[behavior-driven-Python][7]项目包含本文中使用的示例。 +GitHub 上的 [behavior-driven-Python][7] 项目包含本文中使用的示例。 -### Gherkin特点 +### Gherkin 特点 -`behave`框架使用的Gherkin语法实际上是符合官方的Cucumber Gherkin标准的。 `.feature`文件包含功能Feature部分，而Feature部分又包含具有Given-When-Then步骤的场景Scenario部分。 以下是一个例子： +behave 框架使用的 Gherkin 语法实际上是符合官方的 Cucumber Gherkin 标准的。`.feature` 文件包含了功能（`Feature`）部分，而场景部分又包含具有 Given-When-Then 步骤的场景（`Scenario`） 部分。 以下是一个例子： ``` Feature: Cucumber Basket @@ -87,14 +91,14 @@ Feature: Cucumber Basket 这里有一些重要的事情需要注意： -- Feature和Scenario部分都有[简短的描述性标题][8]。 -- 紧跟在Feature标题后面的行是会被`behave`框架忽略掉的注释。将功能描述放在那里是一种很好的做法。 -- Scenarios和Features可以有标签（注意`@cucumber-basket`标记）用于钩子和过滤（如下所述）。 -- 步骤都遵循[严格的Given-When-Then顺序][9]。 -- 使用`And`和`Bu`t可以为任何类型添加附加步骤。 +- `Feature` 和 `Scenario` 部分都有[简短的描述性标题][8]。 +- 紧跟在 `Feature` 标题后面的行是会被 behave 框架忽略掉的注释。将功能描述放在那里是一种很好的做法。 +- `Scenario` 和 `Feature` 可以有标签（注意 `@cucumber-basket` 标记）用于钩子和过滤（如下所述）。 +- 步骤都遵循[严格的 Given-When-Then 顺序][9]。 +- 使用 `And` 和 `But` 可以为任何类型添加附加步骤。 - 可以使用输入对步骤进行参数化——注意双引号里的值。 -通过使用场景大纲，场景也可以写为具有多个输入组合的模板： +通过使用场景大纲（`Scenario Outline`），场景也可以写为具有多个输入组合的模板： ``` Feature: Cucumber Basket @@ -112,13 +116,13 @@ Feature: Cucumber Basket | 5 | 4 | 9 | ``` -场景大纲总是有一个Examples表，其中第一行给出列标题，后续每一行给出一个输入组合。 只要列标题出现在由尖括号括起的步骤中，行值就会被替换。 在上面的示例中，场景将运行三次，因为有三行输入组合。 场景大纲是避免重复场景的好方法。 +场景大纲总是有一个示例（`Examples`）表，其中第一行给出列标题，后续每一行给出一个输入组合。 只要列标题出现在由尖括号括起的步骤中，行值就会被替换。 在上面的示例中，场景将运行三次，因为有三行输入组合。 场景大纲是避免重复场景的好方法。 -Gherkin语言还有其他元素，但这些是主要的机制。 想了解更多信息，请阅读Automation Panda这个网站的文章[Gherkin by Example][10]和[Writing Good Gherkin][11]。 +Gherkin 语言还有其他元素，但这些是主要的机制。 想了解更多信息，请阅读 Automation Panda 这个网站的文章 [Gherkin by Example][10] 和 [Writing Good Gherkin][11]。 -### Python机制 +### Python 机制 -每个Gherkin步骤必须“粘合”到步骤定义，即提供了实现的Python函数。 每个函数都有一个带有匹配字符串的步骤类型装饰器。 它还接收共享的上下文和任何步骤参数。 功能文件必须放在名为`features/`的目录中，而步骤定义模块必须放在名为`features/steps/`的目录中。 任何功能文件都可以使用任何模块中的步骤定义——它们不需要具有相同的名称。 下面是一个示例Python模块，其中包含cucumber basket功能的步骤定义。 +每个 Gherkin 步骤必须“粘合”到步骤定义——即提供了实现的 Python 函数。 每个函数都有一个带有匹配字符串的步骤类型装饰器。它还接收共享的上下文和任何步骤参数。功能文件必须放在名为 `features/` 的目录中，而步骤定义模块必须放在名为 `features/steps/` 的目录中。 任何功能文件都可以使用任何模块中的步骤定义——它们不需要具有相同的名称。 下面是一个示例 Python 模块，其中包含 cucumber basket 功能的步骤定义。 ``` from behave import * @@ -137,11 +141,11 @@ def step_impl(context, total): assert context.basket.count == total ``` -可以使用三个[步骤匹配器][12]：`parse`，`cfparse`和`re`。默认和最简单的匹配器是`parse`，如上例所示。注意如何解析参数化值并将其作为输入参数传递给函数。一个常见的最佳实践是在步骤中给参数加双引号。 +可以使用三个[步骤匹配器][12]：`parse`、`cfparse` 和 `re`。默认的，也是最简单的匹配器是 `parse`，如上例所示。注意如何解析参数化值并将其作为输入参数传递给函数。一个常见的最佳实践是在步骤中给参数加双引号。 -每个步骤定义函数还接收一个[上下文][13]变量，该变量保存当前正在运行的场景的数据，例如`feature`, `scenario`和`tags`字段。也可以添加自定义字段，用于在步骤之间共享数据。始终使用上下文来共享数据——永远不要使用全局变量！ +每个步骤定义函数还接收一个[上下文][13]变量，该变量保存当前正在运行的场景的数据，例如 `feature`、`scenario` 和 `tags` 字段。也可以添加自定义字段，用于在步骤之间共享数据。始终使用上下文来共享数据——永远不要使用全局变量！ -`behave`框架还支持[钩子][14]来处理Gherkin步骤之外的自动化问题。钩子是一个将在步骤，场景，功能或整个测试套件之前或之后运行的功能。钩子让人联想到[面向方面的编程][15]。它们应放在`features/`目录下的特殊`environment.py`文件中。钩子函数也可以检查当前场景的标签，因此可以有选择地应用逻辑。下面的示例显示了如何使用钩子为标记为`@web`的任何场景生成和销毁一个Selenium WebDriver实例。 +behave 框架还支持[钩子][14]来处理 Gherkin 步骤之外的自动化问题。钩子是一个将在步骤、场景、功能或整个测试套件之前或之后运行的功能。钩子让人联想到[面向方面的编程][15]。它们应放在 `features/` 目录下的特殊 `environment.py` 文件中。钩子函数也可以检查当前场景的标签，因此可以有选择地应用逻辑。下面的示例显示了如何使用钩子为标记为 `@web` 的任何场景生成和销毁一个 Selenium WebDriver 实例。 ``` from selenium import webdriver @@ -156,17 +160,17 @@ def after_scenario(context, scenario): context.browser.quit() ``` -注意：也可以使用[fixtures][16]进行构建和清理。 +注意：也可以使用 [fixtures][16] 进行构建和清理。 -要了解一个`behave`项目应该是什么样子，这里是示例项目的目录结构： +要了解一个 behave 项目应该是什么样子，这里是示例项目的目录结构： ![](https://opensource.com/sites/default/files/uploads/behave_dir_layout.png) -任何Python包和自定义模块都可以与`behave`框架一起使用。 使用良好的设计模式构建可扩展的测试自动化解决方案。步骤定义代码应简明扼要。 +任何 Python 包和自定义模块都可以与 behave 框架一起使用。 使用良好的设计模式构建可扩展的测试自动化解决方案。步骤定义代码应简明扼要。 ### 运行测试 -要从命令行运行测试，请切换到项目的根目录并运行`behave`命令。 使用`-help`选项查看所有可用选项。 +要从命令行运行测试，请切换到项目的根目录并运行 behave 命令。 使用 `-help` 选项查看所有可用选项。 以下是一些常见用例： @@ -187,21 +191,21 @@ behave --tags ~@unit behave --tags @basket --tags @add,@remove ``` -为方便起见，选项可以保存在[config][17]文件中。 +为方便起见，选项可以保存在 [config][17] 文件中。 ### 其他选择 -`behave`不是Python中唯一的BDD测试框架。其他好的框架包括： +behave 不是 Python 中唯一的 BDD 测试框架。其他好的框架包括： -- `pytest-bdd`，`pytest`的插件，和`behave`一样，它使用Gherkin功能文件和步骤定义模块，但它也利用了`pytest`的所有功能和插件。例如，它可以使用`pytest-xdist`并行运行Gherkin场景。 BDD和非BDD测试也可以与相同的过滤器一起执行。 `pytest-bdd`还提供更灵活的目录布局。 -- `radish`是一个“Gherkin增强版”框架——它将Scenario循环和前提条件添加到标准的Gherkin语言中，这使得它对程序员更友好。它还提供丰富的命令行选项，如`behave`。 -- `lettuce`是一种较旧的BDD框架，与`behave`非常相似，在框架机制方面存在细微差别。然而，GitHub最近显示该项目的活动很少（截至2018年5月）。 +- pytest-bdd，是 pytest 的插件，和 behave 一样，它使用 Gherkin 功能文件和步骤定义模块，但它也利用了 pytest 的所有功能和插件。例如，它可以使用 pytest-xdist 并行运行 Gherkin 场景。 BDD 和非 BDD 测试也可以与相同的过滤器一起执行。pytest-bdd 还提供更灵活的目录布局。 +- radish 是一个 “Gherkin 增强版”框架——它将场景循环和前提条件添加到标准的 Gherkin 语言中，这使得它对程序员更友好。它还像 behave 一样提供了丰富的命令行选项。 +- lettuce 是一种较旧的 BDD 框架，与 behave 非常相似，在框架机制方面存在细微差别。然而，GitHub 最近显示该项目的活动很少（截至2018 年 5 月）。 任何这些框架都是不错的选择。 -另外，请记住，Python测试框架可用于任何黑盒测试，即使对于非Python产品也是如此！ BDD框架非常适合Web和服务测试，因为它们的测试是声明性的，而Python是一种[很好的测试自动化语言][18]。 +另外，请记住，Python 测试框架可用于任何黑盒测试，即使对于非 Python 产品也是如此！ BDD 框架非常适合 Web 和服务测试，因为它们的测试是声明性的，而 Python 是一种[很好的测试自动化语言][18]。 -本文基于作者的[PyCon Cleveland 2018][19]演讲，[行为驱动的Python][20]。 +本文基于作者的 [PyCon Cleveland 2018][19] 演讲“[行为驱动的Python][20]”。 -------------------------------------------------------------------------------- @@ -210,7 +214,7 @@ via: https://opensource.com/article/18/5/behavior-driven-python 作者：[Andrew Knight][a] 选题：[lujun9972](https://github.com/lujun9972) 译者：[Flowsnow](https://github.com/Flowsnow) -校对：[校对者ID](https://github.com/校对者ID) +校对：[wxy](https://github.com/wxy) 本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出 @@ -235,3 +239,4 @@ via: https://opensource.com/article/18/5/behavior-driven-python [18]:https://automationpanda.com/2017/01/21/the-best-programming-language-for-test-automation/ [19]:https://us.pycon.org/2018/ [20]:https://us.pycon.org/2018/schedule/presentation/87/ +[21]:https://behave.readthedocs.io/en/latest/ From 1231a82aa3af240989e2398eb2ed49f52e9bc73f Mon Sep 17 00:00:00 2001 From: "Xingyu.Wang" Date: Tue, 16 Oct 2018 18:27:40 +0800 Subject: [PATCH 2/2] PUB:20180528 What is behavior-driven Python.md @Flowsnow https://linux.cn/article-10124-1.html --- .../tech => published}/20180528 What is behavior-driven Python.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename {translated/tech => published}/20180528 What is behavior-driven Python.md (100%) diff --git a/translated/tech/20180528 What is behavior-driven Python.md b/published/20180528 What is behavior-driven Python.md similarity index 100% rename from translated/tech/20180528 What is behavior-driven Python.md rename to published/20180528 What is behavior-driven Python.md