Implement REST API v1

- Add rest package with REST-only controller, tests
- Remove individual shell scripts in favor of rest-apivh1.sh

etc/rest-apiv1.sh

@@ -0,0 +1,108 @@
+#!/bin/bash
+# rest-apiv1.sh
+# description: Script to access Inbucket REST API version 1
+
+API_HOST="localhost"
+URL_ROOT="http://$API_HOST:9000/api/v1"
+
+set -eo pipefail
+[ $TRACE ] && set -x
+
+usage() {
+  echo "Usage: $0 <command> [argument1 [argument2 [..]]]"               >&2
+  echo                                                                  >&2
+  echo "Options:"                                                       >&2
+  echo "  -h                       - show this help"                    >&2
+  echo "  -i                       - show HTTP headers"                 >&2
+  echo                                                                  >&2
+  echo "Commands:"                                                      >&2
+  echo "  list <mailbox>           - list mailbox contents"             >&2
+  echo "  body <mailbox> <id>      - print message body"                >&2
+  echo "  source <mailbox> <id>    - print message source"              >&2
+  echo "  delete <mailbox> <id>    - delete message"                    >&2
+  echo "  purge <mailbox>          - delete all messages in mailbox"    >&2
+}
+
+arg_check() {
+  declare command="$1" expected="$2" received="$3"
+  if [ $expected != $received ]; then
+    echo "Error: Command '$command' requires $expected arguments, but received $received" >&2
+    echo >&2
+    usage
+    exit 1
+  fi
+}
+
+main() {
+  # Process options
+  local curl_opts=""
+  for arg in $*; do
+    if [[ $arg == -* ]]; then
+      case "$arg" in
+        -h)
+          usage
+          exit
+          ;;
+        -i)
+          curl_opts="$curl_opts -i"
+          ;;
+        **)
+          echo "Unknown option: $arg" >&2
+          echo
+          usage
+          exit 1
+          ;;
+      esac
+      shift
+    else
+      break
+    fi
+  done
+
+  # Store command
+  declare command="$1"
+  shift
+
+  local url=""
+  local method="GET"
+
+  case "$command" in
+    body)
+      arg_check "$command" 2 $#
+      url="$URL_ROOT/mailbox/$1/$2"
+      ;;
+    delete)
+      arg_check "$command" 2 $#
+      method=DELETE
+      url="$URL_ROOT/mailbox/$1/$2"
+      ;;
+    list)
+      arg_check "$command" 1 $#
+      url="$URL_ROOT/mailbox/$1"
+      ;;
+    purge)
+      arg_check "$command" 1 $#
+      method=DELETE
+      url="$URL_ROOT/mailbox/$1"
+      ;;
+    source)
+      arg_check "$command" 2 $#
+      url="$URL_ROOT/mailbox/$1/$2/source"
+      ;;
+    *)
+      echo "Unknown command $command" >&2
+      echo >&2
+      usage
+      exit 1
+      ;;
+  esac
+
+  curl $curl_opts -H "Accept: application/json" --noproxy "$API_HOST" -X "$method" "$url"
+}
+
+if [ $# -lt 1 ]; then
+  usage
+  exit 1
+fi
+
+main $*