release 0.5.20

.travis.yml

@@ -57,8 +57,8 @@ deploy:
     api_key:
       secure: DNq1wbqLPHVpJPDx9O89HZM+RJB6v2R7/wk8pok7Z8NT72kUWdvbqcThGhczPO4sZ8cUTJ3ergTCE8hs9mynlR/lX6932U4fj4+uICQL9+G+deBB/t2SNyTBllkE64WrJ9BKmQvIk/Chh7ZJOM0Fro3p2BIq3JsVnfYg1tZ3U5o=
     file:
-      - package/chevrotain-binaries-0.5.19.zip
-      - package/chevrotain-binaries-0.5.19.tar.gz
+      - package/chevrotain-binaries-0.5.20.zip
+      - package/chevrotain-binaries-0.5.20.tar.gz
     on:
       tags : true
       all_branches: true

bower.json

@@ -1,6 +1,6 @@
 {
   "name": "chevrotain",
-  "version": "0.5.19",
+  "version": "0.5.20",
   "description": "Chevrotain is a high performance fault Tolerant Javascript parsing DSL for building recursive decent parsers",
   "main": "release/chevrotain.js",
   "dependencies": {},

docs/tutorial/step2_parsing.md

@@ -44,16 +44,16 @@ relationalOperator
 
 A Chevrotain Parser analyses a [Token](https://github.com/SAP/chevrotain/blob/master/src/scan/tokens_public.ts#L61) vector
 that conforms to some grammar.
-The grammar is defined using the [parsing DSL](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#at_least_one),
+The grammar is defined using the [parsing DSL](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#at_least_one),
 Which includes the following methods.
 
-*   [CONSUME](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#consume1) - 'eat' a Token.
-*   [SUBRULE](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#subrule1) - reference to another rule.
-*   [OPTION](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#option1) - optional production. 
-*   [MANY](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#many1) - repetition zero or more.
-*   [AT_LEAST_ONE](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#at_least_one1) - repetition one or more.
-*   [MANY_SEP](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#many_sep1) - repetition (zero or more) with a separator between any two items 
-*   [AT_LEAST_ONE_SEP](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#at_least_one_sep1) - repetition (one or more) with a separator between any two items
+*   [CONSUME](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#consume1) - 'eat' a Token.
+*   [SUBRULE](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#subrule1) - reference to another rule.
+*   [OPTION](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#option1) - optional production. 
+*   [MANY](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#many1) - repetition zero or more.
+*   [AT_LEAST_ONE](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#at_least_one1) - repetition one or more.
+*   [MANY_SEP](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#many_sep1) - repetition (zero or more) with a separator between any two items 
+*   [AT_LEAST_ONE_SEP](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#at_least_one_sep1) - repetition (one or more) with a separator between any two items
 
 
 #### Lets implement our first grammar rule. 

docs/tutorial/step3_adding_actions.md

@@ -18,9 +18,9 @@ validates the input conforms to the grammar. In most real world use cases the pa
 result/data structure/value.
 
 This can be accomplished using two features of the Parsing DSL:
-* [CONSUME](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#consume1) will return
-  The [Token](http://sap.github.io/chevrotain/documentation/0_5_19/classes/token.html) instance consumed.
-* [SUBRULE](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#subrule1) will return
+* [CONSUME](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#consume1) will return
+  The [Token](http://sap.github.io/chevrotain/documentation/0_5_20/classes/token.html) instance consumed.
+* [SUBRULE](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#subrule1) will return
   the result on invoking the rule.
 
 

docs/tutorial/step4_fault_tolerance.md

@@ -47,9 +47,9 @@ Therefore the missing colon will be automatically "inserted".
 
 This heuristic's behavior can be customized by the following methods:
 
-* [canTokenTypeBeInsertedInRecovery](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#cantokentypebeinsertedinrecovery)
+* [canTokenTypeBeInsertedInRecovery](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#cantokentypebeinsertedinrecovery)
   
-* [getTokenToInsert](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#gettokentoinsert)
+* [getTokenToInsert](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#gettokentoinsert)
         
             
 ### In Rule Single Token deletion:
@@ -204,14 +204,14 @@ from the sub-rule we have recovered from.
 By default **undefined** will be returned from a recovered rule, however this should most likely be customize
 in any but the most simple cases.
 
-Customization is done during the definition of the grammar [RULE](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#rule).
+Customization is done during the definition of the grammar [RULE](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#rule).
 The third parameter(**invalidRet**) is a function which will be invoked to produce the returned value in case of re-sync recovery. 
 
 
 ####Disabling Re-Sync Recovery:
 Re-Sync recovery is enabled by default for all rules.
 In some cases it may be appropriate to disable re-sync recovery for a specific rule.
-This is (once again) done during the definition of the grammar [RULE](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#rule).
+This is (once again) done during the definition of the grammar [RULE](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#rule).
 The fourth argument is a boolean which can be controls whether or not re-sync is enabled for the defined rule.
  
 
@@ -224,7 +224,7 @@ additional definitions (what should be returned value of a re-synced rule?).
 ### Disabling All Recovery mechanisms
 By default fault tolerance and error recovery heuristics are enabled.
 They can be disabled by passing a optional **isErrorRecoveryEnabled** parameter (default true)
-To the parser's constructor [constructor](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#constructor).
+To the parser's constructor [constructor](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#constructor).
    
    
 #### What is Next?

package.json

@@ -1,6 +1,6 @@
 {
   "name": "chevrotain",
-  "version": "0.5.19",
+  "version": "0.5.20",
   "description": "Chevrotain is a high performance fault tolerant javascript parsing DSL for building recursive decent parsers",
   "keywords": [
     "parser",

readme.md

@@ -57,7 +57,7 @@ any code generation phase.
 
 ## Documentation
 * [Latest released version's HTML docs](http://sap.github.io/chevrotain/documentation)
-   * [Parsing DSL](http://sap.github.io/chevrotain/documentation/0_5_19/classes/parser.html#at_least_one)
+   * [Parsing DSL](http://sap.github.io/chevrotain/documentation/0_5_20/classes/parser.html#at_least_one)
 
 * Annotated source code (dev version):
    *  [tokens_public.ts](https://github.com/SAP/chevrotain/blob/master/src/scan/tokens_public.ts)

release/chevrotain.d.ts

@@ -1,4 +1,4 @@
-/*! chevrotain - v0.5.19 - 2016-03-07 */
+/*! chevrotain - v0.5.20 - 2016-03-09 */
 declare namespace chevrotain {
     class HashTable<V>{}
     export function tokenName(clazz: Function): string;
@@ -795,6 +795,7 @@ declare namespace chevrotain {
             visitRepetitionWithSeparator(node: RepetitionWithSeparator): void;
             visitAlternation(node: Alternation): void;
             visitTerminal(node: Terminal): void;
+            visitRule(node: Rule): void;
         }
     }
 

release/chevrotain.js

@@ -1,4 +1,4 @@
-/*! chevrotain - v0.5.19 - 2016-03-07 */
+/*! chevrotain - v0.5.20 - 2016-03-09 */
 
 (function webpackUniversalModuleDefinition(root, factory) {
 	if(typeof exports === 'object' && typeof module === 'object')
@@ -69,7 +69,7 @@ return /******/ (function(modules) { // webpackBootstrap
 	 */
 	var API = {};
 	// semantic version
-	API.VERSION = "0.5.19";
+	API.VERSION = "0.5.20";
 	// runtime API
 	API.Parser = parser_public_1.Parser;
 	API.Lexer = lexer_public_1.Lexer;
@@ -2179,9 +2179,14 @@ return /******/ (function(modules) { // webpackBootstrap
 	            }
 	            else if (node instanceof Terminal) {
 	                this.visitTerminal(node);
+	            }/* istanbul ignore else */ 
+	            else if (node instanceof Rule) {
+	                this.visitRule(node);
+	            }
+	            else {
+	                /* istanbul ignore next */ throw Error("non exhaustive match");
 	            }
 	        };
-	        /* istanbul ignore next */ // this is an "Abstract" method that does nothing, testing it is pointless.
 	        GAstVisitor.prototype.visitNonTerminal = function (node) { };
 	        GAstVisitor.prototype.visitFlat = function (node) { };
 	        GAstVisitor.prototype.visitOption = function (node) { };
@@ -2191,6 +2196,7 @@ return /******/ (function(modules) { // webpackBootstrap
 	        GAstVisitor.prototype.visitRepetitionWithSeparator = function (node) { };
 	        GAstVisitor.prototype.visitAlternation = function (node) { };
 	        GAstVisitor.prototype.visitTerminal = function (node) { };
+	        GAstVisitor.prototype.visitRule = function (node) { };
 	        return GAstVisitor;
 	    }());
 	    gast.GAstVisitor = GAstVisitor;

src/api.ts

@@ -12,7 +12,7 @@ import {clearCache} from "./parse/cache_public"
 let API:any = {}
 
 // semantic version
-API.VERSION = "0.5.19"
+API.VERSION = "0.5.20"
 
 // runtime API
 API.Parser = Parser