Python client for Mistral REST API.
Go to file
Lingxian Kong a5e1e73e83 Show exact error message when authentication falied instead of HTML body
When using pecan.abort() on server side, client side will see response
bodies for HTTP errors, which is not readable for end users.

This patch will let mistral client extract error message from header
returned by mistral serivce, currently, it's only used for
authentication failure.

Closes-Bug: #1502840
Change-Id: I20a7f845676ffe23d93334d171332d717994d937
2015-10-08 18:21:59 +08:00
doc/source Remove unneeded definitions of Python Source Code Encoding 2014-07-31 15:26:15 +02:00
functionaltests Changing check of mistral availability in functional tests 2015-07-20 09:30:00 +00:00
mistralclient Show exact error message when authentication falied instead of HTML body 2015-10-08 18:21:59 +08:00
tools Mistral bash completion script optimization 2015-05-20 21:32:07 +08:00
.gitignore Fixing launching mistralclient tests 2015-07-11 14:11:10 +03:00
.gitreview Update .gitreview file for project rename 2015-06-12 23:12:30 +00:00
AUTHORS Fixing dict ordering issue in task tests 2015-08-18 18:42:33 +06:00
functional_creds.conf.sample Fixing launching mistralclient tests 2015-07-11 14:11:10 +03:00
LICENSE Moving Mistral Client code from main Mistral repository 2014-01-17 07:15:03 -08:00
openstack-common.conf Remove the log module and all dependencies 2014-06-04 10:42:49 +10:00
README.md Update README.md for project namespace and repo change 2015-08-18 06:06:29 +00:00
requirements.txt Updated from global requirements 2015-09-17 12:16:50 +00:00
run_functional_tests.sh Add script to run functional CLI and client tests locally 2014-09-30 13:17:58 +04:00
setup.cfg Add python 3 classifiers 2015-08-05 13:35:20 +05:30
setup.py Updated from global requirements 2015-09-17 12:16:50 +00:00
test-requirements.txt Updated from global requirements 2015-10-02 17:20:34 +00:00
tox.ini Fixing launching mistralclient tests 2015-07-11 14:11:10 +03:00

Mistral client

Python client for Mistral REST API. Includes python library for Mistral API and Command Line Interface (CLI) library.

Installation

First of all, clone the repo and go to the repo directory:

git clone git://git.openstack.org/openstack/python-mistralclient.git
cd python-mistralclient

Then just run:

pip install -e .

or

python setup.py install

Running Mistral client

If Mistral authentication is enabled, provide the information about OpenStack auth to environment variables. Type:

export OS_AUTH_URL=http://<Keystone_host>:5000/v2.0
export OS_USERNAME=admin
export OS_TENANT_NAME=tenant
export OS_PASSWORD=secret
export OS_MISTRAL_URL=http://<Mistral host>:8989/v2  (optional, by default URL=http://localhost:8989/v2)

and in the case that you are authenticating against keystone over https:

export OS_CACERT=<path_to_ca_cert>

Note: In client, we can use both Keystone auth versions - v2.0 and v3. But server supports only v3.

To make sure Mistral client works, type:

mistral workbook-list

You can see the list of available commands typing:

mistral --help