run method

  1. @override
Future<int> run()
override

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();
  }
}