start static method

Future<ReviewLocalServer> start({
  1. required String repoRoot,
  2. String? site,
  3. int preferredPort = defaultReviewServerPort,
  4. ReviewProjectConfig? config,
  5. String? reviewDirectoryName,
  6. String? cliResolveCommand,
})

Starts the local review server on 127.0.0.1, trying preferredPort (4099 by default) first and automatically falling back to an OS-assigned ephemeral port (0) if preferredPort is already occupied.

Implementation

static Future<ReviewLocalServer> start({
  required String repoRoot,
  String? site,
  int preferredPort = defaultReviewServerPort,
  ReviewProjectConfig? config,
  String? reviewDirectoryName,
  String? cliResolveCommand,
}) async {
  final effectiveConfig = (config ?? ReviewProjectConfig.load(repoRoot))
      .copyWith(
        reviewDirectoryName: reviewDirectoryName,
        cliResolveCommand: cliResolveCommand,
      );
  final effectiveSite = site ?? effectiveConfig.defaultSite;

  HttpServer server;
  try {
    server = await HttpServer.bind(
      InternetAddress.loopbackIPv4,
      preferredPort,
    );
  } on SocketException {
    if (preferredPort == 0) rethrow;
    server = await HttpServer.bind(InternetAddress.loopbackIPv4, 0);
  }

  return ReviewLocalServer._(
    server: server,
    repoRoot: repoRoot,
    site: effectiveSite,
    config: effectiveConfig,
  );
}