Rename "repo" source to "hosted".

utils/pub/hosted_source.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('dartlang_source');
+#library('hosted_source');
 
 #import('dart:io');
 #import('dart:json');
 #import('dart:uri');
 #import('io.dart');
 #import('package.dart');
 #import('pubspec.dart');
 #import('source.dart');
 #import('source_registry.dart');
 #import('utils.dart');
 #import('version.dart');
 
 /**
- * A package source that installs packages from a package repository that uses
- * the same API as pub.dartlang.org.
+ * A package source that installs packages from a package hosting site that
+ * uses the same API as pub.dartlang.org.
  */
-class RepoSource extends Source {
-  final String name = "repo";
+class HostedSource extends Source {
+  final name = "hosted";
+  final shouldCache = true;
 
-  final bool shouldCache = true;
-
-  // TODO(nweiz): update this comment once pub.dartlang.org is online
   /**
    * The URL of the default package repository.
-   *
-   * At time of writing, pub.dartlang.org is not yet online, but it should be
-   * soon.
    */
-  static final String defaultUrl = "http://pub.dartlang.org";
-
-  RepoSource();
+  static final defaultUrl = "http://pub.dartlang.org";
 
   /**
-   * Downloads a list of all versions of a package that have been uploaded to
-   * pub.dartlang.org.
+   * Downloads a list of all versions of a package that are available from the
+   * site.
    */
   Future<List<Version>> getVersions(description) {
     var parsed = _parseDescription(description);
     var fullUrl = "${parsed.last}/packages/${parsed.first}.json";
     return consumeInputStream(httpGet(fullUrl)).transform((data) {
       var doc = JSON.parse(new String.fromCharCodes(data));
       return doc['versions'].map((version) => new Version.parse(version));
     });
   }
 
   /**
    * Downloads and parses the pubspec for a specific version of a package that
-   * has been uploaded to pub.dartlang.org.
+   * is available from the site.
    */
   Future<Pubspec> describe(PackageId id) {
     var parsed = _parseDescription(id.description);
     var fullUrl = "${parsed.last}/packages/${parsed.first}/versions/"
       "${id.version}.yaml";
     return consumeInputStream(httpGet(fullUrl)).transform((data) {
       return new Pubspec.parse(
           new String.fromCharCodes(data), systemCache.sources);
     });
   }
 
   /**
-   * Downloads a package from a package repository and unpacks it.
+   * Downloads a package from the site and unpacks it.
    */
   Future<bool> install(PackageId id, String destPath) {
     var parsedDescription = _parseDescription(id.description);
     var name = parsedDescription.first;
     var url = parsedDescription.last;
 
     return ensureDir(destPath).chain((destDir) {
       var fullUrl = "$url/packages/$name/versions/${id.version}.tar.gz";
       return extractTarGz(httpGet(fullUrl), destDir);
     });
   }
 
   /**
-   * The system cache directory for the repo source contains subdirectories for
-   * each separate repository URL that's used on the system. Each of these
-   * subdirectories then contains a subdirectory for each package installed from
-   * that repository.
+   * The system cache directory for the hosted source contains subdirectories
+   * for each separate repository URL that's used on the system. Each of these
+   * subdirectories then contains a subdirectory for each package installed
+   * from that site.
    */
   String systemCacheDirectory(PackageId id) {
     var parsed = _parseDescription(id.description);
     var url = parsed.last.replaceAll(new RegExp(@"^https?://"), "");
     var urlDir = replace(url, new RegExp(@'[<>:"\\/|?*%]'), (match) {
       return '%${match[0].charCodeAt(0)}';
     });
     return join(systemCacheRoot, urlDir, "${parsed.first}-${id.version}");
   }
 
   String packageName(description) => _parseDescription(description).first;
 
   bool descriptionsEqual(description1, description2) =>
-    _parseDescription(description1) == _parseDescription(description2);
+      _parseDescription(description1) == _parseDescription(description2);
 
   /**
-   * Ensures that [description] is a valid repo description.
+   * Ensures that [description] is a valid hosted package description.
    *
    * There are two valid formats. A plain string refers to a package with the
-   * given name from the default repository, while a map with keys "name" and
-   * "url" refers to a package with the given name from the repo at the given
-   * URL.
+   * given name from the default host, while a map with keys "name" and "url"
+   * refers to a package with the given name from the host at the given URL.
    */
   void validateDescription(description, [bool fromLockFile=false]) {
     _parseDescription(description);
   }
 
   /**
-   * Parses the description blob for a package.
+   * Parses the description for a package.
    *
    * If the package parses correctly, this returns a (name, url) pair. If not,
    * this throws a descriptive FormatException.
    */
   Pair<String, String> _parseDescription(description) {
     if (description is String) {
       return new Pair<String, String>(description, defaultUrl);
     }
 
     if (description is! Map) {
       throw new FormatException(
           "The description must be a package name or map.");
     }
 
     if (!description.containsKey("name")) {
       throw new FormatException(
           "The description map must contain a 'name' key.");
     }
 
     var name = description["name"];
     if (name is! String) {
       throw new FormatException("The 'name' key must have a string value.");
     }
 
     var url = description.containsKey("url") ? description["url"] : defaultUrl;
     return new Pair<String, String>(name, url);
   }
 }