Added the continueParsing option to ArgParser.

pkg/args/lib/src/parser.dart

 // Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 library args.src.parser;
 
 import '../args.dart';
 
 final _SOLO_OPT = new RegExp(r'^-([a-zA-Z0-9])$');
 final _ABBR_OPT = new RegExp(r'^-([a-zA-Z0-9]+)(.*)$');
 final _LONG_OPT = new RegExp(r'^--([a-zA-Z\-_0-9]+)(=(.*))?$');
 
 /**
  * The actual parsing class. Unlike [ArgParser] which is really more an "arg
  * grammar", this is the class that does the parsing and holds the mutable
  * state required during a parse.
+ *
+ * If [continueParsing] is set, the parser will continue parsing even after it
+ * finds an argument that is not an option. This allows you to specify options
+ * after your command parameters.
  */
 class Parser {
   /**
    * If parser is parsing a command's options, this will be the name of the
    * command. For top-level results, this returns `null`.
    */
   final String commandName;
 
   /**
    * The parser for the supercommand of this command parser, or `null` if this
    * is the top-level parser.
    */
   final Parser parent;
 
+  /** If `true`, parser will continue after it sees a non-option argument. */
+  final boolean continueParsing;
+
   /** The grammar being parsed. */
   final ArgParser grammar;
 
   /** The arguments being parsed. */
   final List<String> args;
 
+  /**
+   * The remaining unparsed arguments.
+   *
+   * This will be passed onto commands so only the last command will use the
+   * arguments.
+   */
+  List<String> rest;
+
   /** The accumulated parsed options. */
   final Map results = {};
 
-  Parser(this.commandName, this.grammar, this.args, [this.parent]);
+  Parser(this.commandName, this.grammar, this.args,
+      [this.continueParsing = false, this.parent, rest])
+    : this.rest = rest == null ? [] : rest;
 
   /** The current argument being parsed. */
   String get current => args[0];
 
-  /** Parses the arguments. This can only be called once. */
+  /**
+   * Parses the arguments. This can only be called once.
+   */
   ArgResults parse() {
     var commandResults = null;
 
     // Initialize flags to their defaults.
     grammar.options.forEach((name, option) {
       if (option.allowMultiple) {
         results[name] = [];
       } else {
         results[name] = option.defaultValue;
       }
     });
 
     // Parse the args.
     while (args.length > 0) {
       if (current == '--') {
         // Reached the argument terminator, so stop here.
         args.removeAt(0);
         break;
       }
 
       // Try to parse the current argument as a command. This happens before
       // options so that commands can have option-like names.
       var command = grammar.commands[current];
       if (command != null) {
         var commandName = args.removeAt(0);
-        var commandParser = new Parser(commandName, command, args, this);
+        var commandParser = new Parser(commandName, command, args,
+            continueParsing, this, rest.toList());
         commandResults = commandParser.parse();
-        continue;
+
+        // All remaining arguments were passed to command so clear them here.
+        rest.clear();
+
+        break;
       }
 
       // Try to parse the current argument as an option. Note that the order
       // here matters.
       if (parseSoloOption()) continue;
       if (parseAbbreviation(this)) continue;
       if (parseLongOption()) continue;
 
-      // If we got here, the argument doesn't look like an option, so stop.
-      break;
+      if (!continueParsing) {
+        // If we got here, the argument doesn't look like an option, so stop.
+        break;
+      } else {
+        rest.add(args.removeAt(0));
+      }
     }
 
     // Set unspecified multivalued arguments to their default value,
     // if any, and invoke the callbacks.
     grammar.options.forEach((name, option) {
       if (option.allowMultiple &&
           results[name].length == 0 &&
           option.defaultValue != null) {
         results[name].add(option.defaultValue);
       }
       if (option.callback != null) option.callback(results[name]);
     });
 
     // Add in the leftover arguments we didn't parse to the innermost command.
-    var rest = args.toList();
+    rest.addAll(args.toList());
     args.clear();
     return new ArgResults(results, commandName, commandResults, rest);
   }
 
   /**
    * Pulls the value for [option] from the second argument in [args]. Validates
    * that there is a valid value there.
    */
   void readNextArgAsValue(Option option) {
     // Take the option argument from the next command line arg.
@@ skipping 163 matching lines @@
           '"$value" is not an allowed value for option "${option.name}".');
     }
 
     if (option.allowMultiple) {
       results[option.name].add(value);
     } else {
       results[option.name] = value;
     }
   }
 }