michaelwnelson/pytracker

Simple Python API that wraps the Pivotal Tracker REST APIs.

Python APIs for Pivotal Tracker

pytracker is a simple Python API that wraps the Pivotal Tracker REST APIs.

This is a Fork

The original pytracker was developed by Doug Coker. You can view the project here.

I've forked the project because it is no longer being maintained (the last commit was Nov 30, 2010). Furthermore, when this was originally developed it was intended for use with v2 of Pivotal Tracker's API which has been disabled since January 27, 2012.

Example

Retrieve a single story

#!/usr/bin/python
try:
	from pytracker import Tracker
except ImportError:
	raise ImportError("Requires pytracker module.")

project = #YOUR PROJECT ID
token = #YOUR API TOKEN
tracker = Tracker(int(project), token)
story = tracker.GetStory(123456789)

Retrieve all stories and print the Story's ID, type, and name.

#!/usr/bin/python
try:
	from pytracker import Tracker
except ImportError:
	raise ImportError("Requires pytracker module.")

project = #YOUR PROJECT ID
token = #YOUR API TOKEN
tracker = Tracker(int(project), token)
stories = tracker.GetStories()
for story in stories:
	print "%d (%s) - %s" % (story.id, story.story_type, story.name)

A Story() has __str__ defined, so you're welcome to print story at this point. Moreover, you can access the attributes you see from print story easily: print story.id.

Contributing

• Convert from XML to JSON
• Add missing resources and endpoints
• Add create, update, delete for resources

If you would like to contribute a new feature or bug fix:

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a new Pull Request

License

Apache License 2.0