Add a "cache add" command to download packages to the cache.

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';
@@ skipping 11 matching lines @@
 
               [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      Apply transformers to build a package.
+      cache      Work with the system cache.
       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 42 matching lines @@
   integration('running pub with --help after a command with subcommands shows '
               '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 subcommands:
-            list   List packages in the system cache.
+            add   Install a package.
      ''');
   });
 
 
   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".
    
         Available commands:
           build      Apply transformers to build a package.
+          cache      Work with the system cache.
           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: 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".
    
         Usage: pub cache <subcommand>
         -h, --help    Print usage information for this command.
-        
+
         Available subcommands:
-          list   List packages in the system cache.
+          add   Install a package.
         ''',
         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.
         ''',
@@ skipping 24 matching lines @@
 
   integration('a missing subcommand displays an error message', () {
     schedulePub(args: ['cache'],
         error: '''
         Missing subcommand for "pub cache".
 
         Usage: pub cache <subcommand>
         -h, --help    Print usage information for this command.
 
         Available subcommands:
-          list   List packages in the system cache.
+          add   Install a package.
         ''',
         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', () {
@@ skipping 28 matching lines @@
 
             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".
-       
+
             Available commands:
               build      Apply transformers to build a package.
+              cache      Work with the system cache.
               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: 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".
-       
+
             Usage: pub cache <subcommand>
             -h, --help    Print usage information for this command.
-
+    
             Available subcommands:
-              list   List packages in the system cache.
+              add   Install a package.
             ''',
             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.
-            
+
             Usage: pub version
             -h, --help    Print usage information for this command.
             ''',
             exitCode: exit_codes.USAGE);
     });
   });
 
   group('version', () {
     integration('displays the current version', () {
       schedulePub(args: ['version'], output: VERSION_STRING);
     });
   });
 }