Add support for pub install.

utils/pub/package.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.
 
 /**
  * A named, versioned, unit of code and resource reuse.
  */
 class Package implements Hashable {
   /**
    * Loads the package whose root directory is [packageDir].
@@ skipping 10 matching lines @@
    * The path to the directory containing the package.
    */
   final String dir;
 
   /**
    * The name of the package.
    */
   final String name;
 
   /**
-   * The names of the packages that this package depends on. This is what is
+   * The ids of the packages that this package depends on. This is what is
    * specified in the pubspec when this package depends on another.
    */
-  // TODO(rnystrom): When packages are versioned and sourced, this will likely
-  // be something more than just a string.
-  final Collection<String> dependencies;
+  final Collection<PackageId> dependencies;
 
   /**
    * Constructs a package. This should not be called directly. Instead, acquire
    * packages from [load()].
    */
   Package._(String dir, this.dependencies)
   : dir = dir,
     name = basename(dir);
 
   /**
-   * Reads and returns all of the packages this package immediately depends on.
-   */
-  Future<Collection<Package>> loadDependencies(PackageCache cache) {
-    return Futures.wait(dependencies.map((name) => cache.find(name)));
-  }
-
-  /**
-   * Walks the entire dependency graph starting at this package and returns a
-   * [Set] of all of the packages dependend on by this one, directly or
-   * indirectly. This package is included in the result set.
-   */
-  Future<Set<Package>> traverseDependencies(PackageCache cache) {
-    final completer = new Completer<Set<Package>>();
-    final packages = new Set<Package>();
-
-    var pendingAsyncCalls = 0;
-
-    walkPackage(Package package) {
-      // Skip packages we've already traversed.
-      if (packages.contains(package)) return;
-
-      // Add the package.
-      packages.add(package);
-
-      // Recurse into its dependencies.
-      pendingAsyncCalls++;
-      package.loadDependencies(cache).then((dependencies) {
-        dependencies.forEach(walkPackage);
-        pendingAsyncCalls--;
-        if (pendingAsyncCalls == 0) completer.complete(packages);
-      });
-    }
-
-    walkPackage(this);
-
-    return completer.future;
-  }
-
-  /**
    * Generates a hashcode for the package.
    */
   // TODO(rnystrom): Do something more sophisticated here once we care about
   // versioning and different package sources.
   int hashCode() => name.hashCode();
 
   /**
    * Returns a debug string for the package.
    */
   String toString() => '$name ($dir)';
 
   /**
    * Parses the pubspec at the given path and returns the list of package
    * dependencies it exposes.
    */
-  static Future<List<String>> _parsePubspec(String path) {
-    final completer = new Completer<List<String>>();
+  static Future<List<PackageId>> _parsePubspec(String path) {
+    final completer = new Completer<List<PackageId>>();
 
     // TODO(rnystrom): Handle the directory not existing.
     // TODO(rnystrom): Error-handling.
     final readFuture = readTextFile(path);
     readFuture.handleException((error) {
       // If there is no pubspec, we implicitly treat that as a package with no
       // dependencies.
       // TODO(rnystrom): Distinguish file not found from other real errors.
-      completer.complete(<String>[]);
+      completer.complete(<PackageId>[]);
       return true;
     });
 
     readFuture.then((pubspec) {
       if (pubspec.trim() == '') {
         completer.complete(<String>[]);
         return;
       }
 
       var parsedPubspec = loadYaml(pubspec);
       if (parsedPubspec is! Map) {
         completer.completeException('The pubspec must be a YAML mapping.');
       }
 
       if (!parsedPubspec.containsKey('dependencies')) {
         completer.complete(<String>[]);
         return;
       }
 
       var dependencies = parsedPubspec['dependencies'];
       if (dependencies.some((e) => e is! String)) {
         completer.completeException(
             'The pubspec dependencies must be a list of package names.');
       }
 
-      completer.complete(dependencies);
+      var dependencyIds =
+        dependencies.map((name) => new PackageId(name, Source.defaultSource));
+      completer.complete(dependencyIds);
     });
 
     return completer.future;
   }
 }
+
+/**
+ * A unique identifier for a package. A given package id specifies a single
+ * chunk of code and resources.
+ *
+ * Note that it's possible for multiple package ids to point to identical
+ * packages. For example, the same package may be available from multiple
+ * sources. As far as Pub is concerned, those packages are different.
+ */
+// TODO(nweiz, rnystrom): this should include version eventually
+class PackageId implements Hashable {
+  /**
+   * The name used by the [source] to look up the package.
+   *
+   * Note that this may be distinct from the name of the package itself. The
+   * [source] uses this name to locate the package and returns the true package
+   * name. For example, for a Git source [name] might be the URL
+   * "git://github.com/dart/uilib.git", while the package name would just be
+   * "uilib". It would be up to the source to take the URL and extract the
+   * package name.
+   */
+  final String name;

[Bob Nystrom, 2012/05/03 00:23:02]

"fullName".

You may also want to make a "name" getter that just does
source.packageName(this);.

[nweiz, 2012/05/04 01:03:43]

Done.

+
+  /**
+   * The [Source] used to look up the package given the [name].
+   */
+  final Source source;
+
+  PackageId(String this.name, Source this.source);
+
+  int hashCode() => name.hashCode() ^ source.name.hashCode();
+
+  bool operator ==(other) {
+    if (other is! PackageId) return false;
+    return other.name == name && other.source.name == source.name;
+  }
+
+  String toString() => "$name from ${source.name}";
+}