Metadata-Version: 2.1
Name: pytest-molecule
Version: 1.3.2
Summary: PyTest Molecule Plugin :: discover and run molecule tests
Home-page: https://github.com/ansible-community/pytest-molecule
Author: Sorin Sbarnea
Author-email: sorin.sbarnea@gmail.com
Maintainer: Sorin Sbarnea
Maintainer-email: sorin.sbarnea@gmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/ansible-community/pytest-molecule/issues
Project-URL: Release Management, https://github.com/ansible-community/pytest-molecule/releases
Project-URL: CI: Zuul, https://dashboard.zuul.ansible.com/t/ansible/builds?project=ansible-community/pytest-molecule
Project-URL: Source Code, https://github.com/ansible-community/pytest-molecule
Description: ===============
        pytest-molecule
        ===============
        
        .. image:: https://img.shields.io/pypi/v/pytest-molecule.svg
            :target: https://pypi.org/project/pytest-molecule
            :alt: PyPI version
        
        .. image:: https://img.shields.io/pypi/pyversions/pytest-molecule.svg
            :target: https://pypi.org/project/pytest-molecule
            :alt: Python versions
        
        .. image:: https://zuul-ci.org/gated.svg
            :target: https://dashboard.zuul.ansible.com/t/ansible/builds?project=pycontribs/selinux
            :alt: See Build Status on Zuul CI
        
        .. image:: https://img.shields.io/badge/code%20style-black-000000.svg
            :target: https://github.com/python/black
            :alt: Python Black Code Style
        
        PyTest Molecule Plugin :: auto detects and runs molecule tests
        
        ----
        
        This plugin enables pytest discovery of all ``molecule.yml`` files inside the
        codebase and runs them as pytest tests.
        
        Once you install pytest-molecule you should be able to just run ``pytest`` in
        order to run molecule on all roles and scenarios.
        
        Optionally you can define ``MOLECULE_OPTS`` for passing extra parameters to
        each molecule call.
        
        Discovered tests do have molecule ``driver`` and ``platforms`` added as
        markers_, so you can selectively limit which test types to run:
        
        .. code-block:: shell
        
            # Lists all tests that uses docker
            $ pytest --collect-only -m docker
        
            # Runs scenarios with platform named centos7 and delegated driver:
            $ pytest -m delegated -m centos7
        
        Please note that at this moment molecule will run the entire scenario if the
        markers are platforms, this is not *yet* a way to limit which platforms are
        executed inside a specific scenario.
        
        All tests are added the ``molecule`` marker.
        
        This plugin also adds a new pytest option named
        ``--molecule-unavailable-driver=skip`` which can be used to tell it what to do
        when molecule drivers are not loading. Current default is ``None`` but you
        can choose marks like ``skip`` or ``xfail``.
        
        Installation
        ------------
        
        You can install "pytest-molecule" via pip_ from PyPI_:
        
        .. code-block:: shell
        
            $ PIP_NO_BUILD_ISOLATION=false pip install pytest-molecule
        
        ``PIP_NO_BUILD_ISOLATION`` is needed only on ancient python distributions to
        workaround https://github.com/pypa/pip/issues/5229
        
        Contributing
        ------------
        Contributions are very welcome. Tests can be run with tox_, please ensure
        the coverage at least stays the same before you submit a pull request.
        
        License
        -------
        
        Distributed under the terms of the MIT_ license, "pytest-molecule" is free
        and open source software
        
        
        Issues
        ------
        
        If you encounter any problems, please `file an issue`_ along with a detailed
        description.
        
        .. _`MIT`: http://opensource.org/licenses/MIT
        .. _`file an issue`: https://github.com/pycontribs/pytest-molecule/issues
        .. _`pytest`: https://github.com/pytest-dev/pytest
        .. _`tox`: https://tox.readthedocs.io/en/latest/
        .. _`pip`: https://pypi.org/project/pip/
        .. _`PyPI`: https://pypi.org/project
        .. _markers: http://doc.pytest.org/en/latest/example/markers.html
        
Keywords: ansible,roles,testing,molecule,pytest,plugin
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Framework :: Pytest
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 :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Testing
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/x-rst
Provides-Extra: ansi
Provides-Extra: docker
Provides-Extra: podman
Provides-Extra: vagrant
