start static method
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,
);
}