Molecule
********
.. image:: https://badge.fury.io/py/molecule.svg
:target: https://badge.fury.io/py/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://img.shields.io/badge/license-MIT-brightgreen.svg
:target: LICENSE
:alt: Repository License
Molecule 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 is opinionated in order to encourage an approach
that results in consistently developed roles that are well-written, easily
understood and maintained.
Molecule uses `Ansible`_ `playbooks`_ to exercise the `role`_ and its
associated tests. Molecule supports any provider [#]_ that `Ansible`_
supports.
.. [#]
Providers can be bare-metal, virtual, cloud or containers. If Ansible can
use it, Molecule can test it. Molecule simply leverages Ansible's module
system to manage instances.
.. _`playbooks`: https://docs.ansible.com/ansible/playbooks.html
.. _`role`: http://docs.ansible.com/ansible/playbooks_roles.html
Quick Start
===========
Installing
----------
.. image:: https://asciinema.org/a/161970.png
:target: https://asciinema.org/a/161970?speed=5&autoplay=1&loop=1
:alt: Installing
Creating a new role
-------------------
.. image:: https://asciinema.org/a/161976.png
:target: https://asciinema.org/a/161976?speed=5&autoplay=1&loop=1
:alt: Creating a new role
Testing a new role
-------------------
.. image:: https://asciinema.org/a/161977.png
:target: https://asciinema.org/a/161977?speed=5&autoplay=1&loop=1
:alt: Testing a new role
Testing an existing role
-------------------
.. image:: https://asciinema.org/a/AkQ4KhxuGAxwn1YJX3tM5BZld.png
:target: https://asciinema.org/a/AkQ4KhxuGAxwn1YJX3tM5BZld?speed=5&autoplay=1&loop=1
:alt: Testing an existing role
Documentation
=============
https://molecule.readthedocs.io/
Contact
=======
IRC
---
Join us in the #molecule-users channel on `freenode`_.
.. _`freenode`: https://freenode.net
Forums
------
* `molecule-users`_
* `molecule-dev`_
.. _`molecule-users`: https://groups.google.com/forum/#!forum/molecule-users
.. _`molecule-dev`: https://groups.google.com/forum/#!forum/molecule-dev
Ansible Support
===============
Molecule requires Ansible version 2.2 or later.
.. _`Ansible`: https://docs.ansible.com
License
=======
`MIT`_
.. _`MIT`: https://github.com/metacloud/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/
Metadata
Release files for molecule 2.10.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| molecule-2.10.1.tar.gz | 4.5 MB | Without provenance | Details for molecule-2.10.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| molecule-2.10.1-py2-none-any.whl | Python 2 | none | any | Details for molecule-2.10.1-py2-none-any.whl |
Total release size: 4.7 MB
Release files / molecule-2.10.1.tar.gz
| Download URL | molecule-2.10.1.tar.gz |
|---|---|
| Size | 4.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7f7d21e396f4492c6d11f6b5ad99b0abed7682ff3583f7f768912d2e4f0d0244
|
|
BLAKE2b-256 checksum How to use checksums |
940d01d5b5d30ee880111e065e367939c0a1c48bcd0e4f248c104157b00533af
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Release files / molecule-2.10.1-py2-none-any.whl
| Download URL | molecule-2.10.1-py2-none-any.whl |
|---|---|
| Size | 168.0 kB |
| Tags | Python 2 |
|
SHA-256 checksum How to use checksums |
5065166e3f055cc80bbd1c9366f2a1606ab5ae4adf54b7510be57e51228e8d7f
|
|
BLAKE2b-256 checksum How to use checksums |
90fbf0dfe3fa4f81fea78bbc5c945a686ee2b3a293af11620dafb160fbac35fb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
Security for molecule 2.10.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.