Add examples

Author: oprypin

.gitignore

@@ -1,16 +1,15 @@
 *
 !.gitignore
-
+!*.nim
+/*.nim
 !*.nimble
 !*.docopt
 !*.md
 !nim.cfg
 !README*
 !LICENSE
 !/src
-!/src/*.nim
 !/src/private
-!/src/private/*.nim
 !/test
-!/test/*.nim
+!/examples
 !/circle.yml

README.md

@@ -25,14 +25,17 @@ Options:
   --drifting    Drifting mine.
 """
 
-import tables, strutils
+import strutils
 import docopt
 
 let args = docopt(doc, version = "Naval Fate 2.0")
 
 if args["move"]:
-  echo "Move ship $# to ($#, $#) at $# kn".format(
+  echo "Moving ship $# to ($#, $#) at $# kn".format(
     args["<name>"], args["<x>"], args["<y>"], args["--speed"])
+  ships[$args["<name>"]].move(
+    parseFloat($args["<x>"]), parseFloat($args["<y>"]),
+    speed = parseFloat($args["--speed"]))
 ```
 
 The option parser is generated based on the docstring above that is passed to `docopt` function. `docopt` parses the usage pattern (`"Usage: ..."`) and option descriptions (lines starting with dash "`-`") and ensures that the program invocation matches the usage pattern; it parses options, arguments and commands based on that. The basic idea is that *a good help message has all necessary information in it to make a parser*.
@@ -116,6 +119,14 @@ Note that you can use any kind of value in a boolean context and convert any val
 Look [in the source code](src/private/value.nim) to find out more about these conversions.
 
 
+Examples
+--------
+
+See [examples](examples) folder.
+
+For more examples of docopt language see [docopt.py examples][].
+
+
 Installation
 ------------
 
@@ -124,16 +135,7 @@ Installation
 This library has no dependencies outside the standard library. An impure [`re`][re] library is used.
 
 
-Testing
--------
-
-See [test](test) folder.
-
-
-Examples
---------
 
-See [docopt.py examples][]
 
 
 [docopt.org]: http://docopt.org/

examples/counted.nim

@@ -0,0 +1,25 @@
+let doc = """
+Usage: counted --help
+       counted -v...
+       counted go [go]
+       counted (--path=<path>)...
+       counted <file> <file>
+
+Try: counted -vvvvvvvvvv
+     counted go go
+     counted --path ./here --path ./there
+     counted this.txt that.txt
+"""
+
+import strutils
+import docopt
+
+
+let args = docopt(doc)
+echo args
+
+if args["-v"]:
+    echo capitalize(repeat("very ", args["-v"].len - 1) & "verbose")
+
+for path in @(args["--path"]):
+    echo read_file(path)

examples/cycle.nim

@@ -0,0 +1,39 @@
+let doc = """
+Repeatedly output the arguments.
+
+Usage:
+  cycle [options] <what>...
+
+Options:
+  -h --help                show this help message and exit
+  -n <times>               output all the arguments N times [default: infinite]
+  --interval <seconds>     wait after every line of output
+"""
+
+import strutils, os, math
+import docopt
+
+
+let args = docopt(doc)
+echo args
+
+let infinite = ($args["-n"] == "infinite")
+var n: int
+if not infinite:
+    n = parse_int($args["-n"])
+
+var interval = 0
+if args["--interval"]:
+    interval = round(parse_float($args["--interval"])*1000)
+
+while true:
+    for s in @(args["<what>"]):
+        echo s
+        
+        if interval > 0:
+            sleep interval
+    
+    if not infinite:
+        dec n
+        if n <= 0:
+            break

examples/nim.cfg

@@ -0,0 +1 @@
+path: "$project_path/../src"

examples/odd_even.nim

@@ -0,0 +1,18 @@
+let doc = """
+Usage: odd_even [-h | --help] (ODD EVEN)...
+
+Example, try:
+  odd_even 1 2 3 4
+
+Options:
+  -h, --help
+"""
+
+import docopt
+
+
+let args = docopt(doc)
+echo args
+
+for i in 0 .. <args["ODD"].len:
+    echo args["ODD"][i] & " " & args["EVEN"][i]