generateUsageSummary static method

String generateUsageSummary(
  1. ToolDefinition tool
)

Generate a short usage summary for error messages.

Implementation

static String generateUsageSummary(ToolDefinition tool) {
  final buf = StringBuffer();
  buf.writeln('Usage: ${tool.name} [options]');
  if (tool.mode == ToolMode.multiCommand && tool.commands.isNotEmpty) {
    final cmdNames = tool.visibleCommands.take(5).map((c) => ':${c.name}').join(', ');
    buf.writeln('Commands: $cmdNames${tool.visibleCommands.length > 5 ? '...' : ''}');
  }
  buf.writeln();
  buf.writeln('Use --help for more information.');
  return buf.toString();
}