Full pytest documentation

Download latest version as PDF

• Getting started basics
  • Installation and Getting Started
  • Usage and Invocations
  • Good Integration Practices
  • Project examples
  • Some Issues and Questions
• Usages and Examples
  • Demo of Python failure reports with pytest
  • Basic patterns and examples
  • Parametrizing tests
  • Working with custom markers
  • A session-fixture which can look at all collected tests
  • Changing standard (Python) test discovery
  • Working with non-python tests
• Monkeypatching/mocking modules and environments
  • Simple example: monkeypatching functions
  • example: preventing “requests” from remote operations
  • example: setting an attribute on some class
  • Method reference of the monkeypatch function argument
• Temporary directories and files
  • The ‘tmpdir’ fixture
  • The ‘tmpdir_factory’ fixture
  • The default base temporary directory
• Capturing of the stdout/stderr output
  • Default stdout/stderr/stdin capturing behaviour
  • Setting capturing methods or disabling capturing
  • Using print statements for debugging
  • Accessing captured output from a test function
• Asserting Warnings
  • Asserting warnings with the warns function
  • Recording warnings
  • Ensuring a function triggers a deprecation warning
• Cache: working with cross-testrun state
  • Usage
  • Rerunning only failures or failures first
  • The new config.cache object
  • Inspecting Cache content
  • Clearing Cache content
  • config.cache API
• Installing and Using plugins
  • Requiring/Loading plugins in a test module or conftest file
  • Finding out which plugins are active
  • Deactivating / unregistering a plugin by name
  • Pytest default plugin reference
• Contribution getting started
  • Feature requests and feedback
  • Report bugs
  • Fix bugs
  • Implement features
  • Write documentation
  • Submitting Plugins to pytest-dev
  • Preparing Pull Requests on GitHub
• Talks and Tutorials
  • Talks and blog postings
  • Older conference talks and tutorials

• 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
  • python testing sprint June 20th-26th 2016
    • Participants
    • Sprint organisation, schedule
    • Accomodation
    • Money / funding
  • pytest-2.9.1
    • 2.9.1 (compared to 2.9.0)
  • pytest-2.9.1
    • 2.9.1 (compared to 2.9.0)
  • pytest-2.9.0
    • 2.9.0 (compared to 2.8.7)
  • pytest-2.8.7
    • 2.8.7 (compared to 2.8.6)
  • pytest-2.8.6
    • 2.8.6 (compared to 2.8.5)
  • pytest-2.8.5
    • 2.8.5 (compared to 2.8.4)
  • pytest-2.8.4
    • 2.8.4 (compared to 2.8.3)
  • pytest-2.8.3: bug fixes
    • 2.8.3 (compared to 2.8.2)
  • pytest-2.8.2: bug fixes
    • 2.8.2 (compared to 2.7.2)
  • pytest-2.7.2: bug fixes
    • 2.7.2 (compared to 2.7.1)
  • pytest-2.7.1: bug fixes
    • 2.7.1 (compared to 2.7.0)
  • pytest-2.7.0: fixes, features, speed improvements
    • 2.7.0 (compared to 2.6.4)
  • pytest-2.6.3: fixes and little improvements
  • Changes 2.6.3
  • pytest-2.6.2: few fixes and cx_freeze support
    • 2.6.2
  • pytest-2.6.1: fixes and new xfail feature
  • Changes 2.6.1
  • pytest-2.6.0: shorter tracebacks, new warning system, test runner compat
    • 2.6.0
  • pytest-2.5.2: fixes
    • 2.5.2
  • pytest-2.5.1: fixes and new home page styling
    • 2.5.1
  • pytest-2.5.0: now down to ZERO reported bugs!
    • 2.5.0
  • pytest-2.4.2: colorama on windows, plugin/tmpdir fixes
  • pytest-2.4.1: fixing three regressions compared to 2.3.5
  • pytest-2.4.0: new fixture features/hooks and bug fixes
    • Changes between 2.3.5 and 2.4
  • pytest-2.3.5: bug fixes and little improvements
    • Changes between 2.3.4 and 2.3.5
  • pytest-2.3.4: stabilization, more flexible selection via “-k expr”
  • pytest-2.3.3: integration fixes, py24 suport, */** shown in traceback
    • Changes between 2.3.2 and 2.3.3
  • pytest-2.3.2: some fixes and more traceback-printing speed
    • Changes between 2.3.1 and 2.3.2
  • pytest-2.3.1: fix regression with factory functions
    • Changes between 2.3.0 and 2.3.1
  • pytest-2.3: improved fixtures / better unittest integration
    • Changes between 2.2.4 and 2.3.0
  • pytest-2.2.4: bug fixes, better junitxml/unittest/python3 compat
    • Changes between 2.2.3 and 2.2.4
  • pytest-2.2.2: bug fixes
    • Changes between 2.2.1 and 2.2.2
  • pytest-2.2.1: bug fixes, perfect teardowns
    • Changes between 2.2.0 and 2.2.1
  • py.test 2.2.0: test marking++, parametrization++ and duration profiling
    • notes on incompatibility
    • Changes between 2.1.3 and 2.2.0
  • py.test 2.1.3: just some more fixes
    • Changes between 2.1.2 and 2.1.3
  • py.test 2.1.2: bug fixes and fixes for jython
    • Changes between 2.1.1 and 2.1.2
  • py.test 2.1.1: assertion fixes and improved junitxml output
    • Changes between 2.1.0 and 2.1.1
  • py.test 2.1.0: perfected assertions and bug fixes
    • Changes between 2.0.3 and 2.1.0
  • py.test 2.0.3: bug fixes and speed ups
    • Changes between 2.0.2 and 2.0.3
  • py.test 2.0.2: bug fixes, improved xfail/skip expressions, speed ups
    • Changes between 2.0.1 and 2.0.2
  • py.test 2.0.1: bug fixes
    • Changes between 2.0.0 and 2.0.1
  • py.test 2.0.0: asserts++, unittest++, reporting++, config++, docs++
    • New Features
    • Fixes
    • Important Notes
    • (Incompatible) Removals