:orphan:

.. _toc:

Full pytest documentation
===========================

`Download latest version as PDF <https://media.readthedocs.org/pdf/pytest/latest/pytest.pdf>`_

.. `Download latest version as EPUB <http://media.readthedocs.org/epub/pytest/latest/pytest.epub>`_


Start here
-----------

.. toctree::
   :maxdepth: 2

   getting-started


How-to guides
-------------

.. toctree::
   :maxdepth: 2

   how-to/usage
   how-to/assert
   how-to/fixtures
   how-to/mark
   how-to/parametrize
   how-to/tmp_path
   how-to/monkeypatch
   how-to/doctest
   how-to/cache

   how-to/logging
   how-to/capture-stdout-stderr
   how-to/capture-warnings
   how-to/skipping

   how-to/plugins
   how-to/writing_plugins
   how-to/writing_hook_functions

   how-to/existingtestsuite
   how-to/unittest
   how-to/xunit_setup

   how-to/bash-completion


Reference guides
-----------------

.. toctree::
   :maxdepth: 2

   reference/fixtures
   reference/plugin_list
   reference/customize
   reference/reference


Explanation
-----------------

.. toctree::
   :maxdepth: 2

   explanation/anatomy
   explanation/fixtures
   explanation/goodpractices
   explanation/flaky
   explanation/pythonpath


Further topics
-----------------

.. toctree::
   :maxdepth: 2

   example/index

   backwards-compatibility
   deprecations

   contributing
   development_guide

   sponsor
   tidelift
   license
   contact

   history
   historical-notes
   talks


.. only:: html

   .. toctree::
      :maxdepth: 1

      announce/index

.. only:: html

   .. toctree::
      :hidden:
      :maxdepth: 1

      changelog
