| // Copyright (c) 2014, 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:path/path.dart' as p; |
| |
| import '../command.dart'; |
| import '../executable.dart'; |
| import '../log.dart' as log; |
| import '../utils.dart'; |
| |
| /// Handles the `run` pub command. |
| class RunCommand extends PubCommand { |
| @override |
| String get name => 'run'; |
| @override |
| String get description => 'Run an executable from a package.'; |
| @override |
| String get argumentsDescription => '<executable> [arguments...]'; |
| @override |
| String get docUrl => 'https://dart.dev/tools/pub/cmd/pub-run'; |
| @override |
| bool get allowTrailingOptions => false; |
| @override |
| bool get hidden => deprecated; |
| |
| final bool deprecated; |
| final bool alwaysUseSubprocess; |
| |
| RunCommand({ |
| this.deprecated = false, |
| this.alwaysUseSubprocess = false, |
| }) { |
| argParser.addFlag('enable-asserts', help: 'Enable assert statements.'); |
| argParser.addFlag('checked', abbr: 'c', hide: true); |
| argParser.addMultiOption('enable-experiment', |
| help: |
| 'Runs the executable in a VM with the given experiments enabled.\n' |
| '(Will disable snapshotting, resulting in slower startup).', |
| valueHelp: 'experiment'); |
| argParser.addFlag('sound-null-safety', |
| help: 'Override the default null safety execution mode.'); |
| argParser.addOption('mode', help: 'Deprecated option', hide: true); |
| argParser.addOption('directory', |
| abbr: 'C', help: 'Run this in the directory<dir>.', valueHelp: 'dir'); |
| } |
| |
| @override |
| Future<void> runProtected() async { |
| if (deprecated) { |
| await log.warningsOnlyUnlessTerminal(() { |
| log.message('Deprecated. Use `dart run` instead.'); |
| }); |
| } |
| if (argResults.rest.isEmpty) { |
| usageException('Must specify an executable to run.'); |
| } |
| |
| var package = entrypoint.root.name; |
| var executable = argResults.rest[0]; |
| var args = argResults.rest.skip(1).toList(); |
| |
| // A command like "foo:bar" runs the "bar" script from the "foo" package. |
| // If there is no colon prefix, default to the root package. |
| if (executable.contains(':')) { |
| var components = split1(executable, ':'); |
| package = components[0]; |
| executable = components[1]; |
| |
| if (p.split(executable).length > 1) { |
| usageException( |
| 'Cannot run an executable in a subdirectory of a dependency.'); |
| } |
| } else if (onlyIdentifierRegExp.hasMatch(executable)) { |
| // "pub run foo" means the same thing as "pub run foo:foo" as long as |
| // "foo" is a valid Dart identifier (and thus package name). |
| package = executable; |
| } |
| |
| if (argResults.wasParsed('mode')) { |
| log.warning('The --mode flag is deprecated and has no effect.'); |
| } |
| |
| final vmArgs = vmArgsFromArgResults(argResults); |
| |
| var exitCode = await runExecutable( |
| entrypoint, |
| Executable.adaptProgramName(package, executable), |
| args, |
| enableAsserts: argResults['enable-asserts'] || argResults['checked'], |
| recompile: (executable) => log.warningsOnlyUnlessTerminal( |
| () => entrypoint.precompileExecutable(executable)), |
| vmArgs: vmArgs, |
| alwaysUseSubprocess: alwaysUseSubprocess, |
| ); |
| overrideExitCode(exitCode); |
| } |
| } |