private static void WriteCommands(
RenderableComposer composer,
CommandModel model,
ICommandContainer command,
bool isDefaultCommand)
{
var commands = isDefaultCommand ? model.Commands : command.Commands;
if (commands.Count > 0)
{
composer.Color(ConsoleColor.Yellow, c => c.Text("COMMANDS:")).LineBreak();
var maxCommandLength = commands.Max(x => x.Name.Length);
foreach (var child in commands)
{
composer.Tab().Text(child.Name);
composer.Spaces(maxCommandLength - child.Name.Length);
composer.Tab().Text(child.Description?.TrimEnd('.') ?? string.Empty);
composer.LineBreak();
}
}
}
private static void WriteArguments(RenderableComposer composer, CommandInfo?command)
{
var arguments = new List <HelpArgument>();
arguments.AddRange(command?.Parameters?.OfType <CommandArgument>()?.Select(
x => new HelpArgument(x.Value, x.Required, x.Description))
?? Array.Empty <HelpArgument>());
if (arguments.Count == 0)
{
return;
}
composer.Color(ConsoleColor.Yellow, c => c.Text("ARGUMENTS:")).LineBreak();
var maxLength = arguments.Max(arg => arg.Name.Length);
foreach (var argument in arguments)
{
composer.Tab();
// Argument name.
composer.Condition(
argument.Required,
@true: c1 => c1.Color(ConsoleColor.Gray, c => c.Text($"<{argument.Name}>")),
@false: c1 => c1.Color(ConsoleColor.Gray, c => c.Text($"[{argument.Name}]")));
// Description
composer.Spaces(maxLength - argument.Name.Length);
composer.Tab().Text(argument.Description?.TrimEnd('.')?.Trim());
composer.LineBreak();
}
composer.LineBreak();
}
private static void WriteUsage(RenderableComposer composer, CommandModel model, CommandInfo command)
{
var parameters = new Stack <IRenderable>();
if (command == null)
{
parameters.Push(new ColorElement(ConsoleColor.Cyan, new TextElement("<COMMAND>")));
parameters.Push(new ColorElement(ConsoleColor.DarkGray, new TextElement("[OPTIONS]")));
}
else
{
var current = command;
if (command.IsBranch)
{
parameters.Push(new ColorElement(ConsoleColor.Cyan, new TextElement("<COMMAND>")));
}
while (current != null)
{
var builder = new BlockElement();
if (!current.IsDefaultCommand)
{
builder.Append(new TextElement(current.Name));
}
if (current.Parameters.OfType <CommandArgument>().Any())
{
var isCurrent = current == command;
if (isCurrent)
{
foreach (var argument in current.Parameters.OfType <CommandArgument>()
.Where(a => a.Required).OrderBy(a => a.Position).ToArray())
{
var text = new TextElement($" <{argument.Value}>");
builder.Append(new ColorElement(ConsoleColor.Cyan, text));
}
}
var optionalArguments = current.Parameters.OfType <CommandArgument>().Where(x => !x.Required).ToArray();
if (optionalArguments.Length > 0 || !isCurrent)
{
foreach (var optionalArgument in optionalArguments)
{
var text = new TextElement($" [{optionalArgument.Value}]");
builder.Append(new ColorElement(ConsoleColor.Gray, text));
}
}
}
if (current == command)
{
builder.Append(new ColorElement(ConsoleColor.DarkGray, new TextElement(" [OPTIONS]")));
}
parameters.Push(builder);
current = current.Parent;
}
}
composer.Color(ConsoleColor.Yellow, c => c.Text("USAGE:")).LineBreak();
composer.Tab().Text(model.ApplicationName ?? Path.GetFileName(Assembly.GetEntryAssembly().Location));
// Root or not a default command?
if (command?.IsDefaultCommand != true)
{
composer.Space();
}
composer.Join(" ", parameters);
}
