zope.testrunner Detailed Documentation

For an overview of features, see Overview.

To get started testing right away, see Using zope.testrunner

Usage

• Overview
• Using zope.testrunner
  • Installation
  • Some useful command-line options to get you started
  • Writing tests
  • Test grouping
  • Other features
• Command Line Usage

Writing Tests

• Layers To Organize and Share Test Fixtures
• Layers that can’t be torn down
• Layers Implemented via Object Instances

Running Tests

• Automatically Discovering Tests
• Selecting Tests By Layer
• Selecting Tests By Package, Module, and Level
  • Packages
  • Modules And Tests
  • Levels
  • Listing Selected Tests
• Shuffling tests
  • Running shuffled tests
  • Specifying a seed number to control tests shuffling
• Debugging Test Failures
  • Post-Mortem Debugging
• Code Coverage
  • Ignoring Tests
• Profiling
• Running Without Source Code
• Repeating Tests
• Garbage Collection Control
  • Garbage Collection Statistics
• Debugging Memory Leaks
• Threads Reporting

Output Control

• Verbose Output
  • Quiet output
• Test Progress
  • Autodetecting progress
  • Disabling progress indication
• Colorful output
  • Successful test
  • Failed test
  • Skipped tests
  • Doctest failures
  • Timing individual tests
  • Disabling colors
  • Autodetecting colors
• Errors and Failures
  • Capturing output
  • Suppressing multiple doctest errors
  • Getting diff output for doctest failures
  • Testing-Module Import Errors
  • Reporting Errors to Calling Processes

Advanced

• Knitting in extra package directories
• testrunner Edge Cases
  • Separating Python path and test directories
  • Debugging Edge Cases
  • Test Suites with None for suites or tests
  • You must use –repeat with –report-refcounts
  • Selection
  • Requiring unique test IDs

zope.testrunner API

• Basic API Usage
• Passing arguments explicitly
• Setuptools Support
  • The ftest Setup Command
  • Skipping Tests with Layers
• API Reference

• zope.testrunner Changelog
  • 6.1 (unreleased)
  • 6.0 (2023-03-28)
  • 5.6 (2022-12-09)
  • 5.5.1 (2022-09-07)
  • 5.5 (2022-06-24)
  • 5.4.0 (2021-11-19)
  • 5.3.0 (2021-03-17)
  • 5.2 (2020-06-29)
  • 5.1 (2019-10-19)
  • 5.0 (2019-03-19)
  • 4.9.2 (2018-11-24)
  • 4.9.1 (2018-11-21)
  • 4.9 (2018-10-05)
  • 4.8.1 (2017-11-12)
  • 4.8.0 (2017-11-10)
  • 4.7.0 (2017-05-30)
  • 4.6.0 (2016-12-28)
  • 4.5.1 (2016-06-20)
  • 4.5.0 (2016-05-02)
  • 4.4.10 (2015-11-10)
  • 4.4.9 (2015-05-21)
  • 4.4.8 (2015-05-01)
  • 4.4.7 (2015-04-02)
  • 4.4.6 (2015-01-21)
  • 4.4.5 (2015-01-06)
  • 4.4.4 (2014-12-27)
  • 4.4.3 (2014-03-19)
  • 4.4.2 (2014-02-22)
  • 4.4.1 (2013-07-10)
  • 4.4.0 (2013-06-06)
  • 4.3.3 (2013-03-03)
  • 4.3.2 (2013-03-03)
  • 4.3.1 (2013-03-02)
  • 4.3.0 (2013-03-02)
  • 4.2.0 (2013-02-12)
  • 4.1.1 (2013-02-08)
  • 4.1.0 (2013-02-07)
  • 4.0.4 (2011-10-25)
  • 4.0.3 (2011-03-17)
  • 4.0.2 (2011-03-16)
  • 4.0.1 (2011-02-21)
  • 4.0.0 (2010-10-19)
  • 4.0.0b5 (2010-07-20)
  • 4.0.0b4 (2010-06-23)
  • 4.0.0b3 (2010-06-16)
  • 4.0.0b2 (2010-05-03)
  • 4.0.0b1 (2010-04-29)

Indices and tables

• Index
• Module Index
• Search Page