back to home

geerlingguy / molecule

Molecule aids in the development and testing of Ansible roles

4 stars
3 forks
0 issues
PythonDockerfileShell
Chat with CodebaseArchitecture ScanSecurity AuditExplain Codebase

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing geerlingguy/molecule in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Click here to launch the interactive analysis workspace

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind-ai.vercel.app/repo/geerlingguy/molecule)
Preview:Analyzed by RepoMind

Repository Summary (README)

Preview

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://zuul-ci.org/gated.svg :target: https://dashboard.zuul.ansible.com/t/ansible/builds?project=ansible-community/molecule

.. 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 ...
mol ...  # same as above, introduced in 3.0.5
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-molecule channel on Freenode_.
  • 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!

.. _Freenode: https://freenode.net .. _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/master/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/