// Copyright (c) 2019, 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. // @dart = 2.9 /// Test the modular compilation pipeline of ddc. /// /// This is a shell that runs multiple tests, one per folder under `data/`. import 'dart:io'; import 'package:modular_test/src/io_pipeline.dart'; import 'package:modular_test/src/pipeline.dart'; import 'package:modular_test/src/runner.dart'; import 'package:modular_test/src/suite.dart'; import 'package:package_config/package_config.dart'; String packageConfigJsonPath = '.dart_tool/package_config.json'; Uri sdkRoot = Platform.script.resolve('../../../'); Uri packageConfigUri = sdkRoot.resolve(packageConfigJsonPath); Options _options; String _dartdevcScript; String _kernelWorkerScript; // TODO(joshualitt): Figure out a way to support package configs in // tests/modular. PackageConfig _packageConfig; void main(List args) async { _options = Options.parse(args); _packageConfig = await loadPackageConfigUri(packageConfigUri); await _resolveScripts(); await runSuite( sdkRoot.resolve('tests/modular/'), 'tests/modular', _options, IOPipeline([ SourceToSummaryDillStep(), DDCStep(), RunD8(), ], cacheSharedModules: true)); } const dillId = DataId('dill'); const jsId = DataId('js'); const txtId = DataId('txt'); String _packageConfigEntry(String name, Uri root, {Uri packageRoot, LanguageVersion version}) { var fields = [ '"name": "$name"', '"rootUri": "$root"', if (packageRoot != null) '"packageUri": "$packageRoot"', if (version != null) '"languageVersion": "$version"' ]; return '{${fields.join(',')}}'; } class SourceToSummaryDillStep implements IOModularStep { @override List get resultData => const [dillId]; @override bool get needsSources => true; @override List get dependencyDataNeeded => const [dillId]; @override List get moduleDataNeeded => const []; @override bool get onlyOnMain => false; @override Future execute(Module module, Uri root, ModuleDataToRelativeUri toUri, List flags) async { if (_options.verbose) print('\nstep: source-to-dill on $module'); // We use non file-URI schemes for representing source locations in a // root-agnostic way. This allows us to refer to file across modules and // across steps without exposing the underlying temporary folders that are // created by the framework. In build systems like bazel this is especially // important because each step may be run on a different machine. // // Files in packages are defined in terms of `package:` URIs, while // non-package URIs are defined using the `dart-dev-app` scheme. var rootScheme = module.isSdk ? 'dev-dart-sdk' : 'dev-dart-app'; String sourceToImportUri(Uri relativeUri) => _sourceToImportUri(module, rootScheme, relativeUri); var transitiveDependencies = computeTransitiveDependencies(module); await _createPackagesFile(module, root, transitiveDependencies); List sources; List extraArgs; if (module.isSdk) { sources = ['dart:core']; extraArgs = [ '--libraries-file', '$rootScheme:///sdk/lib/libraries.json', '--enable-experiment', 'non-nullable', ]; assert(transitiveDependencies.isEmpty); } else { sources = module.sources.map(sourceToImportUri).toList(); extraArgs = ['--packages-file', '$rootScheme:/.packages']; } var sdkModule = module.isSdk ? module : module.dependencies.firstWhere((m) => m.isSdk); var args = [ _kernelWorkerScript, '--summary-only', '--target', 'ddc', '--multi-root', '$root', '--multi-root-scheme', rootScheme, ...extraArgs, '--output', '${toUri(module, dillId)}', if (!module.isSdk) ...[ '--dart-sdk-summary', '${toUri(sdkModule, dillId)}', '--exclude-non-sources', ], ...(transitiveDependencies .where((m) => !m.isSdk) .expand((m) => ['--input-summary', '${toUri(m, dillId)}'])), ...(sources.expand((String uri) => ['--source', uri])), ...(flags.expand((String flag) => ['--enable-experiment', flag])), ]; var result = await _runProcess(Platform.resolvedExecutable, args, root.toFilePath()); _checkExitCode(result, this, module); } @override void notifyCached(Module module) { if (_options.verbose) print('\ncached step: source-to-dill on $module'); } } class DDCStep implements IOModularStep { @override List get resultData => const [jsId]; @override bool get needsSources => true; @override List get dependencyDataNeeded => const [dillId]; @override List get moduleDataNeeded => const [dillId]; @override bool get onlyOnMain => false; @override Future execute(Module module, Uri root, ModuleDataToRelativeUri toUri, List flags) async { if (_options.verbose) print('\nstep: ddc on $module'); var transitiveDependencies = computeTransitiveDependencies(module); await _createPackagesFile(module, root, transitiveDependencies); var rootScheme = module.isSdk ? 'dev-dart-sdk' : 'dev-dart-app'; List sources; List extraArgs; if (module.isSdk) { sources = ['dart:core']; extraArgs = [ '--compile-sdk', '--libraries-file', '$rootScheme:///sdk/lib/libraries.json', '--enable-experiment', 'non-nullable', ]; assert(transitiveDependencies.isEmpty); } else { var sdkModule = module.dependencies.firstWhere((m) => m.isSdk); sources = module.sources .map((relativeUri) => _sourceToImportUri(module, rootScheme, relativeUri)) .toList(); extraArgs = [ '--dart-sdk-summary', '${toUri(sdkModule, dillId)}', '--packages', '.packages', ]; } var output = toUri(module, jsId); var args = [ '--packages=${sdkRoot.toFilePath()}/.packages', _dartdevcScript, '--kernel', '--modules=es6', '--no-summarize', '--no-source-map', '--multi-root-scheme', rootScheme, ...sources, ...extraArgs, for (String flag in flags) '--enable-experiment=$flag', ...(transitiveDependencies .where((m) => !m.isSdk) .expand((m) => ['-s', '${toUri(m, dillId)}=${m.name}'])), '-o', '$output', ]; var result = await _runProcess(Platform.resolvedExecutable, args, root.toFilePath()); _checkExitCode(result, this, module); } @override void notifyCached(Module module) { if (_options.verbose) print('\ncached step: ddc on $module'); } } class RunD8 implements IOModularStep { @override List get resultData => const [txtId]; @override bool get needsSources => false; @override List get dependencyDataNeeded => const [jsId]; @override List get moduleDataNeeded => const [jsId]; @override bool get onlyOnMain => true; @override Future execute(Module module, Uri root, ModuleDataToRelativeUri toUri, List flags) async { if (_options.verbose) print('\nstep: d8 on $module'); // Rename sdk.js to dart_sdk.js (the alternative, but more hermetic solution // would be to rename the import on all other .js files, but seems // overkill/unnecessary. if (await File.fromUri(root.resolve('dart_sdk.js')).exists()) { throw 'error: dart_sdk.js already exists.'; } await File.fromUri(root.resolve('sdk.js')) .copy(root.resolve('dart_sdk.js').toFilePath()); var runjs = ''' import { dart, _isolate_helper } from 'dart_sdk.js'; import { main } from 'main.js'; _isolate_helper.startRootIsolate(() => {}, []); main.main(); '''; var wrapper = root.resolveUri(toUri(module, jsId)).toFilePath() + '.wrapper.js'; await File(wrapper).writeAsString(runjs); var d8Args = ['--module', wrapper]; var result = await _runProcess( sdkRoot.resolve(_d8executable).toFilePath(), d8Args, root.toFilePath()); _checkExitCode(result, this, module); await File.fromUri(root.resolveUri(toUri(module, txtId))) .writeAsString(result.stdout as String); } @override void notifyCached(Module module) { if (_options.verbose) print('\ncached step: d8 on $module'); } } void _checkExitCode(ProcessResult result, IOModularStep step, Module module) { if (result.exitCode != 0 || _options.verbose) { stdout.write(result.stdout); stderr.write(result.stderr); } if (result.exitCode != 0) { throw '${step.runtimeType} failed on $module:\n\n' 'stdout:\n${result.stdout}\n\n' 'stderr:\n${result.stderr}'; } } Future _runProcess( String command, List arguments, String workingDirectory) { if (_options.verbose) { print('command:\n$command ${arguments.join(' ')} from $workingDirectory'); } return Process.run(command, arguments, workingDirectory: workingDirectory); } String get _d8executable { if (Platform.isWindows) { return 'third_party/d8/windows/d8.exe'; } else if (Platform.isLinux) { return 'third_party/d8/linux/d8'; } else if (Platform.isMacOS) { return 'third_party/d8/macos/d8'; } throw UnsupportedError('Unsupported platform.'); } Future _createPackagesFile( Module module, Uri root, Set transitiveDependencies) async { // We create both a .packages and package_config.json file which defines // the location of this module if it is a package. The CFE requires that // if a `package:` URI of a dependency is used in an import, then we need // that package entry in the associated file. However, after it checks that // the definition exists, the CFE will not actually use the resolved URI if // a library for the import URI is already found in one of the provide // .dill files of the dependencies. For that reason, and to ensure that // a step only has access to the files provided in a module, we generate a // config file with invalid folders for other packages. // TODO(sigmund): follow up with the CFE to see if we can remove the need // for these dummy entries.. // TODO(joshualitt): Generate just the json file. var packagesJson = []; var packagesContents = StringBuffer(); if (module.isPackage) { packagesContents.write('${module.name}:${module.packageBase}\n'); packagesJson.add(_packageConfigEntry( module.name, Uri.parse('../${module.packageBase}'))); } var unusedNum = 0; for (var dependency in transitiveDependencies) { if (dependency.isPackage) { // rootUri should be ignored for dependent modules, so we pass in a // bogus value. var rootUri = Uri.parse('unused$unusedNum'); unusedNum++; var dependentPackage = _packageConfig[dependency.name]; var packageJson = dependentPackage == null ? _packageConfigEntry(dependency.name, rootUri) : _packageConfigEntry(dependentPackage.name, rootUri, version: dependentPackage.languageVersion); packagesJson.add(packageJson); packagesContents.write('${dependency.name}:$rootUri\n'); } } if (module.isPackage) { await File.fromUri(root.resolve(packageConfigJsonPath)) .create(recursive: true); await File.fromUri(root.resolve(packageConfigJsonPath)).writeAsString('{' ' "configVersion": ${_packageConfig.version},' ' "packages": [ ${packagesJson.join(',')} ]' '}'); } await File.fromUri(root.resolve('.packages')) .writeAsString('$packagesContents'); } String _sourceToImportUri(Module module, String rootScheme, Uri relativeUri) { if (module.isPackage) { var basePath = module.packageBase.path; var packageRelativePath = basePath == './' ? relativeUri.path : relativeUri.path.substring(basePath.length); return 'package:${module.name}/$packageRelativePath'; } else { return '$rootScheme:/$relativeUri'; } } Future _resolveScripts() async { Future resolve( String sdkSourcePath, String relativeSnapshotPath) async { var result = sdkRoot.resolve(sdkSourcePath).toFilePath(); if (_options.useSdk) { var snapshot = Uri.file(Platform.resolvedExecutable) .resolve(relativeSnapshotPath) .toFilePath(); if (await File(snapshot).exists()) { return snapshot; } } return result; } _dartdevcScript = await resolve( 'pkg/dev_compiler/bin/dartdevc.dart', 'snapshots/dartdevc.dart.snapshot'); _kernelWorkerScript = await resolve('utils/bazel/kernel_worker.dart', 'snapshots/kernel_worker.dart.snapshot'); }