Introduce build configuration to summary building.

pkg/analyzer/lib/src/summary/summary_file_builder.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.
 
 library analyzer.src.summary.summary_file_builder;
 
 import 'dart:collection';
 import 'dart:io';
 
 import 'package:analyzer/dart/ast/ast.dart';
@@ skipping 28 matching lines @@
     }
     // Write index.
     {
       String outputPath = join(outputDirectoryPath, '$modeName.index');
       File file = new File(outputPath);
       file.writeAsBytesSync(index, mode: FileMode.WRITE_ONLY);
     }
   }
 }
 
+/**
+ * Summary build configuration.
+ */
+class SummaryBuildConfig {
+
+  /**
+   * Whether to use exclude informative data from created summaries.
+   */
+  final bool buildSummaryExcludeInformative;
+
+  /**
+   * Whether to output a summary in "fallback mode".
+   */
+  final bool buildSummaryFallback;
+  /**

[Paul Berry, 2016/06/17 19:57:51]

Nit: add a blank line here.

[pquitslund, 2016/06/17 20:47:32]

Done.

+   * Whether to create summaries using only ASTs, i.e. don't perform resolution.

[Paul Berry, 2016/06/17 19:57:51]

Technically, creating summaries from ASTs performs resolution; it just does it
in a different way that doesn't require creating a full element model.  Consider
changing to something like: "Whether to create summaries directly from ASTs,
i.e. don't create a full element model."

[pquitslund, 2016/06/17 20:47:32]

Done.

+   */
+  final bool buildSummaryOnlyAst;
+
+  /**
+   * Path to the dart SDK summary file.
+   */
+  final String dartSdkSummaryPath;
+
+  /**
+   * Whether to use strong static checking.
+   */
+  final bool strongMode;
+
+  /**
+   * List of summary input file paths.
+   */
+  final Iterable<String> summaryInputs;
+
+  /**
+   * Create a build configuration with the given set options.
+   */
+  SummaryBuildConfig(
+      {this.strongMode: false,
+      this.summaryInputs,
+      this.dartSdkSummaryPath,
+      this.buildSummaryExcludeInformative: false,
+      this.buildSummaryFallback: false,
+      this.buildSummaryOnlyAst: false});
+}
+
 class SummaryBuilder {
-  final AnalysisContext _context;
-  final Iterable<Source> _librarySources;
+  final AnalysisContext context;
+  final Iterable<Source> librarySources;
+  final SummaryBuildConfig config;
 
-  SummaryBuilder(this._librarySources, this._context);
+  /**
+   * Create a summary builder for these [librarySources] and [context] using the
+   * given [config].
+   */
+  SummaryBuilder(this.librarySources, this.context, this.config);
 
-  factory SummaryBuilder.forSdk(String sdkPath, bool strongMode) {
+  /**
+   * Create an SDK summary builder for the dart SDK at the given [sdkPath],
+   * using this [config].
+   */
+  factory SummaryBuilder.forSdk(String sdkPath, SummaryBuildConfig config) {
+    bool strongMode = config.strongMode;
+
     //
     // Prepare SDK.
     //
     DirectoryBasedDartSdk sdk =
         new DirectoryBasedDartSdk(new JavaFile(sdkPath), strongMode);
     sdk.useSummary = false;
     sdk.analysisOptions = new AnalysisOptionsImpl()..strongMode = strongMode;
 
     //
     // Prepare 'dart:' URIs to serialize.
     //
     Set<String> uriSet =
         sdk.sdkLibraries.map((SdkLibrary library) => library.shortName).toSet();
     if (!strongMode) {
       uriSet.add('dart:html/nativewrappers.dart');
     }
     uriSet.add('dart:html_common/html_common_dart2js.dart');
 
     Set<Source> librarySources = new HashSet<Source>();
     for (String uri in uriSet) {
       librarySources.add(sdk.mapDartUri(uri));
     }
 
-    return new SummaryBuilder(librarySources, sdk.context);
+    return new SummaryBuilder(librarySources, sdk.context, config);
   }
 
-  BuilderOutput build() => new _Builder(_context, _librarySources).build();
+  BuilderOutput build() => new _Builder(context, librarySources).build();
 }
 
 /**
  * Intermediary summary output result.
  */
 class SummaryOutput {
   final BuilderOutput spec;
   final BuilderOutput strong;
   SummaryOutput(this.spec, this.strong);
 
@@ skipping 23 matching lines @@
 
   final PackageBundleAssembler bundleAssembler = new PackageBundleAssembler();
   final PackageIndexAssembler indexAssembler = new PackageIndexAssembler();
 
   final AnalysisContext context;
   final Iterable<Source> librarySources;
 
   _Builder(this.context, this.librarySources);
 
   /**
-   * Build a strong or spec mode summary for the Dart SDK at [sdkPath].
+   * Build summary output.
    */
   BuilderOutput build() {
     //
     // Serialize each source.
     //
     for (Source source in librarySources) {
       _serializeLibrary(source);
     }
     //
     // Assemble the output.
@@ skipping 17 matching lines @@
     element.exportedLibraries.forEach((e) => _serializeLibrary(e.source));
     // Index every unit of the library.
     for (CompilationUnitElement unitElement in element.units) {
       Source unitSource = unitElement.source;
       CompilationUnit unit =
           context.resolveCompilationUnit2(unitSource, source);
       indexAssembler.indexUnit(unit);
     }
   }
 }