UsageΒΆ

To use ProcRunner in a project:

import procrunner
result = procrunner.run(['/bin/ls', '/some/path/containing spaces'])

To test for successful completion:

assert not result.returncode
assert result.returncode == 0  # alternatively
result.check_returncode()  # raises subprocess.CalledProcessError()

To test for no STDERR output:

assert not result.stderr
assert result.stderr == b''  # alternatively

To run with a specific environment variable set:

result = procrunner.run(..., environment_override={ 'VARIABLE': 'value' })

To run with a specific environment:

result = procrunner.run(..., environment={ 'VARIABLE': 'value' })

To run in a specific directory:

result = procrunner.run(..., working_directory='/some/path')