corejet.pivotal 1.2.0

CoreJet 测试运行器 Pivotal Tracker 集成

此包为corejet.testrunner提供了一个需求目录源，可以从 Pivotal Tracker 获取需求。

要使用它，请确保它已安装到测试运行器的工作集中。如果使用 Buildout，您可以使用以下命令来完成此操作：

[test]
recipe = corejet.recipe.testrunner
eggs =
    corejet.pivotal
    <other packages>
defaults = ['--auto-color', '--auto-progress']

以下是一个示例命令行调用

./bin/test -s corejet.core --corejet="pivotal,token=mypivotaltoken,project=123456,filter=myepickeyword"

必须以 --corejet 选项开始，后跟一组参数，指示如何连接到 Pivotal Tracker。这些参数是

<epic>,<epic>,...

可选的 pivotal.cfg 部分名称，用于按 epic 获取选项

token=<token>

默认的 Pivotal token 用于身份验证

project=<project>

默认的 Pivotal 项目 ID，用于检索故事

filter=<filter>

默认的 Pivotal filter 字符串，用于检索此 epic 的故事

title=<title>

可选的需求目录标题（默认为第一个找到的 Pivotal 项目标题）

Pivotal stories 匹配项目过滤选项，其描述字段中可能包含简单 Gherkin 语法中的场景，例如

Scenario: First scenario
Given a precondition
  And another precondition
When something happens
  And something else happens
Then a result is expected
  And another result is expected

Scenario: Second scenario
Given another precondition
When something else happens
Then a different result is expected

解析器相对宽容，但请注意

• 解析器不区分大小写

• 可能存在零个或多个场景

• 场景必须以“Scenario:”开头，后跟一个名称

• “Given”子句是可选的，但必须位于场景的第一位

• “When”子句是必需的，且必须位于“Then”子句之前

• “Then”子句也是必需的

• “And”或“But”子句可以跟在任何“Given”、“When”或“Then”子句之后，但不能是第一个。

请注意，filter 将隐式包含 includedone:true，除非显式设置为 false。

可选的 pivotal.cfg 文件，该文件首先在当前工作目录及其上级目录（或从 ~/.pivotalrc）中查找，可能是一个描述段落内键值对的 INI 风格配置文件（支持用于定义默认值的特殊 defaults-段落）。

您可以使用以下设置定义多个史诗，例如：

1. ~/.pivotalrc:

   [defaults]
   token = mysecretpivotaltrackertoken

2. ./pivotal.cfg:

   [defaults]
   title = My project
   project = 123456
   
   [first-epic]
   title = A component for my project
   filter = label:firstlabel
   
   [another-epic]
   title = An another component for my project
   filter = label:anotherlabel

3. 使用以下命令执行 CoreJet：

   ./bin/test  --corejet="pivotal,first-epic,another-epic"

您还可以在 [defaults] 中定义史诗段落的列表，例如 epics = first-epic,another-epic，并使用 --corejet=pivotal 运行测试。

软件包 corejet.core 包含 XSLT，可以从 corejet.xml 生成 Python 测试骨架，例如。

xsltproc eggs/corejet.core-1.0.0-py2.6.egg/corejet/core/xslt/corejet-to-python.xsl parts/test/corejet/corejet.xml

通过在您的 buildout.cfg 中添加以下部分来安装实验性的 bin/pivotal 工具：

[buildout]
parts += scripts

[scripts]
recipe = zc.recipe.egg
eggs = corejet.pivotal

变更日志