Metadata-Version: 2.1
Name: cumin
Version: 4.0.0rc1
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+
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 :: 3.7
Classifier: Programming Language :: Python :: 3 :: Only
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.9,>=1.8.1)
Requires-Dist: pyparsing (<=2.3,>=2.2.0)
Requires-Dist: pyyaml (>=3.13)
Requires-Dist: requests (>=2.21.0)
Requires-Dist: tqdm (<=4.24.0,>=4.19.4)
Provides-Extra: tests
Requires-Dist: bandit (>=1.5.1) ; extra == 'tests'
Requires-Dist: flake8 (>=3.6.0) ; extra == 'tests'
Requires-Dist: flake8-import-order (>=0.18.1) ; extra == 'tests'
Requires-Dist: prospector[with_everything] (>=1.1.7) ; extra == 'tests'
Requires-Dist: pytest-cov (>=2.6.0) ; extra == 'tests'
Requires-Dist: pytest-xdist (>=1.26.1) ; extra == 'tests'
Requires-Dist: pytest (>=3.10.1) ; extra == 'tests'
Requires-Dist: requests-mock (>=1.5.2) ; extra == 'tests'
Requires-Dist: sphinx-rtd-theme (>=0.4.3) ; extra == 'tests'
Requires-Dist: sphinx-argparse (>=0.2.2) ; extra == 'tests'
Requires-Dist: Sphinx (>=1.8.4) ; extra == 'tests'
Requires-Dist: keystoneauth1 (>=3.10.0) ; extra == 'tests'
Requires-Dist: python-keystoneclient (>=3.17.0) ; extra == 'tests'
Requires-Dist: python-novaclient (>=11.0.0) ; extra == 'tests'
Provides-Extra: tests-base
Requires-Dist: bandit (>=1.5.1) ; extra == 'tests-base'
Requires-Dist: flake8 (>=3.6.0) ; extra == 'tests-base'
Requires-Dist: flake8-import-order (>=0.18.1) ; extra == 'tests-base'
Requires-Dist: prospector[with_everything] (>=1.1.7) ; extra == 'tests-base'
Requires-Dist: pytest-cov (>=2.6.0) ; extra == 'tests-base'
Requires-Dist: pytest-xdist (>=1.26.1) ; extra == 'tests-base'
Requires-Dist: pytest (>=3.10.1) ; extra == 'tests-base'
Requires-Dist: requests-mock (>=1.5.2) ; extra == 'tests-base'
Requires-Dist: sphinx-rtd-theme (>=0.4.3) ; extra == 'tests-base'
Requires-Dist: sphinx-argparse (>=0.2.2) ; extra == 'tests-base'
Requires-Dist: Sphinx (>=1.8.4) ; extra == 'tests-base'
Provides-Extra: tests-min
Requires-Dist: bandit (==1.5.1) ; extra == 'tests-min'
Requires-Dist: flake8 (==3.6.0) ; extra == 'tests-min'
Requires-Dist: flake8-import-order (==0.18.1) ; extra == 'tests-min'
Requires-Dist: prospector[with_everything] (==1.1.7) ; extra == 'tests-min'
Requires-Dist: pytest-cov (==2.6.0) ; extra == 'tests-min'
Requires-Dist: pytest-xdist (==1.26.1) ; extra == 'tests-min'
Requires-Dist: pytest (==3.10.1) ; extra == 'tests-min'
Requires-Dist: requests-mock (==1.5.2) ; extra == 'tests-min'
Requires-Dist: sphinx-rtd-theme (==0.4.3) ; extra == 'tests-min'
Requires-Dist: sphinx-argparse (==0.2.2) ; extra == 'tests-min'
Requires-Dist: Sphinx (==1.8.4) ; extra == 'tests-min'
Requires-Dist: keystoneauth1 (==3.10.0) ; extra == 'tests-min'
Requires-Dist: python-keystoneclient (==3.17.0) ; extra == 'tests-min'
Requires-Dist: python-novaclient (==11.0.0) ; extra == 'tests-min'
Provides-Extra: with-openstack
Requires-Dist: keystoneauth1 (>=3.10.0) ; extra == 'with-openstack'
Requires-Dist: python-keystoneclient (>=3.17.0) ; extra == 'with-openstack'
Requires-Dist: python-novaclient (>=11.0.0) ; 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 3 only library.
Cumin was Python 2 only before the 3.0.0 release, due to ClusterShell not yet being Python 3 compatible.


|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.org/project/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


