Merge pull request #48 from KeenS/devtools

開発ツールの整備

Author: KeenS

tools/watch.sh

@@ -1,7 +1,48 @@
 #!/bin/sh
-VERSION=$1
-DIR=$(cd "$(dirname "$0")"; pwd)
-ROOT="${DIR}/../"
+usage() {
+    cat <<HELP
+NAME:
+   $0 -- watch document dir and build the book
+
+SYNOPSIS:
+  $0 <version>
+  $0 [-h|--help]
+
+DESCRIPTION:
+  A watch and build script.
+  This uses 'rustbook' command, and use 'RUSTBOOK' as the path if set.
+
+  -h  --help    Print this help.
+
+EXAMPLE:
+  watch and build 1.6
+
+  $ RUSTBOOK=/path/to/rustbook $0 1.6
+
+HELP
+}
+
+
+main() {
+    case "$1" in
+        -h|--help) usage; exit 0;;
+    esac
+
+    if command -v inotifywait > /dev/null 2>&1 ||
+           command -v fswatch > /dev/null 2>&1
+    then
+        echo "You need to install 'inotifywait'(in inotify-tools) on Linux or 'fswatch' on OS X" >&2
+        exit 1
+    fi
+
+    : ${RUSTBOOK:=rustbook}
+    VERSION=$1
+    DIR=$(cd "$(dirname "$0")"; pwd)
+    ROOT="${DIR}/../"
+    build
+    watch "${ROOT}/${VERSION}/ja"
+}
+
 
 build() {
     make -C "${ROOT}" RUSTBOOK=${RUSTBOOK}
@@ -27,5 +68,4 @@ watch(){
     esac
 }
 
-
-watch "${ROOT}/${VERSION}/ja"
+main "$@"

tools/watch_and_serve.sh

@@ -1,9 +1,47 @@
 #!/bin/sh
-RUBY=ruby
-ROOT=$(cd "$(dirname "$0")"; pwd)
+usage() {
+    cat <<HELP
+NAME:
+   $0 -- watch document dir, build the book and serve built HTML
 
-trap "trap - SIGTERM && kill -- -$$" SIGINT SIGTERM EXIT
+SYNOPSIS:
+  $0 <version>
+  $0 [-h|--help]
 
-"$RUBY" -run -e httpd -- . --port 8080 &
-"$ROOT/watch.sh" "$1"
+DESCRIPTION:
+  A watch and build and serve script.
+  The server will listen on localhost:8080 and document root will be 'public' dir.
+  This uses 'rustbook' command.
+  You can pass the 'rustbook' path via 'RUSTBOOK' env var.
 
+  -h  --help    Print this help.
+
+EXAMPLE:
+  watch and build then serve HTML of 1.6
+
+  $ RUSTBOOK=/path/to/rustbook $0 1.6
+
+BUGS:
+  Server program might survive even after you INTed this program.
+  Pathes are wellcome!
+
+
+HELP
+}
+
+main() {
+    case "$1" in
+        -h|--help) usage; exit 0;;
+    esac
+
+    RUBY=ruby
+    DIR=$(cd "$(dirname "$0")"; pwd)
+    ROOT="${DIR}/../"
+
+    trap "trap - SIGTERM && kill -- -$$" SIGINT SIGTERM EXIT
+
+    "$RUBY" -run -e httpd -- "${ROOT}/public" --port 8080 &
+    "$DIR/watch.sh" "$@"
+}
+
+main "$@"