UNIX command-line tool for bash/shell utils unit testing
Author: Pahaz Blinov
BashTest is a UNIX command-line tool for the testing bash/shell utilites.
This is a simplest way to write simple bash tests.
requirements: Python2 or Python3
keywords: bash unittest, unittesting, bash tesing, sh unit testing
bashtest is on PyPI, so simply run:
pip install bashtest
to have it installed in your environment.
For installing from source, clone the repo and run:
python setup.py install
If you don`t have pip you can install it
Typical use case
You write a text processed util or script and you want to test it.
For example, we want test ls util.
All of we need is create test_ls.bashtest file:
$ ls ./testsuit/list-directory file1 file2.txt file3.py file4.sh
and then run tests
$ bashtest test_ls.bashtest 1 items passed all tests: 1 tests in test_ls.bashtest 1 tests in 1 items. 1 passed and 0 failed. Test passed.
Test README examples
You have a some open source project like this. And of course, as in any good open source project, you have examples. You can automatically check this examples. Just add bashtest README.rst in your CI tests.
You can finde some examples in this project. Please check test_*.bashtest files
- ** 0.0.6 **
- fix! bad command escaping bug #5
usage: bashtest [-h] [--exitcode] [--no-blankline-substitution] [--no-normalize-whitespace] [-v] [-q] [--version] file [file ...] BashTest is a UNIX command-line tool for running text-based bash tests. positional arguments: file Input file optional arguments: -h, --help show this help message and exit --exitcode Print exitcode after command end of output --no-blankline-substitution Substitute `<BLANKLINE>` if an expected output block contains a line containing only the `\n` --no-normalize-whitespace All sequences of whitespace (blanks and newlines) are not equal -v, --verbose -q, --quiet --version Print the version string
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.