Metadata-Version: 2.1
Name: molecule
Version: 4.0.4
Summary: Molecule aids in the development and testing of Ansible roles
Home-page: https://github.com/ansible-community/molecule
Author: Ansible by Red Hat
Author-email: info@ansible.com
Maintainer: Ansible by Red Hat
Maintainer-email: info@ansible.com
License: MIT
Project-URL: Bug Tracker, https://github.com/ansible-community/molecule/issues
Project-URL: Release Management, https://github.com/ansible-community/molecule/releases
Project-URL: CI, https://github.com/ansible-community/molecule/actions
Project-URL: Code of Conduct, https://docs.ansible.com/ansible/latest/community/code_of_conduct.html
Project-URL: Documentation, https://molecule.readthedocs.io
Project-URL: Discussions, https://github.com/ansible-community/molecule/discussions
Project-URL: Source Code, https://github.com/ansible-community/molecule
Keywords: ansible,roles,testing,molecule
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
License-File: LICENSE
Requires-Dist: ansible-compat (>=2.2.0)
Requires-Dist: click (<9,>=8.0)
Requires-Dist: click-help-colors (>=0.9)
Requires-Dist: cookiecutter (>=1.7.3)
Requires-Dist: enrich (>=1.2.7)
Requires-Dist: jsonschema (>=4.9.1)
Requires-Dist: Jinja2 (>=2.11.3)
Requires-Dist: packaging
Requires-Dist: pluggy (<2.0,>=0.7.1)
Requires-Dist: PyYAML (>=5.1)
Requires-Dist: rich (>=9.5.1)
Provides-Extra: docker
Requires-Dist: molecule-docker (>=1.0.0) ; extra == 'docker'
Provides-Extra: docs
Requires-Dist: ansible-core (>=2.12.0) ; extra == 'docs'
Requires-Dist: jinja2 (<3.2.0) ; extra == 'docs'
Requires-Dist: Sphinx (<6.0.0,>=5.0.0) ; extra == 'docs'
Requires-Dist: simplejson (>=3.17.2) ; extra == 'docs'
Requires-Dist: sphinx-ansible-theme (<0.10.0,>=0.8.0) ; extra == 'docs'
Requires-Dist: sphinx-notfound-page (>=0.7.1) ; extra == 'docs'
Provides-Extra: lint
Requires-Dist: check-jsonschema (>=0.18.3) ; extra == 'lint'
Requires-Dist: flake8 (>=3.8.4) ; extra == 'lint'
Requires-Dist: jsonschema (>=4.16.0) ; extra == 'lint'
Requires-Dist: pre-commit (>=2.10.1) ; extra == 'lint'
Requires-Dist: yamllint ; extra == 'lint'
Provides-Extra: podman
Requires-Dist: molecule-podman (>=1.0.1) ; extra == 'podman'
Provides-Extra: test
Requires-Dist: ansi2html (>=1.6.0) ; extra == 'test'
Requires-Dist: coverage (>=6.2) ; extra == 'test'
Requires-Dist: filelock ; extra == 'test'
Requires-Dist: pexpect (<5,>=4.8.0) ; extra == 'test'
Requires-Dist: pytest-cov (>=2.10.1) ; extra == 'test'
Requires-Dist: pytest-html (>=3.0.0) ; extra == 'test'
Requires-Dist: pytest-mock (>=3.3.1) ; extra == 'test'
Requires-Dist: pytest-plus (>=0.2) ; extra == 'test'
Requires-Dist: pytest-testinfra (>=6.1.0) ; extra == 'test'
Requires-Dist: pytest-xdist (>=2.1.0) ; extra == 'test'
Requires-Dist: pytest (>=6.1.2) ; extra == 'test'
Provides-Extra: windows
Requires-Dist: pywinrm ; extra == 'windows'

****************
Ansible Molecule
****************

.. image:: https://img.shields.io/pypi/v/molecule
   :target: https://pypi.org/project/molecule/
   :alt: PyPI Package

.. image:: https://readthedocs.org/projects/molecule/badge/?version=latest
   :target: https://molecule.readthedocs.io/en/latest/
   :alt: Documentation Status

.. image:: https://github.com/ansible-community/molecule/workflows/tox/badge.svg
   :target: https://github.com/ansible-community/molecule/actions

.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/python/black
   :alt: Python Black Code Style

.. image:: https://img.shields.io/badge/Code%20of%20Conduct-silver.svg
   :target: https://docs.ansible.com/ansible/latest/community/code_of_conduct.html
   :alt: Ansible Code of Conduct

.. image:: https://img.shields.io/badge/Discussions-silver.svg
   :target: https://github.com/ansible-community/molecule/discussions
   :alt: Discussions

.. image:: https://img.shields.io/badge/license-MIT-brightgreen.svg
   :target: LICENSE
   :alt: Repository License

About Ansible Molecule
======================

Molecule project is designed to aid in the development and testing of
`Ansible`_ roles.

Molecule provides support for testing with multiple instances, operating
systems and distributions, virtualization providers, test frameworks and
testing scenarios.

Molecule encourages an approach that results in consistently developed roles
that are well-written, easily understood and maintained.

Molecule supports only the latest two major versions of Ansible (N/N-1),
meaning that if the latest version is 2.9.x, we will also test our code with
2.8.x.

Once installed, the command line can be called using any of the methods below:

.. code-block:: bash

    molecule ...
    python3 -m molecule ...  # python module calling method

.. _`Ansible`: https://ansible.com

.. _documentation:

Documentation
=============

Read the documentation and more at https://molecule.readthedocs.io/.

.. _get-involved:

Get Involved
============

* Join us in the ``#ansible-devtools`` irc channel on `libera.chat`_.
* Check github `discussions`_.
* Join the community working group by checking the `wiki`_.
* Want to know about releases, subscribe to `ansible-announce list`_.
* For the full list of Ansible email Lists, IRC channels see the
  `communication page`_.

If you want to get moving fast and make a quick patch:

.. code-block:: bash

    $ git clone https://github.com/ansible-community/molecule && cd molecule
    $ python3 -m venv .venv && source .venv/bin/activate
    $ python3 -m pip install -U setuptools pip tox

And you're ready to make your changes!

.. _`libera.chat`: https://web.libera.chat/?channel=#ansible-devtools
.. _`discussions`: https://github.com/ansible-community/molecule/discussions
.. _`wiki`: https://github.com/ansible/community/wiki/Molecule
.. _`ansible-announce list`: https://groups.google.com/group/ansible-announce
.. _`communication page`: https://docs.ansible.com/ansible/latest/community/communication.html

.. _authors:

Authors
=======

Molecule project was created by `Retr0h <https://github.com/retr0h>`_ and it is
now community-maintained as part of the `Ansible`_ by Red Hat project.

.. _license:

License
=======

The `MIT`_ License.

.. _`MIT`: https://github.com/ansible-community/molecule/blob/main/LICENSE

The logo is licensed under the `Creative Commons NoDerivatives 4.0 License`_.

If you have some other use in mind, contact us.

.. _`Creative Commons NoDerivatives 4.0 License`: https://creativecommons.org/licenses/by-nd/4.0/
