| Index: pkg/args/lib/args.dart
|
| diff --git a/pkg/args/lib/args.dart b/pkg/args/lib/args.dart
|
| index ec40958991bc5a1a497cd26a652a0ead28016051..562df446a83b70b2ee229a6567a2f7a09ddf0387 100644
|
| --- a/pkg/args/lib/args.dart
|
| +++ b/pkg/args/lib/args.dart
|
| @@ -4,176 +4,6 @@
|
|
|
| library args;
|
|
|
| -import 'package:collection/wrappers.dart';
|
| -
|
| -import 'src/parser.dart';
|
| -import 'src/usage.dart';
|
| -import 'src/options.dart';
|
| -export 'src/options.dart';
|
| -
|
| -/// A class for taking a list of raw command line arguments and parsing out
|
| -/// options and flags from them.
|
| -class ArgParser {
|
| - final Map<String, Option> _options;
|
| - final Map<String, ArgParser> _commands;
|
| -
|
| - /// The options that have been defined for this parser.
|
| - final Map<String, Option> options;
|
| -
|
| - /// The commands that have been defined for this parser.
|
| - final Map<String, ArgParser> commands;
|
| -
|
| - /// Whether or not this parser parses options that appear after non-option
|
| - /// arguments.
|
| - final bool allowTrailingOptions;
|
| -
|
| - /// Creates a new ArgParser.
|
| - ///
|
| - /// 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 regular arguments. Defaults to
|
| - /// `false`.
|
| - factory ArgParser({bool allowTrailingOptions}) =>
|
| - new ArgParser._(<String, Option>{}, <String, ArgParser>{},
|
| - allowTrailingOptions: allowTrailingOptions);
|
| -
|
| - ArgParser._(Map<String, Option> options, Map<String, ArgParser> commands,
|
| - {bool allowTrailingOptions}) :
|
| - this._options = options,
|
| - this.options = new UnmodifiableMapView(options),
|
| - this._commands = commands,
|
| - this.commands = new UnmodifiableMapView(commands),
|
| - this.allowTrailingOptions = allowTrailingOptions != null ?
|
| - allowTrailingOptions : false;
|
| -
|
| - /// Defines a command.
|
| - ///
|
| - /// A command is a named argument which may in turn define its own options and
|
| - /// subcommands using the given parser. If [parser] is omitted, implicitly
|
| - /// creates a new one. Returns the parser for the command.
|
| - ArgParser addCommand(String name, [ArgParser parser]) {
|
| - // Make sure the name isn't in use.
|
| - if (_commands.containsKey(name)) {
|
| - throw new ArgumentError('Duplicate command "$name".');
|
| - }
|
| -
|
| - if (parser == null) parser = new ArgParser();
|
| - _commands[name] = parser;
|
| - return parser;
|
| - }
|
| -
|
| - /// Defines a flag. Throws an [ArgumentError] if:
|
| - ///
|
| - /// * There is already an option named [name].
|
| - /// * There is already an option using abbreviation [abbr].
|
| - void addFlag(String name, {String abbr, String help, bool defaultsTo: false,
|
| - bool negatable: true, void callback(bool value), bool hide: false}) {
|
| - _addOption(name, abbr, help, null, null, null, defaultsTo, callback,
|
| - isFlag: true, negatable: negatable, hide: hide);
|
| - }
|
| -
|
| - /// Defines a value-taking option. Throws an [ArgumentError] if:
|
| - ///
|
| - /// * There is already an option with name [name].
|
| - /// * There is already an option using abbreviation [abbr].
|
| - void addOption(String name, {String abbr, String help, String valueHelp,
|
| - List<String> allowed, Map<String, String> allowedHelp, String defaultsTo,
|
| - void callback(value), bool allowMultiple: false, bool hide: false}) {
|
| - _addOption(name, abbr, help, valueHelp, allowed, allowedHelp, defaultsTo,
|
| - callback, isFlag: false, allowMultiple: allowMultiple,
|
| - hide: hide);
|
| - }
|
| -
|
| - void _addOption(String name, String abbr, String help, String valueHelp,
|
| - List<String> allowed, Map<String, String> allowedHelp, defaultsTo,
|
| - void callback(value), {bool isFlag, bool negatable: false,
|
| - bool allowMultiple: false, bool hide: false}) {
|
| - // Make sure the name isn't in use.
|
| - if (_options.containsKey(name)) {
|
| - throw new ArgumentError('Duplicate option "$name".');
|
| - }
|
| -
|
| - // Make sure the abbreviation isn't too long or in use.
|
| - if (abbr != null) {
|
| - var existing = findByAbbreviation(abbr);
|
| - if (existing != null) {
|
| - throw new ArgumentError(
|
| - 'Abbreviation "$abbr" is already used by "${existing.name}".');
|
| - }
|
| - }
|
| -
|
| - _options[name] = new Option(name, abbr, help, valueHelp, allowed,
|
| - allowedHelp, defaultsTo, callback, isFlag: isFlag, negatable: negatable,
|
| - allowMultiple: allowMultiple, hide: hide);
|
| - }
|
| -
|
| - /// Parses [args], a list of command-line arguments, matches them against the
|
| - /// flags and options defined by this parser, and returns the result.
|
| - ArgResults parse(List<String> args) =>
|
| - new Parser(null, this, args.toList(), null, null).parse();
|
| -
|
| - /// 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.
|
| - getDefault(String option) {
|
| - if (!options.containsKey(option)) {
|
| - throw new ArgumentError('No option named $option');
|
| - }
|
| - return options[option].defaultValue;
|
| - }
|
| -
|
| - /// Finds the option whose abbreviation is [abbr], or `null` if no option has
|
| - /// that abbreviation.
|
| - Option findByAbbreviation(String abbr) {
|
| - return options.values.firstWhere((option) => option.abbreviation == abbr,
|
| - orElse: () => null);
|
| - }
|
| -}
|
| -
|
| -/// The results of parsing a series of command line arguments using
|
| -/// [ArgParser.parse()].
|
| -///
|
| -/// Includes the parsed options and any remaining unparsed command line
|
| -/// arguments.
|
| -class ArgResults {
|
| - final Map<String, dynamic> _options;
|
| -
|
| - /// If these are the results for parsing a command's options, this will be the
|
| - /// name of the command. For top-level results, this returns `null`.
|
| - final String name;
|
| -
|
| - /// The command that was selected, or `null` if none was.
|
| - ///
|
| - /// This will contain the options that were selected for that command.
|
| - final ArgResults command;
|
| -
|
| - /// The remaining command-line arguments that were not parsed as options or
|
| - /// flags.
|
| - ///
|
| - /// If `--` was used to separate the options from the remaining arguments,
|
| - /// it will not be included in this list unless parsing stopped before the
|
| - /// `--` was reached.
|
| - final List<String> rest;
|
| -
|
| - /// Creates a new [ArgResults].
|
| - ArgResults(this._options, this.name, this.command, List<String> rest)
|
| - : this.rest = new UnmodifiableListView(rest);
|
| -
|
| - /// Gets the parsed command-line option named [name].
|
| - operator [](String name) {
|
| - if (!_options.containsKey(name)) {
|
| - throw new ArgumentError(
|
| - '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;
|
| -}
|
| -
|
| +export 'src/arg_parser.dart';
|
| +export 'src/arg_results.dart' hide newArgResults;
|
| +export 'src/option.dart' hide newOption;
|
|
|