Metadata-Version: 2.1
Name: cumin
Version: 4.2.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+
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.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
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-Python: >=3.7
Description-Content-Type: text/x-rst
Provides-Extra: with-openstack
Provides-Extra: tests
Provides-Extra: prospector
Provides-Extra: tests-base
Provides-Extra: tests-min
License-File: LICENSE

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

|GitHub Release| |PyPI Release| |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/
.. |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
