You probably never think of it but behind every bash script stands tons of if-else statements which are responsible for whole script logic, as error gates or even correctness of operations. What if I told you that bash shell does not really interpret if statements itself? A test library serves that purpose and this is what this article is really about.
Testing library usually located at
/usr/bin/test is a GNU util which is responsible for comparing expressions and values against each other. The result of the comparison is an
exit code of
1, depending whether the operation was successful. Here is an example that demonstrates that behavior:
$ test 3 -gt 2 ; echo $? 0 $ test 1 -gt 2 ; echo $? 1
Let’s describe what is happening in that simple test in details.
testlibrary gets called with three arguments:
- first expression
- type of comparison (there
- second expression
- Semicolon says we want to wait for the last operation to end.
echo $?checks the status code of the previous operation.
0means that it was successful and no errors occurred.
But you need square braces in if statements, no?
Bash serves multiple ways to write if statements, one of them is calling them using
if keyword and square braces, like so:
if [ -n "$VARIABLE" ]; then echo 'variable exists' fi
What actually happens behind the curtain is something like this:
[ -n "$VARIABLE" ] && echo 'variable exists'
Which means pretty much the same as:
test -n "$VARIABLE" && echo 'variable exists'
Quote from the
info test documentation
test has an alternate form that uses opening and closing square brackets instead a leading ‘test’. For example, instead of ‘test -d /’, you can write ‘[ -d / ]’. The square brackets must be separate arguments; for example, ‘[-d /]’ does not have the desired effect. Since ‘test expr’ and ‘[ expr ]’ have the same meaning, only the former form is discussed below.
What about other operations?
Many developers has troubles to figure out what flags are actually supported. Use provided manuals. I can’t think of how often it saved my ass to just look for the flag I need instead of craft something myself. GNU
man is awesome for that type of a thing along with
$ man test
That will pop-up full fledged manual for all possible use cases for test library, i.e. join two expressions
test 3 -gt 2 -a 3 -gt 1 thanks to
I really encourage you to check what else
test can do in your bash scripts and try to use it in various ways as much as possible, it’s single the most useful library you’ll ever use in that field. The more standard and well tested your tools are, the safer your scripts will be!
By Mateusz Reszka