Skip to main content
Help us improve Python packaging – donate today!

Pivotal API client library.

Project Description

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)

Release history Release notifications

This version
History Node

0.3.4

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.2.1

History Node

0.2.0

History Node

0.1.10

History Node

0.1.9

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
busyflow.pivotal-0.3.4.tar.gz (10.4 kB) Copy SHA256 hash SHA256 Source None Apr 26, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page