Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(71)

Side by Side Diff: README.md

Issue 975463004: Parse comma-separated multiple values. (Closed) Base URL: git@github.com:dart-lang/args@master
Patch Set: Add a splitCommas option. Created 5 years, 9 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
1 Parses raw command-line arguments into a set of options and values. 1 Parses raw command-line arguments into a set of options and values.
2 2
3 This library supports [GNU][] and [POSIX][] style options, and it works 3 This library supports [GNU][] and [POSIX][] style options, and it works
4 in both server-side and client-side apps. 4 in both server-side and client-side apps.
5 5
6 ## Defining options 6 ## Defining options
7 7
8 First create an [ArgParser][]: 8 First create an [ArgParser][]:
9 9
10 var parser = new ArgParser(); 10 var parser = new ArgParser();
(...skipping 171 matching lines...) Expand 10 before | Expand all | Expand 10 after
182 option can occur multiple times, and the `parse()` method returns a list of 182 option can occur multiple times, and the `parse()` method returns a list of
183 values: 183 values:
184 184
185 ```dart 185 ```dart
186 var parser = new ArgParser(); 186 var parser = new ArgParser();
187 parser.addOption('mode', allowMultiple: true); 187 parser.addOption('mode', allowMultiple: true);
188 var results = parser.parse(['--mode', 'on', '--mode', 'off']); 188 var results = parser.parse(['--mode', 'on', '--mode', 'off']);
189 print(results['mode']); // prints '[on, off]' 189 print(results['mode']); // prints '[on, off]'
190 ``` 190 ```
191 191
192 By default, multiple options' values may also be separated with commas:
Bob Nystrom 2015/03/04 22:01:37 This reads a bit ambiguously to me (it could mean
nweiz 2015/03/04 22:05:41 Done.
193
194 ```dart
195 var parser = new ArgParser();
196 parser.addOption('mode', allowMultiple: true);
197 var results = parser.parse(['--mode', 'on,off']);
198 print(results['mode']); // prints '[on, off]'
199 ```
200
201 This can be disabled by passing `splitCommas: false`.
202
192 ## Defining commands ## 203 ## Defining commands ##
193 204
194 In addition to *options*, you can also define *commands*. A command is a named 205 In addition to *options*, you can also define *commands*. A command is a named
195 argument that has its own set of options. For example, consider this shell 206 argument that has its own set of options. For example, consider this shell
196 command: 207 command:
197 208
198 ``` 209 ```
199 $ git commit -a 210 $ git commit -a
200 ``` 211 ```
201 212
(...skipping 177 matching lines...) Expand 10 before | Expand all | Expand 10 after
379 [Command]: http://www.dartdocs.org/documentation/args/latest/index.html#args/arg s.Command 390 [Command]: http://www.dartdocs.org/documentation/args/latest/index.html#args/arg s.Command
380 [UsageError]: http://www.dartdocs.org/documentation/args/latest/index.html#args/ args.UsageError 391 [UsageError]: http://www.dartdocs.org/documentation/args/latest/index.html#args/ args.UsageError
381 [addOption]: http://www.dartdocs.org/documentation/args/latest/index.html#args/a rgs.ArgParser@id_addOption 392 [addOption]: http://www.dartdocs.org/documentation/args/latest/index.html#args/a rgs.ArgParser@id_addOption
382 [addFlag]: http://www.dartdocs.org/documentation/args/latest/index.html#args/arg s.ArgParser@id_addFlag 393 [addFlag]: http://www.dartdocs.org/documentation/args/latest/index.html#args/arg s.ArgParser@id_addFlag
383 [parse]: http://www.dartdocs.org/documentation/args/latest/index.html#args/args. ArgParser@id_parse 394 [parse]: http://www.dartdocs.org/documentation/args/latest/index.html#args/args. ArgParser@id_parse
384 [rest]: http://www.dartdocs.org/documentation/args/latest/index.html#args/args.A rgResults@id_rest 395 [rest]: http://www.dartdocs.org/documentation/args/latest/index.html#args/args.A rgResults@id_rest
385 [addCommand]: http://www.dartdocs.org/documentation/args/latest/index.html#args/ args.ArgParser@id_addCommand 396 [addCommand]: http://www.dartdocs.org/documentation/args/latest/index.html#args/ args.ArgParser@id_addCommand
386 [getUsage]: http://www.dartdocs.org/documentation/args/latest/index.html#args/ar gs.ArgParser@id_getUsage 397 [getUsage]: http://www.dartdocs.org/documentation/args/latest/index.html#args/ar gs.ArgParser@id_getUsage
387 [addSubcommand]: http://www.dartdocs.org/documentation/args/latest/index.html#ar gs/args.Command@id_addSubcommand 398 [addSubcommand]: http://www.dartdocs.org/documentation/args/latest/index.html#ar gs/args.Command@id_addSubcommand
388 [run]: http://www.dartdocs.org/documentation/args/latest/index.html#args/args.Co mmand@id_run 399 [run]: http://www.dartdocs.org/documentation/args/latest/index.html#args/args.Co mmand@id_run
OLDNEW
« no previous file with comments | « CHANGELOG.md ('k') | lib/src/arg_parser.dart » ('j') | lib/src/arg_parser.dart » ('J')

Powered by Google App Engine
This is Rietveld 408576698