https://github.com/openstack/python-mistralclient
Python client for Mistral REST API. Mirror of code maintained at opendev.org.
https://github.com/openstack/python-mistralclient
Last synced: about 1 year ago
JSON representation
Python client for Mistral REST API. Mirror of code maintained at opendev.org.
- Host: GitHub
- URL: https://github.com/openstack/python-mistralclient
- Owner: openstack
- License: apache-2.0
- Created: 2014-01-13T23:40:34.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2025-03-26T10:07:28.000Z (over 1 year ago)
- Last Synced: 2025-03-30T04:09:51.139Z (over 1 year ago)
- Language: Python
- Homepage: https://opendev.org/openstack/python-mistralclient
- Size: 1.41 MB
- Stars: 55
- Watchers: 14
- Forks: 23
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- Contributing: CONTRIBUTING.rst
- License: LICENSE
Awesome Lists containing this project
README
========================
Team and repository tags
========================
.. image:: https://governance.openstack.org/tc/badges/python-mistralclient.svg
:target: https://governance.openstack.org/tc/reference/tags/index.html
Mistral
=======
.. image:: https://img.shields.io/pypi/v/python-mistralclient.svg
:target: https://pypi.org/project/python-mistralclient/
:alt: Latest Version
Mistral is a workflow service. Most business processes consist of multiple
distinct interconnected steps that need to be executed in a particular
order in a distributed environment. A user can describe such a process as a set
of tasks and their transitions. After that, it is possible to upload such a
description to Mistral, which will take care of state management, correct
execution order, parallelism, synchronization and high availability.
Mistral also provides flexible task scheduling so that it can run a process
according to a specified schedule (for example, every Sunday at 4.00pm) instead
of running it immediately. In Mistral terminology such a set of tasks and
relations between them is called a workflow.
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 https://opendev.org/openstack/python-mistralclient.git
$ cd python-mistralclient
Then just run::
$ pip install -e .
or::
$ pip install -r requirements.txt
$ 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://:5000/v2.0
$ export OS_USERNAME=admin
$ export OS_TENANT_NAME=tenant
$ export OS_PASSWORD=secret
$ export OS_MISTRAL_URL=http://: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=
.. 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
Useful Links
============
* `PyPi`_ - package installation
* `Launchpad project`_ - release management
* `Blueprints`_ - feature specifications
* `Bugs`_ - issue tracking
* `Source`_
* `Specs`_
* `How to Contribute`_
.. _PyPi: https://pypi.org/project/python-mistralclient
.. _Launchpad project: https://launchpad.net/python-mistralclient
.. _Blueprints: https://blueprints.launchpad.net/python-mistralclient
.. _Bugs: https://bugs.launchpad.net/python-mistralclient
.. _Source: https://opendev.org/openstack/python-mistralclient
.. _How to Contribute: https://docs.openstack.org/infra/manual/developers.html
.. _Specs: https://specs.openstack.org/openstack/mistral-specs/
.. _Release Notes: https://docs.openstack.org/releasenotes/python-mistralclient