blob: 78dcd69e6877c731625d3bb099fb2c60fd00e2af [file] [log] [blame]
// 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 '../io.dart';
import '../log.dart' as log;
import '../utils.dart';
/// Handles the `global run` pub command.
class GlobalRunCommand extends PubCommand {
String get name => 'run';
String get description =>
'Run an executable from a globally activated package.\n'
"NOTE: We are currently optimizing this command's startup time.";
String get argumentsDescription => '<package>:<executable> [args...]';
bool get allowTrailingOptions => false;
GlobalRunCommand() {
argParser.addFlag('enable-asserts', help: 'Enable assert statements.');
argParser.addFlag('checked', abbr: 'c', hide: true);
help: 'Runs the executable in a VM with the given experiments enabled. '
'(Will disable snapshotting, resulting in slower startup).',
valueHelp: 'experiment');
help: 'Override the default null safety execution mode.');
argParser.addOption('mode', help: 'Deprecated option', hide: true);
Future runProtected() async {
if ( {
usageException('Must specify an executable to run.');
String package;
var executable =[0];
if (executable.contains(':')) {
var parts = split1(executable, ':');
package = parts[0];
executable = parts[1];
} else {
// If the package name is omitted, use the same name for both.
package = executable;
var args =;
if (p.split(executable).length > 1) {
usageException('Cannot run an executable in a subdirectory of a global '
if (argResults.wasParsed('mode')) {
log.warning('The --mode flag is deprecated and has no effect.');
final vmArgs = vmArgsFromArgResults(argResults);
final globalEntrypoint = await globals.find(package);
final exitCode = await globals.runExecutable(globalEntrypoint,
Executable.adaptProgramName(package, executable), args,
vmArgs: vmArgs,
enableAsserts: argResults['enable-asserts'] || argResults['checked'],
recompile: (executable) => log.warningsOnlyUnlessTerminal(
() => globalEntrypoint.precompileExecutable(executable)));
await flushThenExit(exitCode);