pytest-remote-response 0.2.1

Pytest plugin for capturing and mocking connection requests.

This package provides a plugin for pytest framework for capturing and mocking connection requests during the test run.

Installation

$ pip install pytest-remote-response

or

$ git clone https://github.com/devanshshukla99/pytest-remote-response
$ cd pytest-remote-response
$ pip install .

The plugin will register automatically with pytest framework and will be ready to use.

Usage

Pytest plugin

The plugin works by using interceptors of different libraries which can be checked by response.available() method; these interceptors have to be applied for each pytest run using --remote={INTERCEPTOR}.

$ pytest --remote="urllib_quick|requests_quick|aiohttp_quick"

Handling requests:

• Prevent remote requests:

  all requests are allowed by default; one can disable them using –remote-blocked flag.

$ pytest --remote={INTERCEPTORS} --remote-blocked

• Capture remote requests:

  the requests can be captured in a json file using --remote-capture arg.

$ pytest --remote={INTERCEPTORS} --remote-capture

• Mock remote requests:

  the requests can be mocked using --remote-response flag.

  NOTE: Due to certain limitations, it is advised to not use this plugin in an offline environment.

$ pytest --remote={INTERCEPTORS} --remote-response

Standalone package

The tools implemented in this package can be easily ported to any other application, with mimial config required.

Configuration:

from pytest_response import response

response.setup_database({DUMP FILE})
response.post({INTERCEPTOR})
...
response.unpost()

Testing

Use tox to make sure the plugin is working:

$ git clone https://github.com/devanshshukla99/pytest-remote-response
$ cd pytest-remote-response
$ tox -e py38

See tox for more info.

Licence

This plugin is licenced under a 3-clause BSD style licence - see the LICENCE file.