python-tuskarclient/README.rst
Jiri Stransky f84f2936d5 A few tweaks for readme
* Reword the intro sentence to make CLI sound equally important as
  Python client :)

* Change clone url from tuskar org to stackforge org and change it to
  https, because ssh cloning requires the user to have a Github
  account.

* Format paragraphs to keep line length under 72 chars.

Change-Id: I07ab9a89076153691b75ba40aa569c59284e84dc
2013-08-26 12:56:16 +02:00

1.5 KiB

python-tuskarclient

python-tuskarclient is a Python client and a command-line interface for Tuskar.

Getting Started

Clone the repo:

$ git clone https://github.com/stackforge/python-tuskarclient.git

Then, use tox to set up a virtual environment and run tests:

$ cd python-tuskarclient
$ tox

When this is done, activate your virtual environment:

$ source .tox/py27/bin/activate

Finally, use this script to build the wrapper script in your virtual environment for the CLI tools:

$ python setup.py develop

Use from Python

For using python-tuskarclient within a Python application, this wiki page provides the most complete documentation.

Use from the CLI

On the command line, python-tuskarclient implements the tuskar command.

First, be sure to run all of the steps in the Getting Started section, above, and that you have not deactivated your virtual environment.

Then, export these two environment variables, customizing them if necessary:

$ export OS_AUTH_TOKEN=nopass
$ export TUSKAR_URL=http://localhost:6385/

(Note that 'nopass' is the correct value in a default setup with no authentication.)

Now you may interact with Tuskar by using the tuskar command. tuskar --help with list full usage details. You can use tuskar rack-list as an example.