..


******
pytest
******

.. contents::
    :backlinks: none
    :local:


Introduction
============

Python test runner

http://pytest.org/


pycodestyle and pylint
======================

Use the plugins `pytest-pep8 <https://pypi.python.org/pypi/pytest-pep8>`_ and
`pytest-pylint <https://pypi.python.org/pypi/pytest-pylint>`_.

.. sidebar:: pep8 vs. pycodestyle

    The Python project ``pep8`` has been
    `renamed <https://github.com/PyCQA/pycodestyle/issues/466>`_ to
    ``pycodestyle``. But there is no ``pytest-pycodestyle`` project yet.

    https://bitbucket.org/pytest-dev/pytest-pep8/issues/15

With these plugins the linting operations are completely integrated within the
test workflow. The results of the tests and linting operations are rendered
in a consistent format.


pep8 only
---------

Run only the ``pep8`` linting.

.. code-block:: console
    :caption: shell console

    $ pytest --pep8 -m pep8


pylint only
-----------

Run only the ``pylint`` linting.

.. code-block:: console
    :caption: shell console

    $ pytest --pylint -m pylint


Both pep8 and pylint
--------------------

Run both linting tools but not the tests themselves.

.. code-block:: console
    :caption: shell console

    $ pytest --pep8 --pylint -m 'pep8 or pylint'

Run all the tests including the linting tools.

.. code-block:: console
    :caption: shell console

    $ pytest


.. EOF