Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Invoke py.test as distutils command with dependency resolution

Project Description

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

License

License is indicated in the project metadata (typically one or more of the Trove classifiers). For more details, see this explanation.

Usage

  • 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 setup.py pytest.
  • Pass --index-url to have test requirements downloaded from an alternate index URL (unnecessary if specified for easy_install in setup.cfg).
  • Pass additional py.test command-line options using --addopts.
  • Set permanent options for the python setup.py pytest command (like index-url) in the [pytest] section of setup.cfg.
  • Set permanent options for the py.test run (like addopts or pep8ignore) in the [pytest] section of pytest.ini or tox.ini or put them in the [tool:pytest] section of setup.cfg. See pytest issue 567.
  • Optionally, set test=pytest in the [aliases] section of setup.cfg to cause python setup.py test to invoke pytest.

Example

The most simple usage looks like this in setup.py:

setup(
    setup_requires=[
        'pytest-runner',
    ],
    tests_require=[
        'pytest',
    ],
)

Additional dependencies require to run the tests (e.g. mock or pytest plugins) may be added to tests_require and will be downloaded and required by the session before invoking pytest.

Follow this search on github for examples of real-world usage.

Standalone Example

This technique is deprecated - if you have standalone scripts you wish to invoke with dependencies, use rwt.

Although pytest-runner is typically used to add pytest test runner support to maintained packages, pytest-runner may also be used to create standalone tests. Consider this example failure, reported in jsonpickle #117 or this MongoDB test demonstrating a technique that works even when dependencies are required in the test.

Either example file may be cloned or downloaded and simply run on any system with Python and Setuptools. It will download the specified dependencies and run the tests. Afterward, the the cloned directory can be removed and with it all trace of invoking the test. No other dependencies are needed and no system configuration is altered.

Then, anyone trying to replicate the failure can do so easily and with all the power of pytest (rewritten assertions, rich comparisons, interactive debugging, extensibility through plugins, etc).

As a result, the communication barrier for describing and replicating failures is made almost trivially low.

Considerations

Conditional Requirement

Because it uses Setuptools setup_requires, pytest-runner will install itself on every invocation of setup.py. In some cases, this causes delays for invocations of setup.py that will never invoke pytest-runner. To help avoid this contingency, consider requiring pytest-runner only when pytest is invoked:

needs_pytest = {'pytest', 'test', 'ptr'}.intersection(sys.argv)
pytest_runner = ['pytest-runner'] if needs_pytest else []

# ...

setup(
    #...
    setup_requires=[
        #... (other setup requirements)
    ] + pytest_runner,
)
Release History

Release History

This version
History Node

2.12.1

History Node

2.12

History Node

2.11.1

History Node

2.11

History Node

2.10.1

History Node

2.10

History Node

2.9

History Node

2.8

History Node

2.7.1

History Node

2.7

History Node

2.6.3

History Node

2.6.2

History Node

2.6.1

History Node

2.6

History Node

2.5.1

History Node

2.5

History Node

2.4

History Node

2.3

History Node

2.2.1

History Node

2.2

History Node

2.1.2

History Node

2.1.1

History Node

2.1

History Node

2.0

History Node

1.2

History Node

1.1

History Node

1.1b1

History Node

1.0

History Node

1.0b2

History Node

1.0dev

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
pytest_runner-2.12.1-py2.py3-none-any.whl (8.8 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Sep 7, 2017
pytest-runner-2.12.1.tar.gz (11.6 kB) Copy SHA256 Checksum SHA256 Source Sep 7, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting