
Full pytest documentation
*************************

Download latest version as PDF

* Getting started basics
  * pytest: helps you write better programs
  * Installation and Getting Started
  * Usage and Invocations
  * Good Integration Practises
  * Project examples
  * Some Issues and Questions
* py.test reference documentation
  * Pytest API and builtin fixtures
  * Basic test configuration
  * The writing and reporting of assertions in tests
  * pytest fixtures: explicit, modular, scalable
  * Parametrizing fixtures and test functions
  * classic xunit-style setup
  * Capturing of the stdout/stderr output
  * Monkeypatching/mocking modules and environments
  * xdist: pytest distributed testing plugin
  * Temporary directories and files
  * Marking test functions with attributes
  * Skip and xfail: dealing with tests that can not succeed
  * Asserting deprecation and other warnings
  * Support for unittest.TestCase / Integration of fixtures
  * Running tests written for nose
  * Doctest integration for modules and test files
* Working with plugins and conftest files
  * conftest.py: local per-directory plugins
  * Installing External Plugins / Searching
  * Writing a plugin by looking at examples
  * Making your plugin installable by others
  * Plugin discovery order at tool startup
  * Requiring/Loading plugins in a test module or conftest file
  * Accessing another plugin by name
  * Finding out which plugins are active
  * Deactivating / unregistering a plugin by name
* py.test default plugin reference
* py.test hook reference
  * Hook specification and validation
  * Initialization, command line and configuration hooks
  * Generic "runtest" hooks
  * Collection hooks
  * Reporting hooks
* Reference of objects involved in hooks
* Usages and Examples
  * Demo of Python failure reports with py.test
  * Basic patterns and examples
  * Parametrizing tests
  * Working with custom markers
  * A sesssion-fixture which can look at all collected tests
  * Changing standard (Python) test discovery
  * Working with non-python tests
* Talks and Tutorials
  * Tutorial examples and blog postings
  * Older conference talks and tutorials
* Feedback and contribute to py.test
  * Contact channels
  * Working from version control or a tarball
* pytest-2.3: reasoning for fixture/funcarg evolution
  * Shortcomings of the previous "pytest_funcarg__" mechanism
  * Direct scoping of fixture/funcarg factories
  * Direct parametrization of funcarg resource factories
  * No "pytest_funcarg__" prefix when using @fixture decorator
  * solving per-session setup / autouse fixtures
  * funcargs/fixture discovery now happens at collection time
  * Conclusion and compatibility notes
* Release announcements
  * pytest-2.3.4: stabilization, more flexible selection via "-k expr"
  * pytest-2.3.3: integration fixes, py24 suport, "*/**" shown in
    traceback
  * pytest-2.3.2: some fixes and more traceback-printing speed
  * pytest-2.3.1: fix regression with factory functions
  * pytest-2.3: improved fixtures / better unittest integration
  * pytest-2.2.4: bug fixes, better junitxml/unittest/python3 compat
  * pytest-2.2.2: bug fixes
  * pytest-2.2.1: bug fixes, perfect teardowns
  * py.test 2.2.0: test marking++, parametrization++ and duration
    profiling
  * py.test 2.1.3: just some more fixes
  * py.test 2.1.2: bug fixes and fixes for jython
  * py.test 2.1.1: assertion fixes and improved junitxml output
  * py.test 2.1.0: perfected assertions and bug fixes
  * py.test 2.0.3: bug fixes and speed ups
  * py.test 2.0.2: bug fixes, improved xfail/skip expressions, speed
    ups
  * py.test 2.0.1: bug fixes
  * py.test 2.0.0: asserts++, unittest++, reporting++, config++,
    docs++