Chromium Code Reviews| OLD | NEW |
|---|---|
| 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2013, the Dart project authors. Please see the AUTHORS file |
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
| 4 | 4 |
| 5 /** | 5 /** |
| 6 * This library lets you define parsers for parsing raw command-line arguments | 6 * This library lets you define parsers for parsing raw command-line arguments |
| 7 * into a set of options and values using [GNU][] and [POSIX][] style options. | 7 * into a set of options and values using [GNU][] and [POSIX][] style options. |
| 8 * | 8 * |
| 9 * ## Installing ## | 9 * ## Installing ## |
| 10 * | 10 * |
| (...skipping 329 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 340 } | 340 } |
| 341 | 341 |
| 342 options[name] = new Option(name, abbr, help, allowed, allowedHelp, | 342 options[name] = new Option(name, abbr, help, allowed, allowedHelp, |
| 343 defaultsTo, callback, isFlag: isFlag, negatable: negatable, | 343 defaultsTo, callback, isFlag: isFlag, negatable: negatable, |
| 344 allowMultiple: allowMultiple); | 344 allowMultiple: allowMultiple); |
| 345 } | 345 } |
| 346 | 346 |
| 347 /** | 347 /** |
| 348 * Parses [args], a list of command-line arguments, matches them against the | 348 * Parses [args], a list of command-line arguments, matches them against the |
| 349 * flags and options defined by this parser, and returns the result. | 349 * flags and options defined by this parser, and returns the result. |
| 350 * | |
| 351 * If [parseAllOptions] is set, the parser will continue parsing even after it | |
|
Bob Nystrom
2013/06/20 00:33:36
How about "allowTrailingOptions"?
Andrei Mouravski
2013/06/22 00:54:02
Done.
| |
| 352 * finds an argument that is neither an option nor a command. This allows | |
| 353 * options to be specified after command parameters. | |
| 354 * | |
| 355 * [parseAllOptions] is false by default, so when a non-option, non-command | |
| 356 * argument is encountered, it and any remaining arguments are passed to the | |
| 357 * leafmost command. | |
|
Bob Nystrom
2013/06/20 00:33:36
"any remaining arguments are passed to the leafmos
Andrei Mouravski
2013/06/22 00:54:02
Done.
| |
| 358 * | |
| 359 * An argument that looks like an option, but does not match any option will | |
| 360 * throw a [FormatException], regardless of the value of [parseAllOptions]. | |
| 350 */ | 361 */ |
| 351 ArgResults parse(List<String> args) => | 362 ArgResults parse(List<String> args, {bool parseAllOptions: false}) => |
|
Bob Nystrom
2013/06/20 00:33:36
Instead of using a default here, initialize the de
Andrei Mouravski
2013/06/22 00:54:02
Done.
| |
| 352 new Parser(null, this, args.toList()).parse(); | 363 new Parser(null, this, args.toList(), parseAllOptions).parse(); |
| 353 | 364 |
| 354 /** | 365 /** |
| 355 * Generates a string displaying usage information for the defined options. | 366 * Generates a string displaying usage information for the defined options. |
| 356 * This is basically the help text shown on the command line. | 367 * This is basically the help text shown on the command line. |
| 357 */ | 368 */ |
| 358 String getUsage() => new Usage(this).generate(); | 369 String getUsage() => new Usage(this).generate(); |
| 359 | 370 |
| 360 /** | 371 /** |
| 361 * Get the default value for an option. Useful after parsing to test | 372 * Get the default value for an option. Useful after parsing to test |
| 362 * if the user specified something other than the default. | 373 * if the user specified something other than the default. |
| (...skipping 52 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... | |
| 415 'Could not find an option named "$name".'); | 426 'Could not find an option named "$name".'); |
| 416 } | 427 } |
| 417 | 428 |
| 418 return _options[name]; | 429 return _options[name]; |
| 419 } | 430 } |
| 420 | 431 |
| 421 /** Get the names of the options as an [Iterable]. */ | 432 /** Get the names of the options as an [Iterable]. */ |
| 422 Iterable<String> get options => _options.keys; | 433 Iterable<String> get options => _options.keys; |
| 423 } | 434 } |
| 424 | 435 |
| OLD | NEW |