Metadata-Version: 2.0
Name: cumin
Version: 1.3.0
Summary: Automation and orchestration framework and CLI written in Python
Home-page: https://github.com/wikimedia/cumin
Author: Riccardo Coccioli
Author-email: rcoccioli@wikimedia.org
License: GPLv3+
Description-Content-Type: UNKNOWN
Keywords: cumin,automation,orchestration
Platform: GNU/Linux
Platform: BSD
Platform: MacOSX
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: POSIX :: BSD
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2 :: Only
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Clustering
Classifier: Topic :: System :: Distributed Computing
Classifier: Topic :: System :: Systems Administration
Requires-Dist: clustershell (==1.7.3)
Requires-Dist: colorama (>=0.3.2)
Requires-Dist: pyparsing (==2.1.10)
Requires-Dist: pyyaml (>=3.11)
Requires-Dist: requests (>=2.12.0)
Requires-Dist: tqdm (>=4.11.2)
Provides-Extra: tests
Requires-Dist: bandit (>=1.1.0); extra == 'tests'
Requires-Dist: flake8 (>=3.2.1); extra == 'tests'
Requires-Dist: mock (>=2.0.0); extra == 'tests'
Requires-Dist: prospector[with_everything] (>=0.12.4); extra == 'tests'
Requires-Dist: pytest-cov (>=1.8.0); extra == 'tests'
Requires-Dist: pytest-xdist (>=1.15.0); extra == 'tests'
Requires-Dist: pytest (>=3.0.3); extra == 'tests'
Requires-Dist: requests-mock (>=0.7.0); extra == 'tests'
Requires-Dist: sphinx-rtd-theme (>=0.1.6); extra == 'tests'
Requires-Dist: sphinx-argparse (>=0.1.15); extra == 'tests'
Requires-Dist: Sphinx (>=1.4.9); extra == 'tests'
Requires-Dist: vulture (<0.25,>=0.6); extra == 'tests'
Requires-Dist: keystoneauth1 (>=2.4.1); extra == 'tests'
Requires-Dist: python-keystoneclient (>=2.3.1); extra == 'tests'
Requires-Dist: python-novaclient (>=3.3.1); extra == 'tests'
Provides-Extra: tests-base
Requires-Dist: bandit (>=1.1.0); extra == 'tests-base'
Requires-Dist: flake8 (>=3.2.1); extra == 'tests-base'
Requires-Dist: mock (>=2.0.0); extra == 'tests-base'
Requires-Dist: prospector[with_everything] (>=0.12.4); extra == 'tests-base'
Requires-Dist: pytest-cov (>=1.8.0); extra == 'tests-base'
Requires-Dist: pytest-xdist (>=1.15.0); extra == 'tests-base'
Requires-Dist: pytest (>=3.0.3); extra == 'tests-base'
Requires-Dist: requests-mock (>=0.7.0); extra == 'tests-base'
Requires-Dist: sphinx-rtd-theme (>=0.1.6); extra == 'tests-base'
Requires-Dist: sphinx-argparse (>=0.1.15); extra == 'tests-base'
Requires-Dist: Sphinx (>=1.4.9); extra == 'tests-base'
Requires-Dist: vulture (<0.25,>=0.6); extra == 'tests-base'
Provides-Extra: tests-min
Requires-Dist: bandit (==1.1.0); extra == 'tests-min'
Requires-Dist: flake8 (==3.2.1); extra == 'tests-min'
Requires-Dist: mock (==2.0.0); extra == 'tests-min'
Requires-Dist: prospector[with_everything] (==0.12.4); extra == 'tests-min'
Requires-Dist: pytest-cov (==1.8.0); extra == 'tests-min'
Requires-Dist: pytest-xdist (==1.15.0); extra == 'tests-min'
Requires-Dist: pytest (==3.0.3); extra == 'tests-min'
Requires-Dist: requests-mock (==0.7.0); extra == 'tests-min'
Requires-Dist: sphinx-rtd-theme (==0.1.6); extra == 'tests-min'
Requires-Dist: sphinx-argparse (==0.1.15); extra == 'tests-min'
Requires-Dist: Sphinx (==1.4.9); extra == 'tests-min'
Requires-Dist: vulture (<0.25,==0.6); extra == 'tests-min'
Requires-Dist: keystoneauth1 (==2.4.1); extra == 'tests-min'
Requires-Dist: python-keystoneclient (==2.3.1); extra == 'tests-min'
Requires-Dist: python-novaclient (==3.3.1); extra == 'tests-min'
Provides-Extra: with-openstack
Requires-Dist: keystoneauth1 (>=2.4.1); extra == 'with-openstack'
Requires-Dist: python-keystoneclient (>=2.3.1); extra == 'with-openstack'
Requires-Dist: python-novaclient (>=3.3.1); extra == 'with-openstack'

Cumin - An automation and orchestration framework
-------------------------------------------------

|GitHub Release| |PyPI Release| |Build Status| |Coveralls Coverage| |Codcov Coverage| |Codacy| |License|

Cumin provides a flexible and scalable automation framework to execute multiple commands on multiple hosts in parallel.

It allows to easily perform complex selections of hosts through a user-friendly query language which can interface
with different backend modules and combine their results for a fine grained selection. The transport layer can also be
selected, and can provide multiple execution strategies. The executed commands outputs are automatically grouped for an
easy-to-read result.

It can be used both via its command line interface (CLI) `cumin` and as a Python 2 library. Python 3 support will be
added soon, as the last dependency that was Python 2 only added support for Python 3 recently.

|Cumin GIF|

The documentation is available on `Wikimedia Documentation`_ and `Read the Docs`_. The details on how Cumin it's used
at the Wikimedia Foundation are available on `Wikitech`_.


.. |GitHub Release| image:: https://img.shields.io/github/release/wikimedia/cumin.svg
   :target: https://github.com/wikimedia/cumin/releases
.. |PyPI Release| image:: https://img.shields.io/pypi/v/cumin.svg
   :target: https://pypi.python.org/pypi/cumin
.. |Build Status| image:: https://travis-ci.org/wikimedia/cumin.svg?branch=master
   :target: https://travis-ci.org/wikimedia/cumin
.. |Coveralls Coverage| image:: https://coveralls.io/repos/github/wikimedia/cumin/badge.svg?branch=master
   :target: https://coveralls.io/github/wikimedia/cumin
.. |Codcov Coverage| image:: https://codecov.io/github/wikimedia/cumin/coverage.svg?branch=master
   :target: https://codecov.io/github/wikimedia/cumin
.. |Codacy| image:: https://api.codacy.com/project/badge/Grade/73d9a429dc7343eb935471bf05826fc0
   :target: https://www.codacy.com/app/volans-/cumin
.. |License| image:: https://img.shields.io/badge/license-GPLv3%2B-blue.svg
   :target: https://github.com/wikimedia/cumin/blob/master/LICENSE
.. |Cumin GIF| image:: https://people.wikimedia.org/~volans/cumin.gif

.. _`Read the Docs`: https://cumin.readthedocs.io
.. _`Wikimedia Documentation`: https://doc.wikimedia.org/cumin
.. _`Wikitech`: https://wikitech.wikimedia.org/wiki/Cumin


