Initial commit

test/assert.sh

@@ -0,0 +1,139 @@
+#!/bin/bash
+# assert.sh 1.0 - bash unit testing framework
+# Copyright (C) 2009, 2010, 2011, 2012 Robert Lehmann
+#
+# http://github.com/lehmannro/assert.sh
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU Lesser General Public License as published
+# by the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+export DISCOVERONLY=${DISCOVERONLY:-}
+export DEBUG=${DEBUG:-}
+export STOP=${STOP:-}
+export INVARIANT=${INVARIANT:-}
+
+args="$(getopt -n "$0" -l verbose,help,stop,discover,invariant vhxdi $*)" \
+|| exit -1
+for arg in $args; do
+    case "$arg" in
+        -h)
+            echo "$0 [-vxid] [--verbose] [--stop] [--invariant] [--discover]"
+            echo "`sed 's/./ /g' <<< "$0"` [-h] [--help]"
+            exit 0;;
+        --help)
+            cat <<EOF
+Usage: $0 [options]
+Language-agnostic unit tests for subprocesses.
+
+Options:
+  -v, --verbose    generate output for every individual test case
+  -x, --stop       stop running tests after the first failure
+  -i, --invariant  do not measure timings to remain invariant between runs
+  -d, --discover   collect test suites only, do not run any tests
+  -h               show brief usage information and exit
+  --help           show this help message and exit
+EOF
+            exit 0;;
+        -v|--verbose)
+            DEBUG=1;;
+        -x|--stop)
+            STOP=1;;
+        -i|--invariant)
+            INVARIANT=1;;
+        -d|--discover)
+            DISCOVERONLY=1;;
+    esac
+done
+
+printf -v _indent "\n\t" # local format helper
+
+_assert_reset() {
+    tests_ran=0
+    tests_failed=0
+    tests_errors=()
+    tests_starttime="$(date +%s.%N)" # seconds_since_epoch.nanoseconds
+}
+
+assert_end() {
+    # assert_end [suite ..]
+    tests_endtime="$(date +%s.%N)"
+    tests="$tests_ran ${*:+$* }tests"
+    [[ -n "$DISCOVERONLY" ]] && echo "collected $tests." && _assert_reset && return
+    [[ -n "$DEBUG" ]] && echo
+    [[ -z "$INVARIANT" ]] && report_time=" in $(bc \
+        <<< "${tests_endtime%.N} - ${tests_starttime%.N}" \
+        | sed -e 's/\.\([0-9]\{0,3\}\)[0-9]*/.\1/' -e 's/^\./0./')s" \
+        || report_time=
+
+    if [[ "$tests_failed" -eq 0 ]]; then
+        echo "all $tests passed$report_time."
+    else
+        for error in "${tests_errors[@]}"; do echo "$error"; done
+        echo "$tests_failed of $tests failed$report_time."
+    fi
+    tests_failed_previous=$tests_failed
+    _assert_reset
+    return $tests_failed_previous
+}
+
+assert() {
+    # assert <command> <expected stdout> [stdin]
+    (( tests_ran++ ))
+    [[ -n "$DISCOVERONLY" ]] && return
+    # printf required for formatting
+    printf -v expected "x${2:-}" # x required to overwrite older results
+    result="$(eval 2>/dev/null $1 <<< ${3:-})"
+    # Note: $expected is already decorated
+    if [[ "x$result" == "$expected" ]]; then
+        [[ -n "$DEBUG" ]] && echo -n .
+        return
+    fi
+    [[ -n "$DEBUG" ]] && echo -n X
+    result="$(sed -e :a -e '$!N;s/\n/\\n/;ta' <<< "$result")"
+    [[ -z "$result" ]] && result="nothing" || result="\"$result\""
+    [[ -z "$2" ]] && expected="nothing" || expected="\"$2\""
+    failure="expected $expected${_indent}got $result"
+    report="test #$tests_ran \"$1${3:+ <<< $3}\" failed:${_indent}$failure"
+    tests_errors[$tests_failed]="$report"
+    (( tests_failed++ ))
+    if [[ -n "$STOP" ]]; then
+        [[ -n "$DEBUG" ]] && echo
+        echo "$report"
+        exit 1
+    fi
+}
+
+assert_raises() {
+    # assert_raises <command> <expected code> [stdin]
+    (( tests_ran++ ))
+    [[ -n "$DISCOVERONLY" ]] && return
+    (eval $1 <<< ${3:-}) > /dev/null 2>&1
+    status=$?
+    expected=${2:-0}
+    if [[ "$status" -eq "$expected" ]]; then
+        [[ -n "$DEBUG" ]] && echo -n .
+        return
+    fi
+    [[ -n "$DEBUG" ]] && echo -n X
+    failure="program terminated with code $status instead of $expected"
+    report="test #$tests_ran \"$1${3:+ <<< $3}\" failed:${_indent}$failure"
+    tests_errors[$tests_failed]="$report"
+    (( tests_failed++ ))
+    if [[ -n "$STOP" ]]; then
+        [[ -n "$DEBUG" ]] && echo
+        echo "$report"
+        exit 1
+    fi
+}
+
+_assert_reset

test/restore-test.sh

