Compartilhar via

Preenchimento com Tab para System.CommandLine

Os aplicativos que usam System.CommandLine têm suporte interno para o preenchimento com Tab em determinados shells. Para habilitá-lo, o usuário final deve executar algumas etapas uma vez por shell. Depois que isso for concluído, a conclusão da guia será automática para valores estáticos em seu aplicativo, como valores ou valores de enumeração definidos pela chamada AcceptOnlyFromAmong(String[]). Você também pode personalizar a conclusão da guia fornecendo valores dinamicamente em runtime.

Ativar o recurso auto-completar com TAB

No computador em que você, usuário final, deseja habilitar o autocompletar de abas, siga estas etapas.

Para a CLI do .NET:

Para outros aplicativos de linha de comando criados em System.CommandLine:

  • Instale a dotnet-suggest ferramenta global:

    dotnet tool install -g dotnet-suggest

  • Adicionar o script de shim apropriado ao seu perfil de shell. Talvez seja necessário criar um arquivo de perfil de shell. O script shim encaminha solicitações de conclusão do seu shell para a ferramenta dotnet-suggest, que as delega ao aplicativo baseado em System.CommandLine apropriado.

    • Para bash, adicione o conteúdo de dotnet-suggest-shim.bash a ~/.bash_profile.

    • Para zsh, adicione o conteúdo de dotnet-suggest-shim.zsh a ~/.zshrc.

    • Para o PowerShell, adicione o conteúdo de dotnet-suggest-shim.ps1 ao seu perfil do PowerShell e reinicie o PowerShell. Você pode encontrar o caminho esperado para o perfil do PowerShell com o seguinte comando:

      echo $profile

  • Registre o aplicativo chamando dotnet-suggest register --command-path $executableFilePath, onde $executableFilePath está o caminho para o arquivo executável do aplicativo.

Depois que o shell do usuário estiver configurado e o executável registrado, as conclusões funcionarão para todos os aplicativos criados usando System.CommandLine.

Para cmd.exe no Windows (o Prompt de Comando do Windows), não há nenhum mecanismo de conclusão de guia pluggável, portanto, nenhum script shim está disponível. Para outros shells, procure um issue do GitHub marcado como Area-Completions. Se você não encontrar um problema, poderá abrir um novo.

Obter valores de conclusão da guia em runtime

O código a seguir mostra um aplicativo que recupera valores para conclusão de guia dinamicamente em runtime. O código obtém uma lista das próximas semanas de datas após a data atual. A lista é fornecida à opção --date chamando CompletionSources.Add:

using System.CommandLine;
using System.CommandLine.Completions;
using System.CommandLine.Parsing;

new DateCommand().Parse(args).Invoke();

class DateCommand : Command
{
    private Argument<string> subjectArgument = new("subject")
    {
        Description = "The subject of the appointment."
    };
    private Option<DateTime> dateOption = new("--date")
    {
        Description = "The day of week to schedule. Should be within one week."
    };

    public DateCommand() : base("schedule", "Makes an appointment for sometime in the next week.")
    {
        this.Arguments.Add(subjectArgument);
        this.Options.Add(dateOption);

        dateOption.CompletionSources.Add(ctx => {
            var today = System.DateTime.Today;
            List<CompletionItem> dates = new();
            foreach (var i in Enumerable.Range(1, 7))
            {
                var date = today.AddDays(i);
                dates.Add(new CompletionItem(
                    label: date.ToShortDateString(),
                    sortText: $"{i:2}"));
            }
            return dates;
        });

        this.SetAction(parseResult =>
        {
            Console.WriteLine($"Scheduled \"{parseResult.GetValue(subjectArgument)}\" for {parseResult.GetValue(dateOption)}");
        });
    }
}

Os valores mostrados quando a tecla Tab é pressionada são fornecidos como CompletionItem instâncias:

dates.Add(new CompletionItem(
    label: date.ToShortDateString(),
    sortText: $"{i:2}"));

As seguintes CompletionItem propriedades são definidas:

  • Label é o valor de conclusão a ser mostrado.
  • SortText garante que os valores na lista sejam apresentados na ordem correta. Ele é definido convertendo i em uma cadeia de caracteres de dois dígitos, de modo que a classificação seja baseada em 01, 02, 03 e assim por diante, até 14. Se você não definir esse parâmetro, a classificação será baseada em Label, que neste exemplo está no formato de data curta e não será classificado corretamente.

Há outras CompletionItem propriedades, como Documentation e Detail, mas elas ainda não são usadas em System.CommandLine.

A lista dinâmica de preenchimento com Tab criada por esse código também aparece na saída da ajuda:

Description:
  Makes an appointment for sometime in the next week.

Usage:
  schedule <subject> [options]

Arguments:
  <subject>  The subject of the appointment.

Options:
  --date                                                                          The day of week to schedule. Should be within one week.
  <12/4/2025|12/5/2025|12/6/2025|12/7/2025|12/8/2025|12/9/2025|12/10/2025>
  --version                                                                       Show version information
  -?, -h, --help

Consulte também

  • Last updated on