Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rafritts/bunit
A unit testing framework for Shell scripts - namely Bash.
https://github.com/rafritts/bunit
bash bash-scripting shell testing unit-testing unit-testing-framework
Last synced: about 2 months ago
JSON representation
A unit testing framework for Shell scripts - namely Bash.
- Host: GitHub
- URL: https://github.com/rafritts/bunit
- Owner: rafritts
- License: mit
- Created: 2016-06-26T04:22:56.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2022-11-03T16:09:25.000Z (about 2 years ago)
- Last Synced: 2024-08-29T04:01:35.850Z (4 months ago)
- Topics: bash, bash-scripting, shell, testing, unit-testing, unit-testing-framework
- Language: Shell
- Homepage:
- Size: 59.6 KB
- Stars: 196
- Watchers: 10
- Forks: 11
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-bash - bunit - A unit testing framework for Shell scripts - namely Bash. (Applications / Testing)
README
# bunit
...is a unit testing framework for Shell scripts - namely Bash.
This is a very light weight (as in one file) unit testing library for Bash scripts. It functions similarly to Java's JUnit.
You do not need to touch any of your shell scripts to run unit tests against it. That is to say, that your original source code does not need to know about bunit in order for the unit tests to work.
-----
### How to use:
Simply add the following lines underneath your shebang (`#!/bin/bash`) in your unit test file.
`source /../bunit.shl` where it points to the location of the bunit script on your local machine.
`source /../ScriptToTest.sh` where ScriptToTest.sh is the original script you wanted to create unit tests for.
Next, you can create any test case you like, such as:
```
testScriptVariableEquals5 () {
someScriptFunctionThatSetsScriptVarToFive
assertEquals "$ScriptVar" 5
}
```
You can also evaluate that certian conditions have been met, such as a process was started:
```
testMyProcessStarted () {
someScriptFunctionThatStartsMyProcess
assertTrue "pgrep myProcess.sh > /dev/null"
}
```
At the very bottom of your unit test suite, you need to call the function `runUnitTests`.
When you are ready to run your unit test suite, simply run it as you would any other script.
```
./MyUnitTestSuite.ut
```
Or you can run it verbosely using the `-v` or `--verbose` flags, which will print out all test case results, even if they pass.
```
./MyUnitTestSuite.ut -v
./MyUnitTestSuite.ut --verbose
```
-----
### !!! IMPORTANT NOTE !!!
Your unit test suite is a shell script! Therefore, if you run a dangerous command, you are going to get dangerous results! For example,
```
testCanDeleteHomeDirectory() {
rm -rf ~/
assertTrue " ! -d ~ "
}
```
This will absolutely delete your home directory and the assertTrue function will return a valid result, because you just blew away your home directory. Pay attention to your commands!
-----
### Functions included in bunit:
bunit includes most the assert functions found in Java's JUnit.
Specifically:
```
assertEquals expected actual
assertNotEquals expected actual
assertNull "actual"
assertNotNull "actual"
assertTrue "condition expression"
assertFalse "condition expression"
assertContains needle haystack
```
-----
### Notes:
1. Only functions prefixed with `test`, i.e: `test` inside of the unit test suite will be executed by `runUnitTests`.
2. Null is considered to be empty string `""`. The assertNull requires you to enclose your argument in quotes.
3. You must include quotes around conditional expressions. These expressions can be anything that can be evaluated in an if statement condition. Example: `"-f someFile.txt"`
4. The extension `.shl` is an extension I perfer to give to library shell scripts. It stands for `.shellLibrary`.
5. The extension `.ut` is an extension I prefer to give to unit test suites. It stands for `.unitTest`.
6. Both of the above extensions are meaningless from a linux perspective, so you can change them to be whatever you like.
7. If all of your unit tests pass, and you did not run the script with the verbose flag, you will see no output at all.
8. If any of your unit tests fail, the script will exit after all tests have run, with a status code of 1.
9. If you need to test commands that delete files or directories, it is strongly recommended to use a `testSetup()` function at the top of your unit test suite, and use it to create temporary
files or directories that you are intentionally trying to delete. This probably goes without saying but, DO NOT TEST `rm` COMMANDS AGAINST PRODUCTION DATA!!!
10. If you wish, you can also use a `testTearDown()` function at the bottom of your unit test suite, to clean up your tests.
11. You can change the name of `testSetup()` and `testTearDown()`. They are not hard coded. Refer to point #1.
12. Please see the unit tests in `bunit_unit_tests` and in `examples` for more examples