readme instructions

fatlinesofcode · fatlinesofcode · commit 6d35e88d4355 · 2012-11-20T13:27:02.000+11:00
diff --git a/README.md b/README.md
@@ -1,4 +1,40 @@
 compile-js
 ==========
 
-Bash script wrapper for google closure compiler. Allows for JS files listed in manifest or wildcard directory to be combined and compiled.
+Bash script wrapper for google closure compiler. Allows for JS files listed in manifest or wildcard directory to be combined and compiled.
+Support file modified time checking and only compiles if the source files are newer then the build files.
+
+
+Installation
+==========
+1. Download google closure compiler jar. https://developers.google.com/closure/compiler/
+2. Edit the path to compiler.jar within compile-js.
+3. Edit .profile within terminal and add an alias to compile-js.sh e.g. alias compile-js="~/Sites/libs/closure/compile-js.sh"
+
+Usage
+==========
+
+compile-js [command] [output file] [input file(s)]
+
+Wildcard compile all js files within a directory.
+cd my_js_src; compile-js build ../my_src_build/myapp.min.js
+or
+compile-js build /path/my_src_build/myapp.min.js /path/to/my_src/
+
+Create a manifest list of js files
+cd my_js_src; compile-js list manifest.txt
+or
+compile-js list manifest.txt /path/to/my_src/
+
+Compile js using a manifest file
+cd my_js_src; compile-js build ../my_src_build/myapp.min.js manifest.txt
+or
+compile-js build /path/my_src_build/myapp.min.js /path/to/my_src/manifest.txt
+
+Force re-compile js and ignore modified time
+cd my_js_src; compile-js rebuild ../my_src_build/myapp.min.js manifest.txt
+or
+compile-js rebuild /path/my_src_build/myapp.min.js /path/to/my_src/manifest.txt
+
+
+
diff --git a/compile-js.sh b/compile-js.sh
@@ -0,0 +1,81 @@
+#!/bin/bash
+
+
+#@usage
+#compile-js $command $output $input
+#compile-js build ../html/assets/js/build/xylo.app.min.js *
+#compile-js list manifest.txt
+#compile-js build ../html/assets/js/build/xylo.app.min.js manifest.txt
+#compile-js rebuild ../html/assets/js/build/xylo.app.min.js manifest.txt
+#compile-js build ../html/assets/js/build/xylo.app.min.js booter.js xylo.js service.js
+
+command=$1
+output=$2
+files=''
+list=''
+stale=false
+compiler=~/Sites/libs/closure/compiler.jar
+
+if test -z "$command"
+then
+    echo "Please specify a command."
+fi
+
+
+if [ "$command" == "list" ]
+then
+    for f in $3*.js
+    do
+        list=$list$f'\n'
+        echo -e "$f"
+    done
+    echo -e $list > $output
+fi
+
+if [ "$command" == "rebuild" ]
+then
+    command="build"
+    stale=true
+fi
+
+if [ "$command" == "build" ]
+then
+for f in "$@"
+do
+    if [ "$f" != "$1" ] && [ "$f" != "$2" ] && [[ $f == *.js ]]
+    then
+        files=$files$f' '
+    fi
+done
+
+if test -z "$files"
+then
+    files=`cat $3`
+fi
+
+
+for f in $files ; do
+    list=$list'--js '$f' '
+    if test $f -nt $output
+    then
+    echo $f' is newer then '$output
+    stale=true
+    fi
+done
+
+#echo -e $files
+
+# closure help
+# java -jar compiler.jar -h
+# --compilation_level WHITESPACE_ONLY SIMPLE_OPTIMIZATIONS ADVANCED_OPTIMIZATIONS
+# --externs ../src/js/angular/angular.min.js ../src/js/angular/angular-resource.min.js
+if $stale ; then
+echo "Compiling $output: "
+java -jar $compiler $list --compilation_level SIMPLE_OPTIMIZATIONS --js_output_file $output  --warning_level QUIET --summary_detail_level 3
+echo "completed $output."
+else
+echo "No new files to compile."
+fi
+
+fi
+
