Paul Berry
0753607dea
R=brianwilkerson@google.com, scheglov@google.com Review URL: https://codereview.chromium.org/2417043003 .
33 lines
1.4 KiB
Dart
33 lines
1.4 KiB
Dart
// Copyright (c) 2016, 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.
|
|
|
|
/// Defines the front-end API for converting source code to summaries.
|
|
library front_end.summary_generator;
|
|
|
|
import 'dart:async';
|
|
import 'compiler_options.dart';
|
|
|
|
/// Creates a summary representation of the build unit whose source files are in
|
|
/// [sources].
|
|
///
|
|
/// Intended to be a part of a modular compilation process.
|
|
///
|
|
/// [sources] should be the complete set of source files for a build unit
|
|
/// (including both library and part files).
|
|
///
|
|
/// The summarization process is hermetic, meaning that the only files which
|
|
/// will be read are those listed in [sources],
|
|
/// [CompilerOptions.inputSummaries], and [CompilerOptions.sdkSummary]. If a
|
|
/// source file attempts to refer to a file which is not obtainable from these
|
|
/// paths, that will result in an error, even if the file exists on the
|
|
/// filesystem.
|
|
///
|
|
/// Any `part` declarations found in [sources] must refer to part files which
|
|
/// are also listed in [sources], otherwise an error results. (It is not
|
|
/// permitted to refer to a part file declared in another build unit).
|
|
///
|
|
/// The return value is a list of bytes to write to the summary file.
|
|
Future<List<int>> summaryFor(List<Uri> sources, CompilerOptions options) =>
|
|
throw new UnimplementedError();
|