Using arg parsing lib for dart2js.

tests/lib/args/args_test.dart

 // Copyright (c) 2012, 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_test');
 
 #import('../../../lib/unittest/unittest.dart');
 #import('../../../lib/args/args.dart');
 
 main() {
+  group('ArgParser()', () {
+    test('adds a help option if includeHelp is true', () {
+      var parser = new ArgParser(includeHelp: true);
+      var results = parser.parse(['-h']);
+      expect(results['help']).isTrue();
+    });
+
+    test('does not add a help option if includeHelp is false', () {
+      var parser = new ArgParser(includeHelp: false);
+      throwsBadFormat(parser, ['-h']);
+    });
+
+    test('includeHelp defaults to true', () {
+      var parser = new ArgParser();
+      var results = parser.parse(['-h']);
+      expect(results['help']).isTrue();
+    });
+  });
+
   group('ArgParser.addFlag()', () {
     test('throws IllegalArgumentException if the flag already exists', () {
       var parser = new ArgParser();
       parser.addFlag('foo');
       throwsIllegalArg(() => parser.addFlag('foo'));
     });
 
     test('throws IllegalArgumentException if the option already exists', () {
       var parser = new ArgParser();
       parser.addOption('foo');
@@ skipping 352 matching lines @@
 
         var results = parser.parse(['--woof', '--', '--meow']);
         expect(results['woof']).isTrue();
         expect(results['meow']).equals('kitty');
         expect(results.rest).equalsCollection(['--meow']);
       });
     });
   });
 
   group('ArgParser.getUsage()', () {
-    test('flags show "no-" in title', () {
-      var parser = new ArgParser();
+    test('shows usage if provided', () {
+      var parser = new ArgParser(usage: 'myapp [options]');
       parser.addFlag('mode', help: 'The mode');
 
       validateUsage(parser,
+          '''
+          myapp [options]
+
+          -h, --[no-]help    Display usage information
+              --[no-]mode    The mode
+          ''');
+    });
+
+    test('shows help if included', () {
+      var parser = new ArgParser(includeHelp: true);
+      parser.addFlag('mode', help: 'The mode');
+
+      validateUsage(parser,
+          '''
+          -h, --[no-]help    Display usage information
+              --[no-]mode    The mode
+          ''');
+    });
+
+    test('shows "no-" in flag titles', () {
+      var parser = new ArgParser(includeHelp: false);
+      parser.addFlag('mode', help: 'The mode');
+
+      validateUsage(parser,
           '''
           --[no-]mode    The mode
           ''');
     });
 
-    test('if there are no abbreviations, there is no column for them', () {
-      var parser = new ArgParser();
+    test('omits the column if there are no abbreviations', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addFlag('mode', help: 'The mode');
 
       validateUsage(parser,
           '''
           --[no-]mode    The mode
           ''');
     });
 
-    test('options are lined up past abbreviations', () {
-      var parser = new ArgParser();
+    test('lines up options past abbreviations', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addFlag('mode', abbr: 'm', help: 'The mode');
       parser.addOption('long', help: 'Lacks an abbreviation');
 
       validateUsage(parser,
           '''
           -m, --[no-]mode    The mode
               --long         Lacks an abbreviation
           ''');
     });
 
-    test('help text is lined up past the longest option', () {
-      var parser = new ArgParser();
+    test('lines up help text past the longest option', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addFlag('mode', abbr: 'm', help: 'Lined up with below');
       parser.addOption('a-really-long-name', help: 'Its help text');
 
       validateUsage(parser,
           '''
           -m, --[no-]mode             Lined up with below
               --a-really-long-name    Its help text
           ''');
     });
 
-    test('leading empty lines are ignored in help text', () {
-      var parser = new ArgParser();
+    test('ignores leading empty lines in help text', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addFlag('mode', help: '\n\n\n\nAfter newlines');
 
       validateUsage(parser,
           '''
           --[no-]mode    After newlines
           ''');
     });
 
-    test('trailing empty lines are ignored in help text', () {
-      var parser = new ArgParser();
+    test('ignores trailing empty lines in help text', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addFlag('mode', help: 'Before newlines\n\n\n\n');
 
       validateUsage(parser,
           '''
           --[no-]mode    Before newlines
           ''');
     });
 
-    test('options are documented in the order they were added', () {
-      var parser = new ArgParser();
+    test('documents options in the order they were added', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addFlag('zebra', help: 'First');
       parser.addFlag('monkey', help: 'Second');
       parser.addFlag('wombat', help: 'Third');
 
       validateUsage(parser,
           '''
           --[no-]zebra     First
           --[no-]monkey    Second
           --[no-]wombat    Third
           ''');
     });
 
-    test('the default value for a flag is shown if on', () {
-      var parser = new ArgParser();
+    test('shows the default value for a flag if true', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addFlag('affirm', help: 'Should be on', defaultsTo: true);
       parser.addFlag('negate', help: 'Should be off', defaultsTo: false);
 
       validateUsage(parser,
           '''
           --[no-]affirm    Should be on
                            (defaults to on)
 
           --[no-]negate    Should be off
           ''');
     });
 
-    test('the default value for an option with no allowed list is shown', () {
-      var parser = new ArgParser();
+    test('shows the default value for an option with no allowed list', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addOption('any', help: 'Can be anything', defaultsTo: 'whatevs');
 
       validateUsage(parser,
           '''
           --any    Can be anything
                    (defaults to "whatevs")
           ''');
     });
 
-    test('the allowed list is shown', () {
-      var parser = new ArgParser();
+    test('shows the allowed list', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addOption('suit', help: 'Like in cards',
           allowed: ['spades', 'clubs', 'hearts', 'diamonds']);
 
       validateUsage(parser,
           '''
           --suit    Like in cards
                     [spades, clubs, hearts, diamonds]
           ''');
     });
 
-    test('the default is highlighted in the allowed list', () {
-      var parser = new ArgParser();
+    test('highlights the default in the allowed list', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addOption('suit', help: 'Like in cards', defaultsTo: 'clubs',
           allowed: ['spades', 'clubs', 'hearts', 'diamonds']);
 
       validateUsage(parser,
           '''
           --suit    Like in cards
                     [spades, clubs (default), hearts, diamonds]
           ''');
     });
 
-    test('the allowed help is shown', () {
-      var parser = new ArgParser();
+    test('shows the allowed help', () {
+      var parser = new ArgParser(includeHelp: false);
       parser.addOption('suit', help: 'Like in cards', defaultsTo: 'clubs',
           allowed: ['spades', 'clubs', 'diamonds', 'hearts'],
           allowedHelp: {
             'spades': 'Swords of a soldier',
             'clubs': 'Weapons of war',
             'diamonds': 'Money for this art',
             'hearts': 'The shape of my heart'
           });
 
       validateUsage(parser,
@@ skipping 57 matching lines @@
         throw new IllegalArgumentException(
             'Line "$line" does not have enough indentation.');
       }
 
       lines[i] = line.substring(indent);
     }
   }
 
   return Strings.join(lines, '\n');
 }