Pytest plugin to simplify running shell commands against the system
Project description
What is Pytest Shell Utilities
“When in doubt, shell out”
—Thomas S. Hatch
This pytest plugin was extracted from pytest-salt-factories. If provides a basic fixture shell which basically uses subprocess.Popen to run commands against the running system on a shell while providing a nice assert’able return class.
Install
Installing pytest-shell-utilities is as simple as:
python -m pip install pytest-shell-utilitiesAnd, that’s honestly it.
Usage
Once installed, you can now use the shell fixture to run some commands and assert against the outcome.
def test_assert_good_exitcode(shell):
ret = shell.run("exit", "0")
assert ret.returncode == 0
def test_assert_bad_exitcode(shell):
ret = shell.run("exit", "1")
assert ret.returncode == 1If the command outputs parseable JSON, the shell fixture can attempt loading that output as JSON which allows for asserting against the JSON loaded object.
def test_against_json_output(shell):
d = {"a": "a", "b": "b"}
ret = shell.run("echo", json.dumps(d))
assert ret.data == dAdditionally, the return object’s .stdout and .stderr can be line matched using pytest.pytester.LineMatcher:
MARY_HAD_A_LITTLE_LAMB = """\
Mary had a little lamb,
Its fleece was white as snow;
And everywhere that Mary went
The lamb was sure to go.
"""
def test_matcher_attribute(shell):
ret = shell.run("echo", MARY_HAD_A_LITTLE_LAMB)
ret.stdout.matcher.fnmatch_lines_random(
[
"*had a little*",
"Its fleece was white*",
"*Mary went",
"The lamb was sure to go.",
]
)Documentation
The full documentation can be seen here.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file pytest-shell-utilities-1.8.0.tar.gz.
File metadata
- Download URL: pytest-shell-utilities-1.8.0.tar.gz
- Upload date:
- Size: 80.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 7f9a1aac43fad962da11e0ba1ae771eb3b84b73fc4bee94a8f563159231e1920 |
|
| MD5 | c7f0ae17298e9d7a44b46df032b05ace |
|
| BLAKE2b-256 | 639d9ce26090f104441d2441473c5802d07b127560261baf4ac78eb7fb8aeafa |
File details
Details for the file pytest_shell_utilities-1.8.0-py3-none-any.whl.
File metadata
- Download URL: pytest_shell_utilities-1.8.0-py3-none-any.whl
- Upload date:
- Size: 28.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.11.4
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 38d53bce755e9d9b4236ac86cc1ce90ef2485b401b422f736542d3d02144b8fa |
|
| MD5 | 54082a8d8c26d1ccf214c2aa3b93234d |
|
| BLAKE2b-256 | 16acbcef186a3288516f8ac3aa2fef5fe03b5f9f669aaad6e87b3b591c76842e |
