Skip to main content

Pivotal Tracker data source for corejet.testrunner

Project description

CoreJet test runner Pivotal Tracker integration

This package provides a requirements catalogue source for corejet.testrunner that 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.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 --corejet option must start with pivotal, followed by a set of parameters that indicate how to connect to Pivotal Tracker. The parameters are:

token=<token>

Pivotal token to use to authenticate

project=<project>

Pivotal project id to retrieve stories from

filter=<filter>

Pivotal filter string to retrieve stories for this epic

title=<title>

optional requirements catalog title (defaults to 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 expected

The parser is relatively forgiving, but note:

  • The parser is case-insensitive

  • Zero or more scenarios may be present

  • Scenarios must start with “Scenario: “ followed by a name

  • The “Given” clause is optional, but must come first in a scenario

  • The “When” clause is required, and must come before the “Then” clause

  • The “Then”” clause is also required

  • An “And” clause can come after any “Given”, “When” or “Then”, but not first.

Package corejet.core includes XSLT to generate test skeletons in Python from corejet.xml, e.g.:

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

Changelog

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

corejet.pivotal-1.0a5.zip (9.6 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page