Skip to main content


Project description

Setup scripts can use pytest-runner to add test support for pytest runner.


  • Add ‘pytest-runner’ to your ‘setup_requires’. Pin to ‘>=2.0,<3dev’ (or similar) to avoid pulling in incompatible versions.
  • Include ‘pytest’ and any other testing requirements to ‘tests_require’.
  • Invoke tests with pytest.
  • Pass –index-url to have test requirements downloaded from an alternate index URL.
  • Pass additional py.test command-line options using –addopts.
  • Set options in the [pytest] section of setup.cfg.

See the jaraco.util project for an example.



  • The preferred invocation is now the ‘pytest’ command.


  • Removed support for the alternate usage. The recommended usage (as a distutils command) is now the only supported usage.
  • Removed support for the –junitxml parameter to the ptr command. Clients should pass the same parameter (and all other py.test arguments) to py.test via the –addopts parameter.


  • Added support for –addopts to pass any arguments through to py.test.
  • Deprecated support for –junitxml. Use –addopts instead. –junitxml will be removed in 2.0.


Initial implementation.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date (5.3 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page