Add stub_called_times function

test/stub_called_times-test.sh

@@ -0,0 +1,39 @@
+#! /usr/bin/env bash
+source "test-helper.sh"
+
+#
+# stub_called_times() tests.
+#
+
+# Echoes 0 if the command isn't stubed.
+assert 'stub_called_times "top"' "0"
+
+# Echoes the number of times a stub was called.
+stub "uname"
+assert 'stub_called_times "uname"' "0"
+uname
+assert 'stub_called_times "uname"' "1"
+uname
+assert 'stub_called_times "uname"' "2"
+uname
+assert 'stub_called_times "uname"' "3"
+restore "uname"
+
+# Echoes 0 after a called stub has been restored.
+stub "uname"
+uname
+assert 'stub_called_times "uname"' "1"
+restore "uname"
+assert 'stub_called_times "uname"' "0"
+
+# When given a second argument, asserts stub called X number of times.
+stub "uname"
+uname
+assert_raises 'stub_called_times "uname" 1' 0
+assert 'stub_called_times "uname" 1' ""
+assert_raises 'stub_called_times "uname" 3' 1
+assert 'stub_called_times "uname" 3' ""
+restore "uname"
+
+# End of tests.
+assert_end "stub_called_times()"