Output "Overall result" line at the end

Example:

```
$ ./bash_unit tests/test_tap_format
Running tests in tests/test_tap_format
/home/wolfram/src/bash_unit/tests
	Running test_assertion_message_is_tap_formatted ... SUCCESS ✓
	Running test_bash_unit_accepts_tap_format_option ... SUCCESS ✓
	Running test_bash_unit_rejects_invalid_format ... SUCCESS ✓
	Running test_multi_lines_assertion_message_is_tap_formatted ... SUCCESS ✓
	Running test_tap_format_for_failing_test_with_stdout_stderr_outputs ... SUCCESS ✓
	Running test_tap_format_for_one_failing_test ... SUCCESS ✓
	Running test_tap_format_for_one_pending_test ... SUCCESS ✓
	Running test_tap_format_for_one_succesfull_test ... SUCCESS ✓
Overall result: PASS ✓
```

So when you've got a lot of tests (more than a screenful) you don't
have to scroll up or check $? to tell if any test has failed.

Author: Wolfram Rösler

README.adoc

@@ -102,6 +102,7 @@ Running tests in tests/test_core.sh
 	Running test_fake_echo_stdin_when_no_params ... SUCCESS
 	Running test_fake_exports_faked_in_subshells ... SUCCESS
 	Running test_fake_transmits_params_to_fake_code ... SUCCESS
+Overall result: PASS
 ```
 
 You might also want to run only specific tests, you may do so with the
@@ -127,6 +128,18 @@ Running tests in tests/test_core.sh
 	Running test_assert_status_code_succeeds ... SUCCESS
 	Running test_assert_succeeds ... SUCCESS
 	Running test_fail_fails ... SUCCESS
+Overall result: PASS
+```
+
+The "Overall result:" line at the end can be suppressed with the _-o_ option:
+
+```test
+./bash_unit -o -p test_assert_succeeds tests/test_core.sh
+```
+
+```output
+Running tests in tests/test_core.sh
+	Running test_assert_succeeds ... SUCCESS
 ```
 
 *bash_unit* supports the http://testanything.org/[Test Anything Protocol] so you can ask for a tap formatted

bash_unit

@@ -348,8 +348,9 @@ tap_format() {
 output_format=text
 test_pattern=""
 separator=""
+overall=1
 randomise=0
-while getopts "vp:f:r" option
+while getopts "vp:f:or" option
 do
   case "$option" in
     p)
@@ -359,6 +360,9 @@ do
     f)
       output_format="${OPTARG}"
       ;;
+    o)
+      overall=0
+      ;;
     r)
       randomise=1
       ;;
@@ -385,6 +389,7 @@ case "$output_format" in
     ;;
   tap)
     tap_format
+    overall=0
     ;;
   *)
     usage "unsupported output format: $output_format"
@@ -411,4 +416,18 @@ do
   )
   failure=$(( $? || failure))
 done
+
+# Show the overall result
+if ((overall))
+then
+  echo -n "Overall result: "
+  if ((failure))
+  then
+    echo -n "FAIL" | pretty_failure
+  else
+    echo -n "PASS" | pretty_success
+  fi
+  echo
+fi
+
 exit $failure

tests/test_cli.sh

@@ -6,7 +6,8 @@ test_run_all_tests_even_in_case_of_failure() {
 Running tests in code
 	Running test_fails ... FAILURE
 code:2:test_fails()
-	Running test_succeed ... SUCCESS\
+	Running test_succeed ... SUCCESS
+Overall resultcode: FAIL\
 " \
 "$(bash_unit_out_for_code << EOF
   function test_succeed() { assert true ; }
@@ -42,7 +43,8 @@ test_run_all_file_parameters() {
 Running tests in test_file
 	Running test_one ... SUCCESS
 Running tests in test_file
-	Running test_two ... SUCCESS\
+	Running test_two ... SUCCESS
+Overall result: PASS\
 " \
 "$bash_unit_output"
 }
@@ -57,7 +59,8 @@ test_run_only_tests_that_match_pattern() {
   assert_equals "\
 Running tests in test_file
 	Running test_one ... SUCCESS
-Running tests in test_file" "$bash_unit_output" 
+Running tests in test_file
+Overall result: PASS" "$bash_unit_output"
 }
 
 test_do_not_run_pending_tests() {
@@ -77,7 +80,8 @@ test_pending_tests_appear_in_output() {
   assert_equals "\
 Running tests in test_file
 	Running pending_should_not_run ... PENDING
-	Running todo_should_not_run ... PENDING" \
+	Running todo_should_not_run ... PENDING
+Overall result: PASS" \
   "$bash_unit_output"
 }