Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Python toolkit for Agile Central (Rally) REST API

Project description

This is the README file for pyral, a package implementing a
Pythonic interface to the Agile Central (formerly Rally) REST API


The Rally REST Tookit for Python consists of a package that provides a means
to interact with entities and artifacts in your Rally subscription. The full
spectrum of CRUD operations is available in your Agile Central (Rally) Workspaces and Projects,
providing of course that your Agile Central (Rally) subscription credentials enable you to perform
those operations. The toolkit insulates the package user from having to make
multiple requests to obtain the full set of qualifying items by performing any
subsequent "page" requests automatically.
An additional key feature is the ability to obtain entity sub fields
that may be references or collections via the familiar dot '.' notation.


The pyral package requires the use of Kenneth Reitz's requests package using version 2.8.0 or better.
As of requests version 2.0.0, there is support for HTTPS over HTTP proxy via the CONNECT request.
The requests package can be found via the Python Package Index site (http://pypi/
The most recent release of pyral (1.4.2) has been tested with requests 2.19.1.
The six module is also required.


If you want to pull down the latest release from standard Python package repository
( and install the package, the easiest way is to use
pip, the Python package installation utility.::

pip install pyral

Alternatively if you've got the tar.gz or zip distribution on hand, as long as you've
satisfied the dependency requirements on the six and requests packages, you can use
the setup mechanism.
Once requests and six has been installed, run the program supplied with
this distribution as::

python install


Copy the template.cfg file to a file named my.cfg.
Edit my.cfg. Uncomment and replace the values for SERVER, USER, PASSWORD.
Leave the WORKSPACE and PROJECT entries commented out for now.

Run the program as:

$ python --config=my.cfg


Obtain the zip file containing the HTML and CSS files comprising the document set for pyral.
Unzip in a suitable location and point your web browser to the doc/build/html/index.html file.

The rendered documentation is also available at

Project details

Download files

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

Files for pyral, version 1.4.2
Filename, size File type Python version Upload date Hashes
Filename, size pyral-1.4.2-py2.py3-none-any.whl (77.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size pyral-1.4.2.tar.gz (973.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page