added basic usage help to CLI

Author: holgerbrandl

README.md

@@ -66,22 +66,22 @@ Inline Usage
 
 You can even inline `kscript` solutions into larger scripts, because `kscript` can read from stdin as well. So, depdending your preference you could simply pipe a kotlin snippet into `kscript`
 
-```
+```{bash}
 echo '
 println("hello kotlin")
-' |  kscript
+' |  kscript -
 ```
 
 
 or do the same using `heredoc` (preferred solution) which gives you some more flexibility to also use single quotes in your script:
-```
+```{bash}
 kscript - <<"EOF"
 println("hello kotlin and heredoc")
 EOF
 ```
 
 Since the piped content is considered as a regular script it can also have dependencies
-```
+```{bash}
 kscript - <<"EOF"
 //DEPS org.docopt:docopt:0.6.0-SNAPSHOT log4j:log4j:1.2.14
 
@@ -92,6 +92,11 @@ println("hello again")
 EOF
 ```
 
+Finally (for sake of completeness) it also works with process substitution
+```{bash}
+kscript  <(echo 'println("k-onliner")')
+```
+
 Inlined _kscripts_ are also cached based on `md5` checksum, so running the same snippet again will use a cached jar (sitting in `$TMPDIR`).
 
 

examples/unit_tests.sh

@@ -19,8 +19,8 @@ expandcp.kts org.docopt:docopt:0.6.0-SNAPSHOT
 
 ## (1) via pipe
 echo '
-println(1+1)
-' |  kscript
+println(1+3)
+' |  kscript -
 
 
 ## (2) heredoc

kscript

@@ -3,6 +3,20 @@
 KSCRIPT_VERSION=1.0
 
 
+## Show basic CLI description if no arguments are provided
+if [ $# == 0 ]  || [ $1 == "-v" ] || [ $1 == "--version" ] || [ $1 == "-h" ] || [ $1 == "--help" ]; then
+    echo "Usage     : kscript <scriptfile or - for stdin> [<script_args>]+" >&2
+    echo "" >&2
+    echo "Easy-to-use scripting support for Kotlin on *nix-based systems." >&2
+    echo "" >&2
+    echo "Copyright : 2016 Holger Brandl"
+    echo "License   : Simplified BSD" >&2
+    echo "Version   : v$KSCRIPT_VERSION" >&2
+    echo "Website   : https://github.com/holgerbrandl/kscript" >&2
+    exit 1;
+fi
+
+
 ## ... or use a cached version of it if possible
 #scriptFile="./test.kts"
 scriptFile=$1
@@ -21,10 +35,11 @@ if [ "$scriptFile" == "-" ]; then scriptFile="/dev/stdin"; fi
 ## Rather Test if script ends with kts to also support process substitution here. Wrap stdin
 # http://serverfault.com/questions/52034/what-is-the-difference-between-double-and-single-square-brackets-in-bash
 # https://viewsby.wordpress.com/2013/09/06/bash-string-ends-with/
+
 if [[ "$scriptFile" != *kts ]]; then
     tmpScript=${TMPDIR=/tmp}/kscript_stdin_$(mktemp -d XXXXXXXXX).kts # odd but works on macos as well
 #    tmpScript=/tmp/kscript_stdin_$(mktemp -d XXXXXXXXX).kts # odd but works on macos as well
-    cat ${scriptFile} > ${tmpScript}
+    cat "${scriptFile}" > ${tmpScript}
 
     ## rename to use checksum as name to allow for jar-caching also when using stdin
     stdinMD5=$(md5sum ${tmpScript} | cut -c1-6)