Added the continueParsing option to ArgParser.

pkg/args/lib/args.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.
 
 /**
  * This library lets you define parsers for parsing raw command-line arguments
  * into a set of options and values using [GNU][] and [POSIX][] style options.
  *
  * ## Installing ##
  *
@@ skipping 329 matching lines @@
     }
 
     options[name] = new Option(name, abbr, help, allowed, allowedHelp,
         defaultsTo, callback, isFlag: isFlag, negatable: negatable,
         allowMultiple: allowMultiple);
   }
 
   /**
    * Parses [args], a list of command-line arguments, matches them against the
    * flags and options defined by this parser, and returns the result.
+   *
+   * If [allowTrailingOptions] is set, the parser will continue parsing even
+   * after it finds an argument that is neither an option nor a command.
+   * This allows options to be specified after command parameters.

[Bob Nystrom, 2013/06/24 15:53:20]

"command parameters" -> "regular arguments".

[Andrei Mouravski, 2013/06/24 20:41:04]

Done.

+   *
+   * [allowTrailingOptions] is false by default, so when a non-option,
+   * non-command argument is encountered, it and all remaining arguments,
+   * even those that look like options are passed to the leafmost command.

[Bob Nystrom, 2013/06/24 15:53:20]

"leafmost" -> "innermost".

[Andrei Mouravski, 2013/06/24 20:41:04]

Done.

+   *
+   * An argument that looks like an option, but does not match any option will
+   * throw a [FormatException], regardless of the value
+   * of [allowTrailingOptions].

[Bob Nystrom, 2013/06/24 15:53:20]

This is a bit confusing. It isn't clear that this is *not* the case for trailing
arguments after a non-option one when allowTrailingOptions is false. Maybe just
remove the paragraph?

[Andrei Mouravski, 2013/06/24 20:41:04]

Done.

    */
-  ArgResults parse(List<String> args) =>
-      new Parser(null, this, args.toList()).parse();
+  ArgResults parse(List<String> args, {bool allowTrailingOptions}) {
+    if (allowTrailingOptions == null) allowTrailingOptions = false;
+    return new Parser(null, this, args.toList(), allowTrailingOptions).parse();

[Bob Nystrom, 2013/06/24 15:53:20]

It should be a named argument here too.

[Andrei Mouravski, 2013/06/24 20:41:04]

Done.

+  }
 
   /**
    * Generates a string displaying usage information for the defined options.
    * This is basically the help text shown on the command line.
    */
   String getUsage() => new Usage(this).generate();
 
   /**
    * Get the default value for an option. Useful after parsing to test
    * if the user specified something other than the default.
@@ skipping 52 matching lines @@
           'Could not find an option named "$name".');
     }
 
     return _options[name];
   }
 
   /** Get the names of the options as an [Iterable]. */
   Iterable<String> get options => _options.keys;
 }