pytest-shell

Release 0.3.2

A pytest plugin to help with testing shell scripts / black box commands

Homepage PyPI

License
MIT
Install
pip install pytest-shell==0.3.2

Documentation

pytest-shell

A plugin for testing shell scripts and line-based processes with pytest.

You could use it to test shell scripts, or other commands that can be run through the shell that you want to test the usage of.

Not especially feature-complete or even well-tested, but works for what I wanted it for. If you use it please feel free to file bug reports or feature requests.

This pytest plugin was generated with Cookiecutter along with @hackebrot's cookiecutter-pytest-plugin template.

Features

  • Easy access to a bash shell through a pytest fixture.
  • Set and check environment variables through Python code.
  • Automatically fail test on nonzero return codes by default.
  • Helpers for running shell scripts.
  • Mostly, all the great stuff pytest gives you with a few helpers to make it work for bash.

Installation

You can install "pytest-shell" via pip from PyPI:

$ pip install pytest-shell

Usage

You can use a fixture called 'bash' to get a shell process you can interact with.

Test a bash function:

def test_something(bash):
    assert bash.run_function('test') == 'expected output'

Set environment variables, run a .sh file and check results:

def test_something(bash):
    with bash(envvars={'SOMEDIR': '/home/blah'}) as s:
        s.run_script('dostuff.sh', ['arg1', 'arg2'])
        assert s.path_exists('/home/blah/newdir')
        assert s.file_contents('/home/blah/newdir/test.txt') == 'test text'

Run some inline script, check an environment variable was set:

def test_something(bash):
    bash.run_script_inline(['touch /tmp/blah.txt', './another_script.sh'])
    assert bash.envvars.get('AVAR') == 'success'

Use context manager to set environment variables:

def test_something(bash):
    with bash(envvars={'BLAH2': 'something'}):
        assert bash.envvars['BLAH2'] == 'something'

You can run things other than bash (ssh for example), but there aren't specific fixtures and the communication with the process is very bash-specific.

TODO

  • Helpers for piping, streaming.
  • Fixtures and helpers for docker and ssh.
  • Support for non-bash shells.
  • Shell instance in setup for e.g. basepath.

Refactoring TODO

  • Make Connection class just handle bytes, move line-based stuff into an intermediary.
  • Make pattern stuff work line-based or on multiline streams (in a more obvious way than just crafting the right regexes).
  • Make pattern stuff work on part of line if desired, leaving the rest.

License

Distributed under the terms of the MIT license, "pytest-shell" is free and open source software

Stats

Dependencies
1
Dependent packages
5
Dependent repositories
0
Total releases
9
Latest release
First release
Forks
0
Watchers
1
Contributors
0
Repository size
54.7 KB
SourceRank
9

Development practices

Source repo 2FA enabled
TEXT!
Package manager 2FA enabled
TEXT!
Is security responsive
TEXT!
Dependencies are managed
TEXT!
Issue-free release available
TEXT!
Succession plan available
TEXT!
Package manager 2FA enabled
TEXT!

The Tidelift Subscription provides access to a continuously curated stream of human-researched and maintainer-verified data on open source packages and their licenses, releases, vulnerabilities, and development practices.

Learn more →

Releases

0.3.2
0.3.1
0.3.0
0.2.3
0.2.2
0.2.1
0.2.0
0.1.1
0.1.0

Something wrong with this page? Make a suggestion

Export .ABOUT file for this package

Last synced: 2023-03-21 20:24:50 UTC

Login to resync this project