run method
Runs this command.
The return value is wrapped in a Future if necessary and returned by
CommandRunner.runCommand.
Implementation
@override
Future<int> run() async {
final args = argResults!;
final rawPort = args.option(_portOption) ?? '$defaultReviewServerPort';
final preferredPort = int.tryParse(rawPort);
if (preferredPort == null || preferredPort < 0 || preferredPort > 65535) {
usageException('Invalid --$_portOption value "$rawPort".');
}
final dirOverride = _context.resolveDirectoryOverride(args);
if (dirOverride != null &&
sanitizeRepoRelativePath(_context.repoRoot, dirOverride) == null) {
usageException(
'Invalid --$_dirOption "$dirOverride": must stay within repository root.',
);
}
final siteFilter = _context.resolveOptionalSiteFilter(args);
final effectiveConfig = _context.resolveConfig(
reviewDirectoryOverride: dirOverride,
);
final server = await ReviewLocalServer.start(
repoRoot: _context.repoRoot,
site: siteFilter,
preferredPort: preferredPort,
config: effectiveConfig,
);
StreamSubscription<ProcessSignal>? sigintSub;
StreamSubscription<ProcessSignal>? sigtermSub;
try {
final wrappedCommand = args.rest;
if (wrappedCommand.isEmpty) {
final dartDefines = <String>[
'--dart-define=REVIEW_COMMENTS_MODE=local',
'--dart-define=REVIEW_COMMENTS_SERVER_PORT=${server.port}',
if (server.site.isNotEmpty)
'--dart-define=REVIEW_COMMENTS_SITE=${server.site}',
].join(' ');
_context.out
..writeln(
'Review comments server listening on http://localhost:${server.port} '
'(${server.origin}, syncing to ${server.feedbackRelativePath})',
)
..writeln('Pass these flags to your Flutter Web or Jaspr dev server:')
..writeln(' $dartDefines');
final done = Completer<void>();
void completeDone() {
if (!done.isCompleted) done.complete();
}
if (_stopSignal != null) {
unawaited(_stopSignal.whenComplete(completeDone));
} else {
sigintSub = ProcessSignal.sigint.watch().listen(
(_) => completeDone(),
);
if (!Platform.isWindows) {
sigtermSub = ProcessSignal.sigterm.watch().listen(
(_) => completeDone(),
);
}
}
await done.future;
return 0;
}
final built = buildWrappedDevCommandArgs(
wrappedCommand,
serverPort: server.port,
site: server.site,
);
_context.out.writeln(
'Review comments server active on http://localhost:${server.port} '
'(${server.origin}) -> ${server.feedbackRelativePath}',
);
final childEnv = <String, String>{
...Platform.environment,
'REVIEW_COMMENTS_MODE': 'local',
'REVIEW_COMMENTS_SERVER_PORT': '${server.port}',
'REVIEW_COMMENTS_SERVER_ORIGIN': server.origin,
if (server.site.isNotEmpty) 'REVIEW_COMMENTS_SITE': server.site,
};
final process = await Process.start(
built.executable,
built.arguments,
workingDirectory: _context.repoRoot,
environment: childEnv,
runInShell: Platform.isWindows,
mode: ProcessStartMode.inheritStdio,
);
Future<void> forwardSignal(ProcessSignal signal) async {
await server.close();
process.kill(signal);
}
sigintSub = ProcessSignal.sigint.watch().listen(
(signal) => unawaited(forwardSignal(signal)),
);
if (!Platform.isWindows) {
sigtermSub = ProcessSignal.sigterm.watch().listen(
(signal) => unawaited(forwardSignal(signal)),
);
}
return await process.exitCode;
} finally {
await sigintSub?.cancel();
await sigtermSub?.cancel();
await server.close();
}
}