| Index: sdk/lib/_internal/pub/lib/src/source.dart
|
| diff --git a/sdk/lib/_internal/pub/lib/src/source.dart b/sdk/lib/_internal/pub/lib/src/source.dart
|
| index 8cfec0ff8d7bf4caa8aa4bb7660e95cfe02b0670..823b86023d7df38b36bf2a623661670137d8da3f 100644
|
| --- a/sdk/lib/_internal/pub/lib/src/source.dart
|
| +++ b/sdk/lib/_internal/pub/lib/src/source.dart
|
| @@ -94,11 +94,17 @@ abstract class Source {
|
| /// external code should not call this. Instead, call [describe].
|
| Future<Pubspec> doDescribe(PackageId id);
|
|
|
| - /// Gets the package identified by [id] and places it at [path].
|
| + /// Ensures that the package identified by [id] is present on the local file
|
| + /// system.
|
| ///
|
| - /// Returns a [Future] that completes when the operation finishes. [path] is
|
| - /// guaranteed not to exist, and its parent directory is guaranteed to exist.
|
| - Future get(PackageId id, String path);
|
| + /// For cached sources, this ensures the package is in the system cache. (If
|
| + /// already cached, it does nothing.) For uncached sources, it does nothing
|
| + /// since the package is already local.
|
| + Future ensureLocal(PackageId id);
|
| +
|
| + /// Ensures [id] is available locally and creates a symlink at [symlink]
|
| + /// pointing it.
|
| + Future get(PackageId id, String symlink);
|
|
|
| /// Returns the directory where this package can (or could) be found locally.
|
| ///
|
|
|