docs.pytest.org Open in urlscan Pro
104.17.33.82  Public Scan

Form analysis
2 forms found in the DOM

GET search.html

<form class="search" action="search.html" method="get">
  <input type="text" name="q" aria-labelledby="searchlabel" autocomplete="off" autocorrect="off" autocapitalize="off" spellcheck="false">
  <input type="submit" value="Go">
</form>

GET //readthedocs.org/projects/pytest/search/

<form id="flyout-search-form" class="wy-form" target="_blank" action="//readthedocs.org/projects/pytest/search/" method="get">
  <input type="text" name="q" aria-label="Dokumente durchsuchen" placeholder="Dokumente durchsuchen">
</form>

Text Content

NAVIGATION

 * modules
 * pytest-8.0 »
 * pytest: helps you write better programs

Next Open Trainings and Events

 * Professional Testing with Python, via Python Academy (3 day in-depth
   training):
   
    * June 11th to 13th 2024, Remote
   
    * March 4th to 6th 2025, Leipzig, Germany / Remote

 * pytest development sprint, June 2024 (date poll)

Also see previous talks and blogposts.


PYTEST: HELPS YOU WRITE BETTER PROGRAMS¶

The pytest framework makes it easy to write small, readable tests, and can scale
to support complex functional testing for applications and libraries.

pytest requires: Python 3.8+ or PyPy3.

PyPI package name: pytest


A QUICK EXAMPLE¶

# content of test_sample.py
def inc(x):
    return x + 1


def test_answer():
    assert inc(3) == 5


To execute it:

$ pytest
=========================== test session starts ============================
platform linux -- Python 3.x.y, pytest-8.x.y, pluggy-1.x.y
rootdir: /home/sweet/project
collected 1 item

test_sample.py F                                                     [100%]

================================= FAILURES =================================
_______________________________ test_answer ________________________________

    def test_answer():
>       assert inc(3) == 5
E       assert 4 == 5
E        +  where 4 = inc(3)

test_sample.py:6: AssertionError
========================= short test summary info ==========================
FAILED test_sample.py::test_answer - assert 4 == 5
============================ 1 failed in 0.12s =============================


Due to pytest’s detailed assertion introspection, only plain assert statements
are used. See Get started for a basic introduction to using pytest.


FEATURES¶

 * Detailed info on failing assert statements (no need to remember self.assert*
   names)

 * Auto-discovery of test modules and functions

 * Modular fixtures for managing small or parametrized long-lived test resources

 * Can run unittest (including trial) and nose test suites out of the box

 * Python 3.8+ or PyPy 3

 * Rich plugin architecture, with over 800+ external plugins and thriving
   community


DOCUMENTATION¶

 * Get started - install pytest and grasp its basics just twenty minutes

 * How-to guides - step-by-step guides, covering a vast range of use-cases and
   needs

 * Reference guides - includes the complete pytest API reference, lists of
   plugins and more

 * Explanation - background, discussion of key topics, answers to higher-level
   questions


BUGS/REQUESTS¶

Please use the GitHub issue tracker to submit bugs or request features.


SUPPORT PYTEST¶

Open Collective is an online funding platform for open and transparent
communities. It provides tools to raise money and share your finances in full
transparency.

It is the platform of choice for individuals and companies that want to make
one-time or monthly donations directly to the project.

See more details in the pytest collective.


PYTEST FOR ENTERPRISE¶

Available as part of the Tidelift Subscription.

The maintainers of pytest and thousands of other packages are working with
Tidelift to deliver commercial support and maintenance for the open source
dependencies you use to build your applications. Save time, reduce risk, and
improve code health, while paying the maintainers of the exact dependencies you
use.

Learn more.


SECURITY¶

pytest has never been associated with a security vulnerability, but in any case,
to report a security vulnerability please use the Tidelift security contact.
Tidelift will coordinate the fix and disclosure.


What are the risks of outsourcing your auth and how can you mitigate them? Find
out in this eBook
Ad by EthicalAds   ·   ℹ️


ABOUT PYTEST

pytest is a mature full-featured Python testing tool that helps you write better
programs.


CONTENTS

 * Home
 * Get started
 * How-to guides
 * Reference guides
 * Explanation
 * Complete table of contents
 * Library of examples


ABOUT THE PROJECT

 * Changelog
 * Contributing
 * Backwards Compatibility
 * Sponsor
 * pytest for Enterprise
 * License
 * Contact Channels

--------------------------------------------------------------------------------

 * pytest: helps you write better programs
   * A quick example
   * Features
   * Documentation
   * Bugs/Requests
   * Support pytest
   * pytest for enterprise
     * Security

--------------------------------------------------------------------------------


USEFUL LINKS

 * pytest @ PyPI
 * pytest @ GitHub
 * Issue Tracker
 * PDF Documentation


© Copyright 2015, holger krekel and pytest-dev team. Created using Sphinx 7.2.6.
  v: 8.0.x
Versionen latest stable 8.0.x 7.4.x 7.3.x 7.2.x 7.1.x 7.0.x 6.2.x 4.6.x
Downloads PDF HTML Epub Auf Read the Docs Projektstartseite Erstellungsprozesse
Downloads Auf GitHub Ansehen Bearbeiten Suche


--------------------------------------------------------------------------------

Bereitgestellt von Read the Docs · Datenschutz-Bestimmungen