Package: corejet.pivotal
CoreJet test runner Pivotal Tracker integrationThis package provides a requirements catalogue source forcorejet.testrunnerthat can fetch requirements from Pivotal Tracker.To use it, make sure it is installed in the working set of the testrunner. If
using Buildout, you can do this with:[test]
recipe = corejet.recipe.testrunner
eggs =
    corejet.pivotal
    <other packages>
defaults = ['--auto-color', '--auto-progress']Here is an example command line invocation:./bin/test -s corejet.core --corejet="pivotal,token=mypivotaltoken,project=123456,filter=myepickeyword"The--corejetoption must start withpivotal,followed by a set of
parameters that indicate how to connect to Pivotal Tracker. The parameters are:<epic>,<epic>,...optional pivotal.cfg section names to retrieve options per epictoken=<token>defaultPivotal tokento use in authenticationproject=<project>default Pivotal project id to retrieve stories fromfilter=<filter>defaultPivotal filterstring to retrieve stories for this epictitle=<title>optional requirements catalog title (defaults to the first found Pivotal
project title)Pivotal stories matching project and filter options may contain scenarios in
simple Gherkin syntax in their description field, e.g.: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 expectedThe parser is relatively forgiving, but note:The parser is case-insensitiveZero or more scenarios may be presentScenarios must start with “Scenario: “ followed by a nameThe “Given” clause is optional, but must come first in a scenarioThe “When” clause is required, and must come before the “Then” clauseThe “Then”” clause is also requiredAn “And” or “But” clause can come after any “Given”, “When” or “Then”, but
not first.Please, note thatfilterwill includeincludedone:trueimplicitly when
it’s not explicitly set tofalse.Optionalpivotal.cfgwhich is looked at first the current working directory
upwards (or from~/.pivotalrc) may be an INI-style config file describing
key value pairs within sections (specialdefaults-section is supported for
defining defaults).You may define several epics, for example, with the following setup:~/.pivotalrc:[defaults]
token = mysecretpivotaltrackertoken./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:anotherlabelExecute CoreJet with:./bin/test  --corejet="pivotal,first-epic,another-epic"It’s also possible to define list of epic-sections in[defaults]withepics =first-epic,another-epicand run tests with--corejet=pivotal.Packagecorejet.coreincludes XSLT to generate test skeletons in Python from
corejet.xml, e.g.:xsltproc eggs/corejet.core-1.0.0-py2.6.egg/corejet/core/xslt/corejet-to-python.xsl parts/test/corejet/corejet.xmlInstall experimentalbin/pivotaltool by adding the following part into
yourbuildout.cfg:[buildout]
parts += scripts

[scripts]
recipe = zc.recipe.egg
eggs = corejet.pivotalChangelog1.2.0 (2012-10-18)Fixed stories to always have a minimum size of 1 point.1.1.0 (2012-10-18)Fixed to not crash on story parsing error, but print url of the failing
story instead.1.0.0 (2012-05-26)Added support for config files and possibility to define epics using them.Changed scenarios parsed from tasks to be parsed only after parsing
description (to allow definition of story-level steps in description).1.0a5 (2011-08-28)Added support for tasks: If a story has tasks, their descriptions will be
parsed for scenarios (and those will be appended) before parsing story’s main
description.1.0a4 (2011-08-26)Fixed to replace every “ with ‘ before parsing scenario descriptions. If “s
were allowed to let through, those should be escaped in test decorators,
which would look ugly.1.0a3 (2011-08-02)Fixed package info to match with other corejet packages.1.0a2 (2011-08-02)Connected Pivotal estimates to CoreJet points.Added filter for stories with no scenarios.1.0a1 (2011-08-01)First release.