Skip to main content

About Ansible Molecule

PyPI Package Documentation Status image Python Black Code Style Ansible Code of Conduct Discussions Repository License

Molecule is an Ansible testing framework designed for developing and testing Ansible collections, playbooks, and roles.

Molecule leverages standard Ansible features including inventory, playbooks, and collections to provide flexible testing workflows. Test scenarios can target any system or service reachable from Ansible, from containers and virtual machines to cloud infrastructure, hyperscaler services, APIs, databases, and network devices. Molecule can also validate inventory configurations and dynamic inventory sources.

Molecule encourages an approach that results in consistently developed Ansible content that is well-written, easily understood and maintained.

Molecule supports only the latest two major versions of Ansible (N/N-1).

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

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

Documentation

Read the documentation and more at https://docs.ansible.com/projects/molecule//.

Get Involved

See the Talk to us section of the documentation to ask questions, find help, and join the conversation.

For complete details, see the Ansible communication guide.

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

git clone https://github.com/ansible/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 and it is now community-maintained as part of the Ansible by Red Hat project.

License

The MIT License.

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

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

molecule-26.8.0.tar.gz (4.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

molecule-26.8.0-py3-none-any.whl (163.0 kB view details)

Uploaded Python 3

File details

Details for the file molecule-26.8.0.tar.gz.

File metadata

  • Download URL: molecule-26.8.0.tar.gz
  • Upload date:
  • Size: 4.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for molecule-26.8.0.tar.gz
Algorithm Hash digest
SHA256 506a0a0416683f4e404a42ce8c56a980cd93b7c802258222c1a9736b0f4ec37c
MD5 57afe6bd940d19b87b36aadebfa06e75
BLAKE2b-256 71cc08ea98d6b294ffd0d01bb3efa43fb40c7c1ff84efeb56a71b527320fa898

See more details on using hashes here.

Provenance

The following attestation bundles were made for molecule-26.8.0.tar.gz:

Publisher: release.yml on ansible/molecule

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file molecule-26.8.0-py3-none-any.whl.

File metadata

  • Download URL: molecule-26.8.0-py3-none-any.whl
  • Upload date:
  • Size: 163.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for molecule-26.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 69a2a07dad27d362b9209024c9d3f0daac29da6637945fec5098deea448e3b52
MD5 919b5dbb7d0e917b50b8dc8623191872
BLAKE2b-256 d686e03836e37ed144f3d5b5f3d6d9730122e717947820cae358d6725ff2595e

See more details on using hashes here.

Provenance

The following attestation bundles were made for molecule-26.8.0-py3-none-any.whl:

Publisher: release.yml on ansible/molecule

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page