Added extra parameters option in vscode settings for ANTLR4 jar

Fixes #69

package.json

@@ -151,6 +151,14 @@
                             "type": "boolean",
                             "default": false,
                             "description": "Also create visitors on code generation"
+                        },
+                        "alternativeJar": {
+                            "type": "string",
+                            "description": "Path to a Java jar file to be used for parser generation"
+                        },
+                        "additionalParameters": {
+                            "type": "string",
+                            "description": "Any other commandline parameters you want to send to the ANTLR4 jar"
                         }
                     }
                 },

src/backend/SourceContext.ts

@@ -784,6 +784,11 @@ export class SourceContext {
             parameters.push(genListener ? "-listener" : "-no-listener");
             parameters.push(options.visitors === true ? "-visitor" : "-no-visitor");
             parameters.push("-Xexact-output-dir"); // Available starting with 4.7.2.
+
+            if (options.additionalParameters) {
+                parameters.push(options.additionalParameters);
+            }
+
             dependencies.add(thisRef); // Needs this also in the error parser.
 
             let fileList: string[] = [];
@@ -818,7 +823,7 @@ export class SourceContext {
                     thisRef.setupInterpreters(options.outputDir);
                     resolve(fileList);
                 } else {
-                    reject(buffer); // Treat this as non-grammar error (e.g. Java exception).
+                    reject(buffer); // Treat this as non-grammar output (e.g. Java exception).
                 }
             });
         });

src/backend/facade.ts

@@ -189,15 +189,17 @@ export class ATNGraphData {
  * Options used by the parser files generation.
  */
 export interface GenerationOptions {
-    baseDir?: string;    // The folder in which to run the generation process. Should be an absolute path for predictable results.
+    baseDir?: string;    // The folder in which to run the generation process.
+                         // Should be an absolute path for predictable results. Used internally only.
     libDir?: string;     // Search path for the ANTLR tool.
     outputDir?: string;  // The folder where to place generated files in (relative to baseDir or absolute). (default: grammar dir)
     package?: string;    // Package or namespace name for generated files. (default: none)
     language?: string;   // The target language for the generated files. (default: what's given in the grammar or Java)
     listeners?: boolean; // Generate listener files if set. (default: true)
     visitors?: boolean;  // Generate visitor files if set. (default: false)
     loadOnly?: boolean;  // Don't generate anything. Just try to load interpreter data and do interpreter setup.
-    alternativeJar?: string; // Use this jar for work instead of the built-in one(s).
+    alternativeJar?: string;        // Use this jar for work instead of the built-in one(s).
+    additionalParameters?: string;  // Any additional parameter you want to send to ANTLR4 for generation (e.g. "-XdbgST").
 };
 
 /**
@@ -470,7 +472,7 @@ export class AntlrFacade {
      *
      * @param fileName The grammar file.
      */
-    public getLexerVocabulary(fileName: string): Vocabulary | undefined{
+    public getLexerVocabulary(fileName: string): Vocabulary | undefined {
         let context = this.getContext(fileName);
         return context.getVocabulary();
     }
@@ -525,7 +527,7 @@ export class AntlrFacade {
         return context.getDiagnostics();
     };
 
-    public ruleFromPosition(fileName: string, column: number, row: number): [string | undefined, number | undefined ]{
+    public ruleFromPosition(fileName: string, column: number, row: number): [string | undefined, number | undefined] {
         let context = this.getContext(fileName);
         return context.ruleFromPosition(column, row);
     }

src/extension.ts

@@ -299,7 +299,9 @@ export function activate(context: ExtensionContext) {
             libDir: workspace.getConfiguration("antlr4.generation")["importDir"],
             outputDir: outputDir,
             listeners: false,
-            visitors: false
+            visitors: false,
+            alternativeJar: workspace.getConfiguration("antlr4.generation")["alternativeJar"],
+            additionalParameters: workspace.getConfiguration("antlr4.generation")["additionalParameters"]
         };
 
         if (externalMode) {