Skip to content
A Python wrapper for the Jama API
Python
Failed to load latest commit information.
examples
jama Clean up and documentation for github. Oct 9, 2013
tests
.gitignore
LICENSE Initial commit Oct 8, 2013
README.md Add syntax highlighting to readme Oct 25, 2013
requirements.txt Initial commit of python-jama project. Oct 9, 2013
setup.py

README.md

python-jama

This module offers a light-weight wrapper to the Jama api in Python.

It provides programmatic access to many features of Jama including item manipulation. The Jama api is documented at http://ws.jamasoftware.com/latest/

Basic Usage

In order to use this API you will need to have access to a Jama instance and an authenticated account.

Create a configuration file ~/.jama containing the following. Be sure to replace with your own instalation's details:

[soap]
url = http://jama.example.com/contour/ws/v3/soap/ContourSoapService?wsdl
account = <username>
password = <password>

Example to use the api to get an item from jama. The Jama Soap API documentation for getItem looks like this:

getItem(WsAuth token, java.lang.Long itemId)

The Python call to getItem simply looks like:

from jama import API
api = API()
item = api('getItem', 1234)

Note that the WsAuth token is required by all Jama api calls so is handled by python-jama. The item returned by a call to jama.api is a Suds object. See the suds documentation for more information.

An example which gets all direct child items of a particular document type:

example_leaf = Leaf(JAMA_EXAMPLE_NODE_ID, JAMA_EXAMPLE_TYPE)

example_item_generator = api.create_leaf_generator(
    example_leaf,
    ('name',
     ('event_code', 'code')
    ))

for item_dict, jamaid in example_item_generator:
    print(item_dict['name'], item_dict['code'])

Installation

pip install python-jama

or download the source package from the project page on github and run

python setup.py install

Development

Development is carried out on the github project page, patches and pull requests are most welcome!

Something went wrong with that request. Please try again.