| Index: utils/pub/path_source.dart
 | 
| diff --git a/utils/pub/path_source.dart b/utils/pub/path_source.dart
 | 
| new file mode 100644
 | 
| index 0000000000000000000000000000000000000000..123a3086c2ed0b3a8c5d546e6a12521cf3e897d2
 | 
| --- /dev/null
 | 
| +++ b/utils/pub/path_source.dart
 | 
| @@ -0,0 +1,78 @@
 | 
| +// Copyright (c) 2013, 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 path_source;
 | 
| +
 | 
| +import 'dart:async';
 | 
| +import 'dart:io';
 | 
| +
 | 
| +import '../../pkg/path/lib/path.dart' as path;
 | 
| +
 | 
| +import 'io.dart';
 | 
| +import 'package.dart';
 | 
| +import 'pubspec.dart';
 | 
| +import 'version.dart';
 | 
| +import 'source.dart';
 | 
| +import 'utils.dart';
 | 
| +
 | 
| +// TODO(rnystrom): Support relative paths. (See comment in _validatePath().)
 | 
| +/// A package [Source] that installs packages from a given local file path.
 | 
| +class PathSource extends Source {
 | 
| +  final name = 'path';
 | 
| +  final shouldCache = false;
 | 
| +
 | 
| +  Future<Pubspec> describe(PackageId id) {
 | 
| +    return defer(() {
 | 
| +      _validatePath(id.name, id.description);
 | 
| +      return new Pubspec.load(id.name, id.description, systemCache.sources);
 | 
| +    });
 | 
| +  }
 | 
| +
 | 
| +  Future<bool> install(PackageId id, String path) {
 | 
| +    return defer(() {
 | 
| +      try {
 | 
| +        _validatePath(id.name, id.description);
 | 
| +      } on FormatException catch(err) {
 | 
| +        return false;
 | 
| +      }
 | 
| +      return createPackageSymlink(id.name, id.description, path);
 | 
| +    }).then((_) => true);
 | 
| +  }
 | 
| +
 | 
| +  void validateDescription(description, {bool fromLockFile: false}) {
 | 
| +    if (description is! String) {
 | 
| +      throw new FormatException("The description must be a path string.");
 | 
| +    }
 | 
| +  }
 | 
| +
 | 
| +  /// Ensures that [dir] is a valid path. It must be an absolute path that
 | 
| +  /// points to an existing directory. Throws a [FormatException] if the path
 | 
| +  /// is invalid.
 | 
| +  void _validatePath(String name, String dir) {
 | 
| +    // Relative paths are not (currently) allowed because the user would expect
 | 
| +    // them to be relative to the pubspec where the dependency appears. That in
 | 
| +    // turn means that two pubspecs in different locations with the same
 | 
| +    // relative path dependency could refer to two different packages. That
 | 
| +    // violates pub's rule that a description should uniquely identify a
 | 
| +    // package.
 | 
| +    //
 | 
| +    // At some point, we may want to loosen this, but it will mean tracking
 | 
| +    // where a given PackageId appeared.
 | 
| +    if (!path.isAbsolute(dir)) {
 | 
| +      throw new FormatException(
 | 
| +          "Path dependency for package '$name' must be an absolute path. "
 | 
| +          "Was '$dir'.");
 | 
| +    }
 | 
| +
 | 
| +    if (fileExists(dir)) {
 | 
| +      throw new FormatException(
 | 
| +          "Path dependency for package '$name' must refer to a "
 | 
| +          "directory, not a file. Was '$dir'.");
 | 
| +    }
 | 
| +
 | 
| +    if (!dirExists(dir)) {
 | 
| +      throw new FormatException("Could not find package '$name' at '$dir'.");
 | 
| +    }
 | 
| +  }
 | 
| +}
 | 
| 
 |