| OLD | NEW | 
|---|
| 1 // Copyright (c) 2016, the Dart project authors.  Please see the AUTHORS file | 1 // Copyright (c) 2016, the Dart project authors.  Please see the AUTHORS file | 
| 2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a | 
| 3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. | 
| 4 | 4 | 
| 5 library front_end.file_system; | 5 library front_end.file_system; | 
| 6 | 6 | 
| 7 import 'dart:async'; | 7 import 'dart:async'; | 
| 8 | 8 | 
| 9 import 'package:path/path.dart' as path; |  | 
| 10 |  | 
| 11 /// Abstract interface to file system operations. | 9 /// Abstract interface to file system operations. | 
| 12 /// | 10 /// | 
| 13 /// All front end interaction with the file system goes through this interface; | 11 /// All front end interaction with the file system goes through this interface; | 
| 14 /// this makes it possible for clients to use the front end in a way that | 12 /// this makes it possible for clients to use the front end in a way that | 
| 15 /// doesn't require file system access (e.g. to run unit tests, or to run | 13 /// doesn't require file system access (e.g. to run unit tests, or to run | 
| 16 /// inside a browser). | 14 /// inside a browser). | 
| 17 /// | 15 /// | 
| 18 /// Not intended to be implemented or extended by clients. | 16 /// Not intended to be implemented or extended by clients. | 
| 19 abstract class FileSystem { | 17 abstract class FileSystem { | 
| 20   /// Returns a path context suitable for use with this [FileSystem]. |  | 
| 21   /// |  | 
| 22   /// TODO(paulberry): try to eliminate all usages of this.  Since the |  | 
| 23   /// FileSystem API now uses URIs rather than paths, it should not be needed. |  | 
| 24   path.Context get context; |  | 
| 25 |  | 
| 26   /// Returns a [FileSystemEntity] corresponding to the given [uri]. | 18   /// Returns a [FileSystemEntity] corresponding to the given [uri]. | 
| 27   /// | 19   /// | 
| 28   /// Uses of `..` and `.` in the URI are normalized before returning. | 20   /// Uses of `..` and `.` in the URI are normalized before returning. | 
| 29   /// | 21   /// | 
| 30   /// If the URI scheme is not supported by this file system, an [Error] will be | 22   /// If the URI scheme is not supported by this file system, an [Error] will be | 
| 31   /// thrown. | 23   /// thrown. | 
| 32   /// | 24   /// | 
| 33   /// Does not check whether a file or folder exists at the given location. | 25   /// Does not check whether a file or folder exists at the given location. | 
| 34   FileSystemEntity entityForUri(Uri uri); | 26   FileSystemEntity entityForUri(Uri uri); | 
| 35 } | 27 } | 
| 36 | 28 | 
| 37 /// Abstract representation of a file system entity that may or may not exist. | 29 /// Abstract representation of a file system entity that may or may not exist. | 
| 38 /// | 30 /// | 
| 39 /// Instances of this class have suitable implementations of equality tests and | 31 /// Instances of this class have suitable implementations of equality tests and | 
| 40 /// hashCode. | 32 /// hashCode. | 
| 41 /// | 33 /// | 
| 42 /// Not intended to be implemented or extended by clients. | 34 /// Not intended to be implemented or extended by clients. | 
| 43 abstract class FileSystemEntity { | 35 abstract class FileSystemEntity { | 
| 44   /// Returns the absolute normalized URI represented by this file system | 36   /// The absolute normalized URI represented by this file system entity. | 
| 45   /// entity. |  | 
| 46   /// | 37   /// | 
| 47   /// Note: this is not necessarily the same as the URI that was passed to | 38   /// Note: this is not necessarily the same as the URI that was passed to | 
| 48   /// [FileSystem.entityForUri], since the URI might have been normalized. | 39   /// [FileSystem.entityForUri], since the URI might have been normalized. | 
| 49   Uri get uri; | 40   Uri get uri; | 
| 50 | 41 | 
| 51   /// Attempts to access this file system entity as a file and read its contents | 42   /// Attempts to access this file system entity as a file and read its contents | 
| 52   /// as raw bytes. | 43   /// as raw bytes. | 
| 53   /// | 44   /// | 
| 54   /// If an error occurs while attempting to read the file (e.g. because no such | 45   /// If an error occurs while attempting to read the file (e.g. because no such | 
| 55   /// file exists, or the entity is a directory), the future is completed with | 46   /// file exists, or the entity is a directory), the future is completed with | 
| 56   /// an [Exception]. | 47   /// an [Exception]. | 
| 57   Future<List<int>> readAsBytes(); | 48   Future<List<int>> readAsBytes(); | 
| 58 | 49 | 
| 59   /// Attempts to access this file system entity as a file and read its contents | 50   /// Attempts to access this file system entity as a file and read its contents | 
| 60   /// as a string. | 51   /// as a string. | 
| 61   /// | 52   /// | 
| 62   /// The file is assumed to be UTF-8 encoded. | 53   /// The file is assumed to be UTF-8 encoded. | 
| 63   /// | 54   /// | 
| 64   /// If an error occurs while attempting to read the file (e.g. because no such | 55   /// If an error occurs while attempting to read the file (e.g. because no such | 
| 65   /// file exists, the entity is a directory, or the file is not valid UTF-8), | 56   /// file exists, the entity is a directory, or the file is not valid UTF-8), | 
| 66   /// the future is completed with an [Exception]. | 57   /// the future is completed with an [Exception]. | 
| 67   Future<String> readAsString(); | 58   Future<String> readAsString(); | 
|  | 59 | 
|  | 60   /// Whether this file system entity exists. | 
|  | 61   Future<bool> exists(); | 
|  | 62 | 
|  | 63   /// Extracts the last-modification time of the file system entity, if it | 
|  | 64   /// exists and it is a file, otherwise the future is completed with an | 
|  | 65   /// [Exception]. | 
|  | 66   Future<DateTime> lastModified(); | 
| 68 } | 67 } | 
| OLD | NEW | 
|---|