| Index: pkg/front_end/lib/file_system.dart
|
| diff --git a/pkg/front_end/lib/file_system.dart b/pkg/front_end/lib/file_system.dart
|
| index cadf82fddf40b6058e3e18975b86f9a954730cfd..6e57c266c067bdd9b731335abc37ece3bfa672ec 100644
|
| --- a/pkg/front_end/lib/file_system.dart
|
| +++ b/pkg/front_end/lib/file_system.dart
|
| @@ -18,22 +18,17 @@ import 'package:path/path.dart' as path;
|
| /// Not intended to be implemented or extended by clients.
|
| abstract class FileSystem {
|
| /// Returns a path context suitable for use with this [FileSystem].
|
| - path.Context get context;
|
| -
|
| - /// Returns a [FileSystemEntity] corresponding to the given [path].
|
| - ///
|
| - /// Uses of `..` and `.` in path are normalized before returning (so, for
|
| - /// example, `entityForPath('./foo')` and `entityForPath('foo')` are
|
| - /// equivalent). Relative paths are also converted to absolute paths.
|
| ///
|
| - /// Does not check whether a file or folder exists at the given location.
|
| - FileSystemEntity entityForPath(String path);
|
| + /// TODO(paulberry): try to eliminate all usages of this. Since the
|
| + /// FileSystem API now uses URIs rather than paths, it should not be needed.
|
| + path.Context get context;
|
|
|
| /// Returns a [FileSystemEntity] corresponding to the given [uri].
|
| ///
|
| /// Uses of `..` and `.` in the URI are normalized before returning.
|
| ///
|
| - /// If [uri] is not an absolute `file:` URI, an [Error] will be thrown.
|
| + /// If the URI scheme is not supported by this file system, an [Error] will be
|
| + /// thrown.
|
| ///
|
| /// Does not check whether a file or folder exists at the given location.
|
| FileSystemEntity entityForUri(Uri uri);
|
| @@ -46,14 +41,12 @@ abstract class FileSystem {
|
| ///
|
| /// Not intended to be implemented or extended by clients.
|
| abstract class FileSystemEntity {
|
| - /// Returns the absolute normalized path represented by this file system
|
| + /// Returns the absolute normalized URI represented by this file system
|
| /// entity.
|
| ///
|
| - /// Note: if the [FileSystemEntity] was created using
|
| - /// [FileSystem.entityForPath], this is not necessarily the same as the path
|
| - /// that was used to create the object, since the path might have been
|
| - /// normalized.
|
| - String get path;
|
| + /// Note: this is not necessarily the same as the URI that was passed to
|
| + /// [FileSystem.entityForUri], since the URI might have been normalized.
|
| + Uri get uri;
|
|
|
| /// Attempts to access this file system entity as a file and read its contents
|
| /// as raw bytes.
|
|
|