Skip to main content

An automagic `patch` fixture that can patch objects directly or by name.

Project description

Pytest Patch

An automagic replacement for monkeypatch or unittest.mock.patch that can be used on objects either directly or by name.



patching objects directly

from pytest import fixture
from mock import MagicMock, sentinel

from mymodule import callee, caller  # `caller` returns `callee()`

def callee_mock(patch):
  # returns the second argument if provided, `MagicMock()` otherwise
  return patch(callee, MagicMock(return_value=sentinel.callee))

def test_caller(callee_mock):
  assert caller() == sentinel.callee

patching objects by name

def callee_mock(patch):
  return patch('callee')  # assumes `callee` is in `mymodule`

patching by full path

This behavior is similar to unittest.mock.patch.

def callee_mock(patch):
  return patch('mymodule.callee')


By default, pytest-patch assumes the following repository structure:

    */  # e.g. unit/


No configuration is needed if your repository matches this structure where the repository name is the same as the name of the module and your tests are in their corresponding subdirectories mirroring your module's path structure.

If the above is not the case, e.g. you have a repository with a nonmatching module name or a monorepo with multiple modules, you may specify the corresponding flags either in the pytest command line or the ini file, glob-style:

pytest --module-names=mymodule,othermodule --test-paths=tests.unit,tests.e2e.*

or (in pytest.ini)

module_names = mymodule othermodule
test_paths = tests.unit tests.e2e.*

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-patch-0.2.0.tar.gz (4.9 kB view hashes)

Uploaded Source

Built Distribution

pytest_patch-0.2.0-py3-none-any.whl (4.5 kB view hashes)

Uploaded Python 3

Supported by

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