Support subcommands in pub and pub help.

sdk/lib/_internal/pub/test/pub_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 pub_tests;
 
 import 'package:scheduled_test/scheduled_test.dart';
 
+import '../lib/src/exit_codes.dart' as exit_codes;
 import 'test_pub.dart';
 
 final USAGE_STRING = """
     Pub is a package manager for Dart.
 
-    Usage: pub command [arguments]
+    Usage: pub <command> [arguments]
 
     Global options:
     -h, --help            Print this usage information.
         --version         Print pub version.
         --[no-]trace      Print debugging information when an error occurs.
         --verbosity       Control output verbosity.
 
               [all]       Show all output including internal tracing messages.
               [io]        Also show IO operations.
               [normal]    Show errors, warnings, and user messages.
               [solver]    Show steps during version resolution.
 
     -v, --verbose         Shortcut for "--verbosity=all".
 
     Available commands:
-      build      Copy and compile all Dart entrypoints in the 'web' directory.
+      build      Apply transformers to build a package.
       get        Get the current package's dependencies.
       help       Display help information for Pub.
       publish    Publish the current package to pub.dartlang.org.
       serve      Run a local web development server.
       upgrade    Upgrade the current package's dependencies to latest versions.
       uploader   Manage uploaders for a package on pub.dartlang.org.
       version    Print pub version.
 
     Use "pub help [command]" for more information about a command.
     """;
@@ skipping 32 matching lines @@
     schedulePub(args: ['get', '-h'],
         output: '''
           Get the current package's dependencies.
 
           Usage: pub get
           -h, --help            Print usage information for this command.
               --[no-]offline    Use cached packages instead of accessing the network.
     ''');
   });
 
+  integration('running pub with --help after command with subcommands shows '

[nweiz, 2014/01/31 21:42:06]

"after command" -> "after a command"

[Bob Nystrom, 2014/02/01 01:49:32]

Done.

+              'command usage', () {
+    schedulePub(args: ['cache', '--help'],
+        output: '''
+          Work with the system cache.
+          
+          Usage: pub cache <subcommand>
+          -h, --help    Print usage information for this command.
+          
+          Available commands:
+            list   List packages in system cache.
+     ''');
+  });
+
+
   integration('running pub with just --version displays version', () {
     schedulePub(args: ['--version'], output: VERSION_STRING);
   });
 
   integration('an unknown command displays an error message', () {
     schedulePub(args: ['quylthulg'],
         error: '''
         Could not find a command named "quylthulg".
-        Run "pub help" to see available commands.
+   
+        Available commands:
+          build      Apply transformers to build a package.
+          get        Get the current package's dependencies.
+          help       Display help information for Pub.
+          publish    Publish the current package to pub.dartlang.org.
+          serve      Run a local web development server.
+          upgrade    Upgrade the current package's dependencies to latest versions.
+          uploader   Manage uploaders for a package on pub.dartlang.org.
+          version    Print pub version.
         ''',
-        exitCode: 64);
+        exitCode: exit_codes.USAGE);
+  });
+
+  integration('an unknown subcommand displays an error message', () {
+    schedulePub(args: ['cache', 'quylthulg'],
+        error: '''
+        Could not find a subcommand named "quylthulg" for "pub cache".
+   
+        Available subcommands:
+          list   List packages in system cache.
+        ''',
+        exitCode: exit_codes.USAGE);
   });
 
   integration('an unknown option displays an error message', () {
     schedulePub(args: ['--blorf'],
         error: '''
         Could not find an option named "blorf".
         Run "pub help" to see available options.
         ''',
-        exitCode: 64);
+        exitCode: exit_codes.USAGE);
   });
 
   integration('an unknown command option displays an error message', () {
     // TODO(rnystrom): When pub has command-specific options, a more precise
     // error message would be good here.
     schedulePub(args: ['version', '--blorf'],
         error: '''
         Could not find an option named "blorf".
         Run "pub help" to see available options.
         ''',
-        exitCode: 64);
+        exitCode: exit_codes.USAGE);
   });
 
   integration('an unexpected argument displays an error message', () {
     schedulePub(args: ['version', 'unexpected'],
         output: '''
         Print pub version.
 
         Usage: pub version
          -h, --help    Print usage information for this command.
         ''',
         error: '''
         Command "version" does not take any arguments.
         ''',
-        exitCode: 64);
+        exitCode: exit_codes.USAGE);
+  });
+
+  integration('a missing subcommand displays an error message', () {
+    schedulePub(args: ['cache'],
+        error: '''
+        Missing subcommand for "pub cache".

[nweiz, 2014/01/31 21:42:06]

This should also mention "Usage: pub cache <command>"

[Bob Nystrom, 2014/02/01 01:49:32]

Done.

+
+        Available subcommands:
+          list   List packages in system cache.
+        ''',
+        exitCode: exit_codes.USAGE);
   });
 
   group('help', () {
     integration('shows global help if no command is given', () {
       schedulePub(args: ['help'], output: USAGE_STRING);
     });
 
     integration('shows help for a command', () {
       schedulePub(args: ['help', 'get'],
           output: '''
@@ skipping 12 matching lines @@
 
             Usage: pub publish [options]
             -h, --help       Print usage information for this command.
             -n, --dry-run    Validate but do not publish the package.
             -f, --force      Publish without confirmation if there are no errors.
                 --server     The package server to which to upload this package.
                              (defaults to "https://pub.dartlang.org")
             ''');
     });
 
+    integration('shows help for a subcommand', () {
+      schedulePub(args: ['help', 'cache', 'list'],
+          output: '''
+            List packages in system cache.
+
+            Usage: pub cache list
+            -h, --help    Print usage information for this command.
+            ''');
+    });
+
     integration('an unknown help command displays an error message', () {
       schedulePub(args: ['help', 'quylthulg'],
           error: '''
             Could not find a command named "quylthulg".
-            Run "pub help" to see available commands.
+       
+            Available commands:
+              build      Apply transformers to build a package.
+              get        Get the current package's dependencies.
+              help       Display help information for Pub.
+              publish    Publish the current package to pub.dartlang.org.
+              serve      Run a local web development server.
+              upgrade    Upgrade the current package's dependencies to latest versions.
+              uploader   Manage uploaders for a package on pub.dartlang.org.
+              version    Print pub version.
             ''',
-            exitCode: 64);
+            exitCode: exit_codes.USAGE);
     });
 
+    integration('an unknown help subcommand displays an error message', () {
+      schedulePub(args: ['help', 'cache', 'quylthulg'],
+          error: '''
+            Could not find a subcommand named "quylthulg" for "pub cache".
+       
+            Available subcommands:
+              list   List packages in system cache.
+            ''',
+            exitCode: exit_codes.USAGE);
+    });
+
+    integration('an unexpected help subcommand displays an error message', () {
+      schedulePub(args: ['help', 'version', 'badsubcommand'],
+          error: '''
+            Command "pub version" does not expect a subcommand.

[nweiz, 2014/01/31 21:42:06]

This should print the documentation for "pub version".

[Bob Nystrom, 2014/02/01 01:49:32]

Done.

+            ''',
+            exitCode: exit_codes.USAGE);
+    });
   });
 
   group('version', () {
     integration('displays the current version', () {
       schedulePub(args: ['version'], output: VERSION_STRING);
     });
   });
 }