x/python-tuskarclient
Code Issues Proposed changes

Merge "A few tweaks for readme"

Browse Source
This commit is contained in:
Jenkins
2013-08-26 14:38:14 +00:00
committed by Gerrit Code Review
parent 710a658ede f84f2936d5
commit e3eb26281f
1 changed files with 19 additions and 11 deletions
Download Patch File Download Diff File Expand all files Collapse all files

30
README.rst
View File

@@ -2,7 +2,8 @@
python-tuskarclient
===================
python-tuskarclient is a Python client for `Tuskar <https://github.com/stackforge/tuskar>`_, which also implements a command-line interface.
python-tuskarclient is a Python client and a command-line interface
for `Tuskar <https://github.com/stackforge/tuskar>`_.
Getting Started
@@ -10,7 +11,7 @@ Getting Started
Clone the repo::
$ git clone git@github.com:tuskar/python-tuskarclient.git
$ git clone https://github.com/stackforge/python-tuskarclient.git
Then, use ``tox`` to set up a virtual environment and run tests::
@@ -21,7 +22,8 @@ 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::
Finally, use this script to build the wrapper script in your virtual
environment for the CLI tools::
$ python setup.py develop
@@ -29,22 +31,28 @@ Finally, use this script to build the wrapper script in your virtual environment
Use from Python
===============
For using ``python-tuskarclient`` within a Python application,
`this wiki page <https://github.com/tuskar/python-tuskarclient/wiki/Usage>`_ provides
the most complete documentation.
For using ``python-tuskarclient`` within a Python application, `this
wiki page <https://github.com/tuskar/python-tuskarclient/wiki/Usage>`_
provides the most complete documentation.
Use from the CLI
================
On the command line, ``python-tuskarclient`` implements the ``tuskar`` command.
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.
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::
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.)
(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.
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.