Metadata-Version: 2.1
Name: molecule-containers
Version: 1.0.1
Summary: Molecule Containers Driver :: run molecule tests on containers
Home-page: https://github.com/ansible-community/molecule-containers
Author: Ansible by Red Hat
Author-email: info@ansible.com
Maintainer: Ansible by Red Hat
Maintainer-email: info@ansible.com
License: MIT
Project-URL: Bug Tracker, https://github.com/ansible-community/molecule-containers/issues
Project-URL: Release Management, https://github.com/ansible-community/molecule-containers/projects
Project-URL: CI: Zuul, https://dashboard.zuul.ansible.com/t/ansible/builds?project=ansible-community/molecule-containers
Project-URL: Mailing lists, https://docs.ansible.com/ansible/latest/community/communication.html#mailing-list-information
Project-URL: Source Code, https://github.com/ansible-community/molecule-containers
Keywords: ansible,roles,testing,molecule,plugin,containers,podman,docker
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
Provides-Extra: docker
Provides-Extra: podman
License-File: LICENSE

**************************
Molecule Containers Plugin
**************************

.. image:: https://img.shields.io/pypi/v/molecule-containers.svg
   :target: https://pypi.org/project/molecule-containers
   :alt: PyPI Package

.. image:: https://github.com/ansible-community/molecule-containers/workflows/tox/badge.svg
   :target: https://github.com/ansible-community/molecule-containers/actions

.. 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/license-MIT-brightgreen.svg
   :target: LICENSE
   :alt: Repository License

Molecule Containers is designed to be a **drop-in replacement for the existing
Docker and Podman drivers**, one that can transparently pick whichever backend
is found.

The driver preference is defined by
``MOLECULE_CONTAINERS_BACKEND=podman,docker`` and you can easily switch between
the two by setting this variable.

Keep in mind that if executable is not found, the driver will fallback to
first option in the list and likely fail later.

.. _get-involved:

Get Involved
============

* Join us in the ``#ansible-molecule`` channel on `Freenode`_.
* Join `discussions`_ forum.
* 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`_.

.. _`Freenode`: https://freenode.net
.. _`discussions`: https://github.com/ansible-community/molecule/discussions
.. _`ansible-announce list`: https://groups.google.com/group/ansible-announce
.. _`communication page`: https://docs.ansible.com/ansible/latest/community/communication.html
.. _`wiki`: https://github.com/ansible/community/wiki/molecule

.. _authors:

Authors
=======

* Sorin Sbarnea

.. _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/


