pytest
======

:doc:`pytest <pytest:index>` ist eine Alternative zu Pythons
:doc:`../unittest`-Modul, die das Testen noch weiter vereinfacht.

* pytest erkennt Tests automatisch anhand von Dateinamen und Funktionen, die mit
  ``test_`` beginnen, während bei unittest Testklassen und -Methoden von
  :class:`unittest.TestCase` abgeleitet werden. Dies führt zu einer einfacheren,
  besser lesbaren Syntax mit weniger Boilerplate-Code.
* unittest bietet eine Reihe von Assertion-Methoden (z. B. :func:`assertEqual`,
  :func:`assertTrue`, :func:`assertRaises`). Mit pytest lassen sich dieselben
  Annahmen definieren, allerdings mit der Standard-:func:`assert`-Anweisung von
  Python. Dies führt häufig zu aussagekräftigeren Fehlermeldungen und einer
  besseren Introspektion.
* unittest stellt für Fixtures nur :func:`setUp`- und :func:`tearDown`-Methoden
  bereit. In pytest hingegen werden :doc:`Fixtures <fixtures>` als Funktionen
  definiert, was die Wiederverwendbarkeit fördert und die Verwaltung von
  Testabhängigkeiten vereinfacht.
* In unittest sind parametrisierte Tests zwar möglich, erfordern jedoch
  zusätzliche Aufwand. pytest enthält hingegen den :doc:`Dekorator
  <../../functions/decorators>` ``@pytest.mark.parametrize``, mit dem mühelos
  Testfunktionen mit unterschiedlichen Eingaben und erwarteten Ergebnissen
  ausgeführt werden können.
* pytest verfügt über ein umfangreiches Ökosystem mit über 800 :doc:`plugins`
  für fortgeschrittene Testanforderungen; unittest ist in seiner Erweiterbarkeit
  eingeschränkter.

.. note::
   Auch bei agentischer Software-Entwicklung nutzen wir pytest:

   .. code-block:: md
      :caption: AGENTS.md

      # Testing
      - Use `pytest` for testing your code.
      - Collect pytest fixtures in a `conftest.py` file to avoid duplication.
      - When a test fails, run the last failed test first using `uv run pytest --last-failed`.

   .. seealso::
      * :ref:`agentic-software-engineering:testing`

.. seealso::
   Im :doc:`Jupyter Tutorial <jupyter-tutorial:notebook/testing/ipytest>` ist
   beschrieben, wie pytest auch in Jupyter Notebooks verwendet werden kann.

Installation
------------

Ihr könnt pytest mit :ref:`uv` installieren:

.. tab:: Linux/macOS

   .. code-block:: console

      $ uv add --group tests pytest

.. tab:: Windows

   .. code-block:: ps1con

      C:>  uv add --group tests pytest

.. toctree::
   :titlesonly:
   :hidden:

   examples
   functions
   testsuite
   fixtures
   builtin-fixtures
   params
   markers
   plugins
   config
   command-line-options
   debug
   coverage