Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ansible-community/molecule

Molecule aids in the development and testing of Ansible content: collections, playbooks and roles
https://github.com/ansible-community/molecule

ansible ansible-dev-tools cookiecutter-ansible hacktoberfest molecule-driver pep-621 podman python supports-dot-config testinfra testing testing-framework

Last synced: 2 months ago
JSON representation

Molecule aids in the development and testing of Ansible content: collections, playbooks and roles

Host: GitHub
URL: https://github.com/ansible-community/molecule
Owner: ansible
License: mit
Created: 2015-11-18T00:13:28.000Z (almost 9 years ago)
Default Branch: main
Last Pushed: 2024-05-20T19:05:15.000Z (6 months ago)
Last Synced: 2024-05-21T07:07:09.075Z (6 months ago)
Topics: ansible, ansible-dev-tools, cookiecutter-ansible, hacktoberfest, molecule-driver, pep-621, podman, python, supports-dot-config, testinfra, testing, testing-framework
Language: Python
Homepage: https://ansible.readthedocs.io/projects/molecule/
Size: 13.4 MB
Stars: 3,818
Watchers: 112
Forks: 653
Open Issues: 74
Metadata Files:
- Readme: README.md
- Contributing: docs/contributing.md
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

awesome-ansible - Molecule - Testing of Ansible roles. (Tools)

README

        # About Ansible Molecule

[![PyPI Package](https://img.shields.io/pypi/v/molecule)](https://pypi.org/project/molecule/)

[![Documentation Status](https://readthedocs.org/projects/molecule/badge/?version=latest)](https://ansible.readthedocs.io/projects/molecule)

[![image](https://github.com/ansible-community/molecule/workflows/tox/badge.svg)](https://github.com/ansible-community/molecule/actions)

[![Python Black Code Style](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/python/black)

[![Ansible Code of Conduct](https://img.shields.io/badge/Code%20of%20Conduct-silver.svg)](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html)

[![Discussions](https://img.shields.io/badge/Discussions-silver.svg)](https://github.com/ansible-community/molecule/discussions)

[![Repository License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](LICENSE)

Molecule project is designed to aid in the development and testing of

[Ansible](https://ansible.com) 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:

```bash

molecule ...

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

```

# Documentation

Read the documentation and more at .

# Get Involved

- Join us in the `#ansible-devtools` irc channel on

  [libera.chat](https://web.libera.chat/?channel=#ansible-devtools).

- Check github

  [discussions](https://github.com/ansible-community/molecule/discussions).

- Join the community working group by checking the

  [wiki](https://github.com/ansible/community/wiki/Molecule).

- Want to know about releases, subscribe to [ansible-announce

  list](https://groups.google.com/group/ansible-announce).

- For the full list of Ansible email Lists, IRC channels see the

  [communication

  page](https://docs.ansible.com/ansible/latest/community/communication.html).

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

```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!

# Authors

Molecule project was created by [Retr0h](https://github.com/retr0h) and

it is now community-maintained as part of the

[Ansible](https://ansible.com) by Red Hat project.

# License

The

[MIT](https://github.com/ansible-community/molecule/blob/main/LICENSE)

License.

The logo is licensed under the [Creative Commons NoDerivatives 4.0

License](https://creativecommons.org/licenses/by-nd/4.0/).

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