
Oslo common code contains HTTPClient class which handles sending HTTP requests to OpenStack servers. It also can handle authentication, logging and so on. So we can use features from common apiclient instead of tuskarclient implementation. Inherited tuskar's HTTPClient from common HTTPClient, removed duplicated methods, modified _http_request() method to use request() method from common HTTPClient. Removed VerifiedHTTPSConnection class - we should use a similar functionality from common HTTPClient. Changed an exception processing - `requests` module (which is used in common code) keeps status in response `status_code` attribute instead of `status`. So we should use `response.status_code` in from_response() function from tuskarclient.exc module to get response status. Added missed requirement - stevedore>=0.12. It's used in apiclient.auth, module (which is used in tuskarclient.common.http). Removed unused code from test_http module. Change-Id: Ib731187661a409a036931aa213278ca9b03a3519
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.