Adding several other examples

Author: pgrange

getting_started/hello_i18n

@@ -0,0 +1,17 @@
+#!/usr/bin/env bash
+
+main() {
+  hello "$1"
+}
+
+hello() {
+  case "$1" in
+    fr) echo Bonjour le monde
+        ;;
+     *) echo we only speak french for the moment, sorry >&2
+        ;;
+  esac
+}
+
+# do not run main when sourcing the script
+[[ "$0" == "${BASH_SOURCE[0]}" ]] && main "$@" || true

getting_started/hello_timed

@@ -0,0 +1,15 @@
+#!/usr/bin/env bash
+
+declare -F current_hour >/dev/null || current_hour() {
+  date +%H
+}
+
+if (( "$(current_hour)" < 11 ))
+then
+  echo "Good morning World!"
+else if (( "$(current_hour)" > 17 ))
+then
+  echo "Good evening World!"
+else
+  echo "Hello World!"
+fi ; fi

getting_started/tests/test_hello_i18n

@@ -0,0 +1,19 @@
+# In this example, we want to test the specific functions of a script.
+# So we source this script in setup_suite.
+# However, we don't want the script to be executed when sourcing it,
+# we are only interested in having access to the functions to tests
+# them.
+# To do so, we adapt the script under test so that it's main code
+# is not executed when sourcing it.
+# See ../hello_i18n how we define a main function to encapsulate
+# all the main code and the main function is only called when the
+# script itself is launched, not when it is sourced
+
+test_can_say_hi_in_french() {
+  assert_equals "Bonjour le monde" "$(hello fr)"
+}
+
+setup_suite() {
+  source ../hello_i18n
+}
+

getting_started/tests/test_hello_timed

@@ -0,0 +1,32 @@
+# In this example, we want to test a script which depends on
+# the external world (here, the current time). To do so,
+# we decide to adapt the script by extracting the time
+# querying in a dedicated function named current_hour.
+# That way, we can fake the current hour in the test.
+# Unfortunately, we also need to adapt the script under
+# test so that, when the current_time function is already
+# defined, it does not override it. Otherwise, the fake created
+# in the test would never be used. See ../hello_timed
+
+
+test_can_say_good_morning() {
+  it_is_o_clock 10
+  assert_equals "Good morning World!" "$(../hello_timed)"
+}
+
+test_can_say_good_evening() {
+  it_is_o_clock 18
+  assert_equals "Good evening World!" "$(../hello_timed)"
+}
+
+test_can_say_hello() {
+  it_is_o_clock 12
+  assert_equals "Hello World!" "$(../hello_timed)"
+}
+
+it_is_o_clock() {
+  local hour="$1"
+  fake current_hour << EOF
+$hour
+EOF
+}