RETIRED, Python bindings and CLI to Tuskar.
Go to file
Petr Blaho 2da242b5e6 Use six.StringIO/BytesIO instead of StringIO.StringIO
to keep Python 3.x compatibility, use six.StringIO/BytesIO to
replace StringIO.StringIO

StringIO works for unicode
BytesIO works for bytes

Change-Id: Iba4087cb7a3dd6d1b24744cda0bfa5f45c94f386
Closes-Bug: #1280100
2014-02-18 11:34:18 +01:00
tools Using tox instead of tuskar_with_venv.sh script 2014-02-14 17:41:29 +02:00
tuskarclient Use six.StringIO/BytesIO instead of StringIO.StringIO 2014-02-18 11:34:18 +01:00
.coveragerc Adds .coveragerc and modify tox.ini for coverage 2013-07-09 13:49:00 +02:00
.gitignore Gitignore coverage temp files 2013-07-12 11:01:41 +02:00
.gitreview Update 'stackforge' references to 'openstack' 2013-10-07 10:07:21 +02:00
.testr.conf Basic project structure 2013-07-01 11:01:17 +02:00
.travis.yml Changes tox.ini in favor of tox and envs 2013-08-12 13:20:45 +02:00
LICENSE Basic project structure 2013-07-01 11:01:17 +02:00
MANIFEST.in Basic project structure 2013-07-01 11:01:17 +02:00
README.rst Update 'stackforge' references to 'openstack' 2013-10-07 10:07:21 +02:00
openstack-common.conf Sync common client code from Oslo 2013-12-17 15:10:01 +02:00
requirements.txt Merge "Use HTTPClient from common apiclient code" 2014-01-16 16:38:06 +00:00
setup.cfg Revert "Support building wheels (PEP-427)" 2013-11-29 13:51:27 +02:00
setup.py Remove d2to1 dependency 2013-09-30 10:44:34 -04:00
test-requirements.txt Use implicit dependencies of Hacking for pep8, pyflakes, flake8 2014-01-17 10:38:14 +01:00
tox.ini Remove tox locale overrides 2014-02-10 03:11:32 +00:00

README.rst

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/openstack/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:8585/

(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.