Implement modular compilation

lib/src/analyzer/context.dart

+// Copyright (c) 2015, 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 'package:args/args.dart' show ArgParser, ArgResults;
+import 'package:analyzer/src/generated/engine.dart'
+    show AnalysisContext, AnalysisEngine, AnalysisOptionsImpl;
+import 'package:analyzer/src/generated/java_io.dart' show JavaFile;
+import 'package:analyzer/src/generated/sdk_io.dart' show DirectoryBasedDartSdk;
+import 'package:analyzer/src/generated/source_io.dart'
+    show
+        CustomUriResolver,
+        DartUriResolver,
+        FileUriResolver,
+        PackageUriResolver,
+        SourceFactory,
+        UriResolver;
+import 'package:cli_util/cli_util.dart' show getSdkDir;
+
+import 'dart_sdk.dart' show MockDartSdk, mockSdkSources;
+import 'multi_package_resolver.dart' show MultiPackageResolver;
+
+/// Options used to set up Source URI resolution in the analysis context.
+class AnalyzerOptions {
+  /// Custom URI mappings, such as "dart:foo" -> "path/to/foo.dart"
+  final Map<String, String> customUrlMappings;
+
+  /// Package root when resolving 'package:' urls the standard way.
+  final String packageRoot;
+
+  /// List of summary file paths.
+  final List<String> summaryPaths;
+
+  /// List of paths used for the multi-package resolver.
+  final List<String> packagePaths;
+
+  /// Whether to use a mock-sdk during compilation.
+  final bool useMockSdk;
+
+  /// Path to the dart-sdk. Null if `useMockSdk` is true or if the path couldn't
+  /// be determined
+  final String dartSdkPath;
+
+  AnalyzerOptions(
+      {this.summaryPaths: const [],
+      this.useMockSdk: false,
+      String dartSdkPath,
+      this.customUrlMappings: const {},
+      this.packageRoot: 'packages/',
+      this.packagePaths: const []})
+      : dartSdkPath = dartSdkPath ?? getSdkDir().path;
+
+  AnalyzerOptions.fromArguments(ArgResults args)
+      : summaryPaths = args['summary'],
+        useMockSdk = false,
+        dartSdkPath = args['dart-sdk'] ?? getSdkDir().path,
+        customUrlMappings = _parseUrlMappings(args['url-mapping']),
+        packageRoot = args['package-root'],
+        packagePaths = args['package-paths']?.split(',') ?? [];
+
+  /// Whether to resolve 'package:' uris using the multi-package resolver.
+  bool get useMultiPackage => packagePaths.isNotEmpty;
+
+  static ArgParser addArguments(ArgParser parser) {
+    return parser
+      ..addOption('summary',
+          abbr: 's', help: 'summary file(s) to include', allowMultiple: true)
+      ..addOption('dart-sdk', help: 'Dart SDK Path', defaultsTo: null)
+      ..addOption('package-root',
+          abbr: 'p',
+          help: 'Package root to resolve "package:" imports',
+          defaultsTo: 'packages/')
+      ..addOption('url-mapping',
+          help: '--url-mapping=libraryUri,/path/to/library.dart uses \n'
+              'library.dart as the source for an import of of "libraryUri".',
+          allowMultiple: true,
+          splitCommas: false)
+      ..addOption('package-paths',
+          help: 'use a list of directories to resolve "package:" imports');
+  }
+
+  static Map<String, String> _parseUrlMappings(Iterable argument) {
+    var mappings = <String, String>{};
+    for (var mapping in argument) {
+      var splitMapping = mapping.split(',');
+      if (splitMapping.length >= 2) {
+        mappings[splitMapping[0]] = splitMapping[1];
+      }
+    }
+    return mappings;
+  }
+}
+
+/// Creates an [AnalysisContext] with dev_compiler type rules and inference,
+/// using [createSourceFactory] to set up its [SourceFactory].
+AnalysisContext createAnalysisContextWithSources(AnalyzerOptions options,
+    {DartUriResolver sdkResolver, List<UriResolver> fileResolvers}) {
+  AnalysisEngine.instance.processRequiredPlugins();
+  var srcFactory = createSourceFactory(options,
+      sdkResolver: sdkResolver, fileResolvers: fileResolvers);
+  return createAnalysisContext()..sourceFactory = srcFactory;
+}
+
+/// Creates an analysis context that contains our restricted typing rules.
+AnalysisContext createAnalysisContext() {
+  var res = AnalysisEngine.instance.createAnalysisContext();
+  res.analysisOptions = new AnalysisOptionsImpl()..strongMode = true;
+  return res;
+}
+
+/// Creates a SourceFactory configured by the [options].
+///
+/// Use [options.useMockSdk] to specify the SDK mode, or use [sdkResolver]
+/// to entirely override the DartUriResolver.
+///
+/// If supplied, [fileResolvers] will override the default `file:` and
+/// `package:` URI resolvers.
+SourceFactory createSourceFactory(AnalyzerOptions options,
+    {DartUriResolver sdkResolver, List<UriResolver> fileResolvers}) {
+  sdkResolver ??= options.useMockSdk
+      ? createMockSdkResolver(mockSdkSources)
+      : createSdkPathResolver(options.dartSdkPath);
+
+  var resolvers = <UriResolver>[];
+  if (options.customUrlMappings.isNotEmpty) {
+    resolvers.add(new CustomUriResolver(options.customUrlMappings));
+  }
+  resolvers.add(sdkResolver);
+  if (fileResolvers == null) fileResolvers = createFileResolvers(options);
+  resolvers.addAll(fileResolvers);
+  return new SourceFactory(resolvers);
+}
+
+List<UriResolver> createFileResolvers(AnalyzerOptions options) {
+  return [
+    new FileUriResolver(),
+    options.useMultiPackage
+        ? new MultiPackageResolver(options.packagePaths)
+        : new PackageUriResolver([new JavaFile(options.packageRoot)])
+  ];
+}
+
+/// Creates a [DartUriResolver] that uses a mock 'dart:' library contents.
+DartUriResolver createMockSdkResolver(Map<String, String> mockSources) =>
+    new MockDartSdk(mockSources, reportMissing: true).resolver;
+
+/// Creates a [DartUriResolver] that uses the SDK at the given [sdkPath].
+DartUriResolver createSdkPathResolver(String sdkPath) {
+  var sdk = new DirectoryBasedDartSdk(
+      new JavaFile(sdkPath), /*useDart2jsPaths:*/ true);
+  sdk.useSummary = true;
+  sdk.analysisOptions = new AnalysisOptionsImpl()..strongMode = true;
+  return new DartUriResolver(sdk);
+}