added assertContains() fn

CHANGELOG

@@ -1,3 +1,6 @@
+v1.2, 2016-06-13
+	- added assertContains() fn
+
 v1.1, 2016-05-28
 	- added add_cleanup() helper fn
 	- support multiple prepare_subshell() calls per test

README.md

@@ -34,6 +34,7 @@ Starting 00-test-compile...
 Success: 00-test-compile
 ```
 
+
 # Package structure
 
 Test scripts only need to source the *init.sh* file to be operational.
@@ -83,6 +84,10 @@ exiting with a return status of 99.
 * `assertEq valueActual valueExpected [errorMessage]`  
 	This assertion compares two strings and tests them for equality.
 
+* `assertContains valueActual valueExpectedPart [errorMessage]`  
+	This assertion compares two strings,
+	expecting the second to be contained somewhere in the first.
+
 * `assertEmpty valueActual [errorMessage]`  
 	This assertion tests a string, expecting it to be empty.
 

assert.sh

@@ -118,6 +118,22 @@ assertEq () {
 	fi
 }
 
+# assertContains valueActual valueExpectedPart [errorMessage]
+#  This assertion compares two strings,
+#  expecting the second to be contained somewhere in the first.
+assertContains () {
+	local valueActual="$1"
+	local valueExpectedPart="$2"
+	local errorMessage="${3:-"Substring assertion failed!"}"
+	case "$valueActual" in
+		*"$valueExpectedPart"*) true ;;  # ok
+		*)
+			err "$errorMessage"
+			err "(Expected '$valueExpectedPart' is not contained in '$valueActual')"
+			abort ;;
+	esac
+}
+
 # assertEmpty valueActual [errorMessage]
 #  This assertion tests a string, expecting it to be empty.
 assertEmpty () {