Skip to main content

Invoke py.test as distutils command with dependency resolution

Project description

https://img.shields.io/pypi/v/pytest-runner.svg https://img.shields.io/pypi/pyversions/pytest-runner.svg tests Code style: Black https://img.shields.io/badge/skeleton-2022-informational https://tidelift.com/badges/package/pypi/pytest-runner

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

Deprecation Notice

pytest-runner depends on deprecated features of setuptools and relies on features that break security mechanisms in pip. For example ‘setup_requires’ and ‘tests_require’ bypass pip --require-hashes. See also pypa/setuptools#1684.

It is recommended that you:

  • Remove 'pytest-runner' from your setup_requires, preferably removing the setup_requires option.

  • Remove 'pytest' and any other testing requirements from tests_require, preferably removing the tests_requires option.

  • Select a tool to bootstrap and then run tests such as tox.

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 pip-run.

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,
)

For Enterprise

Available as part of the Tidelift Subscription.

This project and the maintainers of thousands of other packages are working with Tidelift to deliver one enterprise subscription that covers all of the open source you use.

Learn more.

Security Contact

To report a security vulnerability, please use the Tidelift security contact. Tidelift will coordinate the fix and disclosure.

Project details


Download files

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

Source Distribution

pytest-runner-6.0.1.tar.gz (16.1 kB view details)

Uploaded Source

Built Distribution

pytest_runner-6.0.1-py3-none-any.whl (7.2 kB view details)

Uploaded Python 3

File details

Details for the file pytest-runner-6.0.1.tar.gz.

File metadata

  • Download URL: pytest-runner-6.0.1.tar.gz
  • Upload date:
  • Size: 16.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.12.0

File hashes

Hashes for pytest-runner-6.0.1.tar.gz
Algorithm Hash digest
SHA256 70d4739585a7008f37bf4933c013fdb327b8878a5a69fcbb3316c88882f0f49b
MD5 bd11f67561d7c4db8cf7e96b13ab469f
BLAKE2b-256 d77d60976d532519c3a0b41e06a59ad60949e2be1af937cf02738fec91bfd808

See more details on using hashes here.

File details

Details for the file pytest_runner-6.0.1-py3-none-any.whl.

File metadata

File hashes

Hashes for pytest_runner-6.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ea326ed6f6613992746062362efab70212089a4209c08d67177b3df1c52cd9f2
MD5 75dcfa79cc47ecce1a3943f96aafd643
BLAKE2b-256 232b73982c02d28538b6a1182c0a2faf764ca6a76a6dbe89a69288184051a67b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page