Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ansible/molecule
Molecule aids in the development and testing of Ansible content: collections, playbooks and roles
https://github.com/ansible/molecule
ansible ansible-dev-tools cookiecutter-ansible hacktoberfest molecule-driver pep-621 podman python supports-dot-config testinfra testing testing-framework
Last synced: 2 days ago
JSON representation
Molecule aids in the development and testing of Ansible content: collections, playbooks and roles
- Host: GitHub
- URL: https://github.com/ansible/molecule
- Owner: ansible
- License: mit
- Created: 2015-11-18T00:13:28.000Z (about 9 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T14:05:43.000Z (about 1 month ago)
- Last Synced: 2024-10-29T14:55:41.718Z (about 1 month 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: 14 MB
- Stars: 3,877
- Watchers: 112
- Forks: 662
- Open Issues: 69
-
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
- stars - ansible/molecule
- awesome-list-docker - molecule
- awesome-list-ansible - molecule
- awesome-modern-devops - Molecule - Test Ansible roles. (IaC)
- awesome-repositories - ansible/molecule - Molecule aids in the development and testing of Ansible content: collections, playbooks and roles (Python)
README
# About Ansible Molecule
[](https://pypi.org/project/molecule/)
[](https://ansible.readthedocs.io/projects/molecule)
[](https://github.com/ansible-community/molecule/actions)
[](https://github.com/python/black)
[](https://docs.ansible.com/ansible/latest/community/code_of_conduct.html)
[](https://forum.ansible.com/tag/molecule)
[](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
See the [Talk to us](https://ansible.readthedocs.io/projects/molecule/contributing/#talk-to-us) section of the documentation to ask questions, find help, and join the conversation.
For complete details, see the
[Ansible communication guide](https://docs.ansible.com/ansible/devel/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.