public bool?CanHandle(IShellState shellState, TProgramState programState, TParseResult parseResult)
{
shellState = shellState ?? throw new ArgumentNullException(nameof(shellState));
if (!DefaultCommandInput <TParseResult> .TryProcess(InputSpec, parseResult, out DefaultCommandInput <TParseResult> commandInput, out IReadOnlyList <CommandInputProcessingIssue> processingIssues))
{
//If this is the right command, just not the right syntax, report the usage errors
if (processingIssues.All(x => x.Kind != CommandInputProcessingIssueKind.CommandMismatch))
{
foreach (CommandInputProcessingIssue issue in processingIssues)
{
shellState.ConsoleManager.Error.WriteLine(GetStringForIssue(issue));
}
string help = GetHelpDetails(shellState, programState, parseResult);
shellState.ConsoleManager.WriteLine(help);
return(false);
}
//If there was a mismatch in the command name, this isn't our input to handle
return(null);
}
return(CanHandle(shellState, programState, commandInput));
}
public Task ExecuteAsync(IShellState shellState, TProgramState programState, TParseResult parseResult, CancellationToken cancellationToken)
{
if (!DefaultCommandInput <TParseResult> .TryProcess(InputSpec, parseResult, out DefaultCommandInput <TParseResult> commandInput, out IReadOnlyList <CommandInputProcessingIssue> _))
{
return(Task.CompletedTask);
}
return(ExecuteAsync(shellState, programState, commandInput, parseResult, cancellationToken));
}
public string GetHelpDetails(IShellState shellState, TProgramState programState, TParseResult parseResult)
{
if (!DefaultCommandInput <TParseResult> .TryProcess(InputSpec, parseResult, out DefaultCommandInput <TParseResult> commandInput, out IReadOnlyList <CommandInputProcessingIssue> processingIssues) &&
processingIssues.Any(x => x.Kind == CommandInputProcessingIssueKind.CommandMismatch))
{
//If this is the right command, just not the right syntax, report the usage errors
return(null);
}
return(GetHelpDetails(shellState, programState, commandInput, parseResult));
}
public IEnumerable <string> Suggest(IShellState shellState, TProgramState programState, TParseResult parseResult)
{
DefaultCommandInput <TParseResult> .TryProcess(InputSpec, parseResult, out DefaultCommandInput <TParseResult> commandInput, out IReadOnlyList <CommandInputProcessingIssue> _);
string normalCompletionString = parseResult.SelectedSection == parseResult.Sections.Count
? string.Empty
: parseResult.Sections[parseResult.SelectedSection].Substring(0, parseResult.CaretPositionWithinSelectedSection);
//If we're completing in a name position, offer completion for the command name
if (parseResult.SelectedSection < InputSpec.CommandName.Count)
{
IReadOnlyList <string> commandName = null;
for (int j = 0; j < InputSpec.CommandName.Count; ++j)
{
bool success = true;
for (int i = 0; i < parseResult.SelectedSection; ++i)
{
if (!string.Equals(InputSpec.CommandName[j][i], parseResult.Sections[i], StringComparison.OrdinalIgnoreCase))
{
success = false;
break;
}
}
if (success)
{
commandName = InputSpec.CommandName[j];
break;
}
}
if (commandName is null)
{
return(null);
}
if (commandName[parseResult.SelectedSection].StartsWith(normalCompletionString, StringComparison.OrdinalIgnoreCase))
{
return(new[] { commandName[parseResult.SelectedSection] });
}
}
if (commandInput is null)
{
return(null);
}
if (normalCompletionString.StartsWith(InputSpec.OptionPreamble.ToString()))
{
return(GetOptionCompletions(commandInput, normalCompletionString));
}
IEnumerable <string> completions = Enumerable.Empty <string>();
CommandInputLocation?inputLocation = commandInput.SelectedElement?.Location;
if (inputLocation != CommandInputLocation.OptionValue && commandInput.Arguments.Count < InputSpec.MaximumArguments)
{
IEnumerable <string> results = GetArgumentSuggestionsForText(shellState, programState, parseResult, commandInput, normalCompletionString);
if (results != null)
{
completions = results;
}
}
switch (inputLocation)
{
case CommandInputLocation.OptionName:
{
IEnumerable <string> results = GetOptionCompletions(commandInput, normalCompletionString);
if (results != null)
{
completions = completions.Union(results);
}
break;
}
case CommandInputLocation.OptionValue:
{
IEnumerable <string> results = GetOptionValueCompletions(shellState, programState, commandInput.SelectedElement.Owner.NormalizedText, commandInput, parseResult, normalCompletionString);
if (results != null)
{
completions = completions.Union(results);
}
break;
}
case CommandInputLocation.Argument:
{
IEnumerable <string> argumentResults = GetArgumentSuggestionsForText(shellState, programState, parseResult, commandInput, normalCompletionString);
if (argumentResults != null)
{
completions = completions.Union(argumentResults);
}
if (string.IsNullOrEmpty(normalCompletionString))
{
IEnumerable <string> results = GetOptionCompletions(commandInput, normalCompletionString);
if (results != null)
{
completions = completions.Union(results);
}
}
break;
}
}
return(completions);
}