Skip to main content

Mock command line utils by replaying recorded invocations

Project description

See Build Status on Travis CI

This package provides two command line utilities: crecord and creplay. The former records the output (stdout and stderr) and the return code of a command and the latter replays the command invocation by reproducing its output and return code:

$ crecord echo foo
$ creplay echo foo
$ crecord ls foo
ls: foo: No such file or directory
$ creplay ls foo
ls: foo: No such file or directory
$ echo $?

This could be used to mock slow and environment-dependent command invocations for testing purposes.

Pytest plugin

There’s also a pytest plugin contained in cli_mock package. It exposes popen_controller fixture that can be used to replay crecord logs in response to subprocess.Popen invocations (and the APIs that call it under the hood):

def test_foo(popen_controller):
    output = subprocess.check_output(['foo'])
    assert output == b'bar\n'

After the replay log is activated calls to subprocess.Popen and friends with the commands that are contained in the log will replay from the log. Commands that are not in the log will trigger an AssertionError.

Non-strict mode

It’s possible to allow executing commands that are not in the log via activating non-strict mode:



popen_controller.set_replay_log(my_log, strict=False)

In non-strict mode any command that is not in the log will be passed to subprocess.Popen without modifications and will be executed in a usual fashion.

Project details

Download files

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

Files for cli-mock, version 0.2.1
Filename, size File type Python version Upload date Hashes
Filename, size cli_mock-0.2.1.tar.gz (4.6 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page