Merge pull request #2 from glvr182/feature/mustparsers

Parser: Added parse functions
Example: Added examples

examples/main.go

@@ -6,6 +6,7 @@ import (
 	"github.com/awesome-gocui/keybinding"
 )
 
+// show will call the ParseAll function
 func show(keyStr string) {
 	keys, err := keybinding.ParseAll(keyStr)
 	if err != nil {
@@ -15,9 +16,29 @@ func show(keyStr string) {
 	}
 }
 
+// must will call the MustParseAll function
+func must(keyStr string) {
+	defer func() {
+        if r := recover(); r != nil {
+            fmt.Println("Error caught: ", r)
+        }
+	}()
+
+	keys := keybinding.MustParseAll(keyStr)
+	fmt.Println("Key: ", keyStr, "=", keys)
+}
+
 func main() {
+	fmt.Println("The show calls:")
 	show("ctrl+a")
 	show("ctrl+b")
 	show("ctrl+/, tab")
 	show("ctrl+   alt +/")
+	show("jibber+   jabber +/") // This will fail
+	fmt.Println("The must calls:")
+	must("ctrl+a")
+	must("ctrl+b")
+	must("ctrl+/, tab")
+	must("ctrl+   alt +/")
+	must("jibber+   jabber +/") // This will fail
 }

keybinding.go

@@ -169,6 +169,23 @@ func ParseAll(input string) ([]Key, error) {
 	return ret, nil
 }
 
+
+func MustParse(input string) Key {
+	if key, err := Parse(input); err != nil {
+		panic(err)
+	} else {
+		return key
+	}
+}
+
+func MustParseAll(input string) []Key {
+	if key, err := ParseAll(input); err != nil {
+		panic(err)
+	} else {
+		return key
+	}
+}
+
 func (key Key) String() string {
 	displayTokens := make([]string, 0)
 	prefix := ""