Index: pkg/front_end/lib/incremental_resolved_ast_generator.dart |
diff --git a/pkg/front_end/lib/incremental_resolved_ast_generator.dart b/pkg/front_end/lib/incremental_resolved_ast_generator.dart |
deleted file mode 100644 |
index daeb8c19f776a5140e681657a22b24385c1b6893..0000000000000000000000000000000000000000 |
--- a/pkg/front_end/lib/incremental_resolved_ast_generator.dart |
+++ /dev/null |
@@ -1,98 +0,0 @@ |
-// Copyright (c) 2017, 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. |
- |
-import 'dart:async'; |
- |
-import 'package:analyzer/dart/ast/ast.dart'; |
-import 'package:front_end/src/base/processed_options.dart'; |
-import 'package:front_end/src/incremental_resolved_ast_generator_impl.dart'; |
- |
-import 'compiler_options.dart'; |
- |
-/// Represents the difference between "old" and "new" states of a program. |
-/// |
-/// Not intended to be implemented or extended by clients. |
-class DeltaLibraries { |
- /// The new state of the program, as a two-layer map. |
- /// |
- /// The outer map key is the library URI. The inner map key is the |
- /// compilation unit (part) URI. The map values are the resolved compilation |
- /// units. |
- /// |
- /// Libraries whose resolved AST is known to be unchanged since the last |
- /// [DeltaLibraries] are not included. |
- final Map<Uri, Map<Uri, CompilationUnit>> newState; |
- |
- DeltaLibraries(this.newState); |
- |
- /// TODO(paulberry): add information about libraries that were removed. |
-} |
- |
-/// Interface for generating an initial resolved representation of a program and |
-/// keeping it up to date as incremental changes are made. |
-/// |
-/// This class maintains an internal "previous program state"; each |
-/// time [computeDelta] is called, it updates the previous program state and |
-/// produces a representation of what has changed. When there are few changes, |
-/// a call to [computeDelta] should be much faster than compiling the whole |
-/// program from scratch. |
-/// |
-/// This class also maintains a set of "valid sources", which is a (possibly |
-/// empty) subset of the sources constituting the previous program state. Files |
-/// in this set are assumed to be unchanged since the last call to |
-/// [computeDelta]. |
-/// |
-/// Behavior is undefined if the client does not obey the following concurrency |
-/// restrictions: |
-/// - no two invocations of [computeDelta] may be outstanding at any given time. |
-/// - neither [invalidate] nor [invalidateAll] may be called while an invocation |
-/// of [computeDelta] is outstanding. |
-/// |
-/// Not intended to be implemented or extended by clients. |
-abstract class IncrementalResolvedAstGenerator { |
- /// Creates an [IncrementalResolvedAstGenerator] which is prepared to generate |
- /// resolved ASTs for the program whose main library is in the given |
- /// [source]. |
- /// |
- /// No file system access is performed by this constructor; the initial |
- /// "previous program state" is an empty program containing no code, and the |
- /// initial set of valid sources is empty. To obtain a resolved AST |
- /// representation of the program, call [computeDelta]. |
- factory IncrementalResolvedAstGenerator( |
- Uri source, CompilerOptions options) => |
- new IncrementalResolvedAstGeneratorImpl( |
- source, new ProcessedOptions(options)); |
- |
- /// Generates a resolved AST representation of the changes to the program, |
- /// assuming that all valid sources are unchanged since the last call to |
- /// [computeDelta]. |
- /// |
- /// Source files in the set of valid sources are guaranteed not to be re-read |
- /// from disk; they are assumed to be unchanged regardless of the state of the |
- /// filesystem. |
- /// |
- /// If the future completes successfully, the previous file state is updated |
- /// and the set of valid sources is set to the set of all sources in the |
- /// program. |
- /// |
- /// If the future completes with an error (due to errors in the compiled |
- /// source code), the caller may consider the previous file state and the set |
- /// of valid sources to be unchanged; this means that once the user fixes the |
- /// errors, it is safe to call [computeDelta] again. |
- Future<DeltaLibraries> computeDelta(); |
- |
- /// Remove any source file(s) associated with the given file path from the set |
- /// of valid sources. This guarantees that those files will be re-read on the |
- /// next call to [computeDelta]). |
- void invalidate(String path); |
- |
- /// Remove all source files from the set of valid sources. This guarantees |
- /// that all files will be re-read on the next call to [computeDelta]. |
- /// |
- /// Note that this does not erase the previous program state; the next time |
- /// [computeDelta] is called, if parts of the program are discovered to be |
- /// unchanged, parts of the previous program state will still be re-used to |
- /// speed up compilation. |
- void invalidateAll(); |
-} |