@@ -0,0 +1,47 @@
+#! /usr/bin/env bash
+source "test-helper.sh"
+
+#
+# restore() tests.
+#
+
+
+# Stubbing and restoring a bash function.
+my-name-is() { echo "My name is $@."; }
+assert "my-name-is Edward Elric" "My name is Edward Elric."
+
+stub "my-name-is"
+assert "my-name-is Edward Elric" "my-name-is stub: Edward Elric"
+
+restore "my-name-is"
+assert "my-name-is Edward Elric" "My name is Edward Elric."
+
+
+# Stubbing and restoring a executable file.
+actual_uname="$(uname)"
+stub "uname"
+assert "uname" "uname stub: "
+assert "uname -a" "uname stub: -a"
+
+restore "uname"
+assert "uname" "$actual_uname"
+
+
+# Stubbing and restoring something that doesn't exist.
+assert_raises "cowabunga-dude" 127
+stub "cowabunga-dude"
+assert_raises "cowabunga-dude" 0
+restore "cowabunga-dude"
+assert_raises "cowabunga-dude" 127
+
+
+# Attempting to restore a function that wasn't stubbed.
+my-name-is() { echo "My name is $@."; }
+assert "my-name-is Edward Elric" "My name is Edward Elric."
+
+restore "my-name-is"
+assert "my-name-is Edward Elric" "My name is Edward Elric."
+
+
+# End of tests.
+assert_end "restore()"

test/stub-test.sh

@@ -0,0 +1,40 @@
+#! /usr/bin/env bash
+source "test-helper.sh"
+
+#
+# stub() tests.
+#
+
+
+# Stubbing a bash function.
+my-name-is() { echo "My name is $@."; }
+assert "my-name-is Edward Elric" "My name is Edward Elric."
+
+stub "my-name-is"
+assert "my-name-is" "my-name-is stub: "
+assert "my-name-is Edward" "my-name-is stub: Edward"
+assert "my-name-is Edward Elric" "my-name-is stub: Edward Elric"
+unset -f my-name-is
+
+
+# Stubbing a executable file.
+stub "uname"
+assert "uname" "uname stub: "
+assert "uname -h" "uname stub: -h"
+unset -f uname
+
+
+# Redirect stub output to STDERR.
+my-name-is() { echo "My name is $@."; }
+stub "my-name-is" STDERR
+assert "my-name-is Edward" ""
+assert "my-name-is Edward 2>&1" "my-name-is stub: Edward"
+
+
+# Stubbing something that doesn't exist.
+stub "cowabunga-dude"
+assert "cowabunga-dude yeah dude" "cowabunga-dude stub: yeah dude"
+
+
+# End of tests.
+assert_end "stub()"

test/stub_and_echo-test.sh

@@ -0,0 +1,41 @@
+#! /usr/bin/env bash
+source "test-helper.sh"
+
+#
+# stub_and_echo() tests.
+#
+
+
+# Stubbing a bash function.
+my-name-is() { echo "My name is $@."; }
+assert "my-name-is Edward Elric" "My name is Edward Elric."
+
+stub_and_echo "my-name-is" "Hohenheim"
+assert "my-name-is" "Hohenheim"
+assert "my-name-is Edward" "Hohenheim"
+assert "my-name-is Edward Elric" "Hohenheim"
+unset -f my-name-is
+
+
+# Stubbing a executable file.
+stub_and_echo "uname" "State Alchemist"
+assert "uname" "State Alchemist"
+assert "uname -h" "State Alchemist"
+unset -f uname
+
+
+# Redirect stub output to STDERR.
+my-name-is() { echo "My name is $@."; }
+stub_and_echo "my-name-is" "Hohenheim" STDERR
+assert "my-name-is Edward" ""
+assert "my-name-is Edward 2>&1" "Hohenheim"
+
+
+# Stubbing something that doesn't exist.
+stub_and_echo "cowabunga-dude" "Surf's up dude :D"
+assert "cowabunga-dude" "Surf's up dude :D"
+assert "cowabunga-dude yeah dude" "Surf's up dude :D"
+
+
+# End of tests.
+assert_end "stub_and_echo()"

test/stub_and_eval-test.sh

@@ -0,0 +1,34 @@
+#! /usr/bin/env bash
+source "test-helper.sh"
+
+#
+# stub_and_eval() tests.
+#
+
+
+# Stubbing a bash function.
+my-name-is() { echo "My name is $@."; }
+assert "my-name-is Edward Elric" "My name is Edward Elric."
+
+stub_and_eval "my-name-is" "date +%Y"
+assert "my-name-is" "$(date +%Y)"
+assert "my-name-is Edward" "$(date +%Y)"
+assert "my-name-is Edward Elric" "$(date +%Y)"
+unset -f my-name-is
+
+
+# Stubbing a executable file.
+stub_and_eval "uname" "date +%Y"
+assert "uname" "$(date +%Y)"
+assert "uname -h" "$(date +%Y)"
+unset -f uname
+
+
+# Stubbing something that doesn't exist.
+stub_and_eval "cowabunga-dude" "date +%Y"
+assert "cowabunga-dude" "$(date +%Y)"
+assert "cowabunga-dude yeah dude" "$(date +%Y)"
+
+
+# End of tests.
+assert_end "stub_and_eval()"

test/test-helper.sh

@@ -0,0 +1,9 @@
+[ -n "$TEST_DEBUG" ] && set -x
+
+# Set testroot variable.
+testroot="$(dirname "$BASH_SOURCE")"
+
+# Include assert.sh testing library.
+source "$testroot/assert.sh"
+source "$testroot/../stub.sh"
+