busyflow.pivotal 0.3.1

Pivotal API client library.

Simple example

If you don’t have a token, get one using username and password (or just pass it directly):

>>> client = PivotalClient(token=None, cache='path/to/cache')
>>> token = client.token.active('username', 'password')['token']['guid']

>>> client.token = token

Get some projects:

>>> projects = client.projects.all()['projects']

Get current stories for a project:

>>> iterations = client.iterations.current(projects[0]['id'])

>>> storries_in_current_iteration = iterations[0]['iteration']['stories']

This should probably be client.projects.iterations.current(), but using flat structure at the moment.

Missing methods and endpoints

Members:

GET http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/memberships
POST http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/memberships
GET http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/memberships/$MEMBERSHIP_ID
DELETE http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/memberships/$MEMBERSHIP_ID

Project:

POST http://www.pivotaltracker.com/services/v3/projects - missing parameters
PUT http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/stories/deliver_all_finished

Tasks:

GET http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/stories/$STORY_ID/tasks/$TASK_ID
GET http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/stories/$STORY_ID/tasks
POST http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/stories/$STORY_ID/tasks?task\[description\]=clean%20shields
PUT http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/stories/$STORY_ID/tasks/$TASK_ID
DELETE http://www.pivotaltracker.com/services/v3/projects/$PROJECT_ID/stories/$STORY_ID/tasks/$TASK_ID

(TODO find out whether it is possible to pass parameters to stories/projects throught URL)