test: Make sure our examples build

Since there are occasional API changes, I'd like to at least remember to
keep the examples building, so we now have a test to remind us!

test/test-examples.sh

@@ -0,0 +1,43 @@
+#!/bin/bash
+# check that our examples still build, even if we don't run them here
+
+. test/util.sh
+
+echo running test-examples.sh
+
+failures=''
+function run-test()
+{
+	$@ || failures=$( [ -n "$failures" ] && echo "$failures\\n$@" || echo "$@" )
+}
+
+ROOT="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && cd .. && pwd )"	# dir!
+cd "${ROOT}"
+
+buildout='test-examples.out'
+# make symlink to outside of package
+linkto="`pwd`/examples/lib/"
+tmpdir="`mktemp --tmpdir -d tmp.XXX`"	# get a dir outside of the main package
+cd "$tmpdir"
+ln -s "$linkto"	# symlink outside of dir
+cd `basename "$linkto"`
+
+# loop through individual *.go files in working dir
+for file in `find . -maxdepth 3 -type f -name '*.go'`; do
+	#echo "running test on: $file"
+	run-test go build -i -o "$buildout" "$file" || fail_test "could not build: $file"
+done
+rm "$buildout" || true	# clean up build mess
+
+cd -	# back to tmp dir
+rm `basename "$linkto"`
+cd ..
+rmdir "$tmpdir"	# cleanup
+
+if [[ -n "$failures" ]]; then
+	echo 'FAIL'
+	echo 'The following tests have failed:'
+	echo -e "$failures"
+	exit 1
+fi
+echo 'PASS'