Autocompletar (winget)

A ferramenta de linha de comando winget oferece um comando complete para fornecer a conclusão da guia sensível ao contexto. Ele dá suporte à conclusão de nomes de comando, nomes de argumentos e valores de argumento, dependendo do estado atual da linha de comando.

Ativar o recurso auto-completar com TAB

Para habilitar a conclusão da guia com winget, você deve adicionar o script a seguir ao $PROFILE no PowerShell.

  1. Abra o PowerShell e insira o seguinte comando para abrir seu $PROFILE no Bloco de Notas: notepad.exe $PROFILE

  2. Copie e cole o seguinte script no $PROFILE arquivo que foi aberto no Bloco de Notas:

    Register-ArgumentCompleter -Native -CommandName winget -ScriptBlock {
    param($wordToComplete, $commandAst, $cursorPosition)
        [Console]::InputEncoding = [Console]::OutputEncoding = $OutputEncoding = [System.Text.Utf8Encoding]::new()
        $Local:word = $wordToComplete.Replace('"', '""')
        $Local:ast = $commandAst.ToString().Replace('"', '""')
        winget complete --word="$Local:word" --commandline "$Local:ast" --position $cursorPosition | ForEach-Object {
            [System.Management.Automation.CompletionResult]::new($_, $_, 'ParameterValue', $_)
        }
}

  3. Salve o $PROFILE com seu script. Em seguida, feche e reabra o PowerShell. Depois que o PowerShell for reaberto, a conclusão da guia winget será habilitada.

Exemplos de conclusão com a tecla Tab

Pressionamentos repetidos da tecla de tabulação (⇥) resultarão na alternância entre os valores possíveis.

Entrada Resultado Motivo
winget ⇥ winget install install é o primeiro comando abaixo da raiz
winget sh⇥ winget show show é o primeiro comando que começa com sh
winget source l⇥ winget source list list é o primeiro subcomando de origem que começa com l
winget -⇥ winget --version --version é o primeiro argumento definido para a raiz
winget install power⇥ winget install "Power Toys" "Power Toys" é o primeiro pacote cuja ID, Nome ou Moniker começa com power
winget install "Power Toys" --version ⇥ winget install "Power Toys" --version 0.19.2 0.19.2 é a versão mais recente do Power Toys no momento da escrita

Referência de comando

O comando completo usa três argumentos necessários:

Argumento Descrição
--word A palavra atual que está sendo concluída; o elemento no qual o cursor está localizado. Pode estar vazio para indicar nenhum valor atual no cursor, mas, se fornecido, ele deverá aparecer como uma subcadeia de caracteres na linha de comando.
--commandline Toda a linha de comando atual, incluindo winget. Veja os exemplos acima; tudo, exceto o caractere de guia (⇥) deve ser fornecido para esse argumento.
--position A posição atual do cursor na linha de comando. Pode ser maior que o comprimento da cadeia de caracteres de linha de comando para indicar no final.

Quando um valor para a palavra é fornecido, a conclusão opera no modo de substituição. Ele sugerirá completações que se ajustariam corretamente neste local e que também comecem com o valor de palavra fornecido.

Quando um valor de palavra não é fornecido (um valor vazio é atribuído à palavra, ex. --word=), a conclusão opera no modo de inserção. Ele sugerirá conclusões que se ajustariam como um novo valor no local do cursor.

Com base nos argumentos, as conclusões sugeridas podem ser uma das seguintes:

  1. Um subcomando :: o cursor está localizado logo após um comando e há subcomandos disponíveis.
  2. Um especificador de argumento:: o cursor não é posicionado após um especificador de argumento que espera um valor e há argumentos disponíveis.
  3. Um valor de argumento :: o cursor é posicionado após um especificador de argumento que espera um valor ou um argumento posicional é esperado.

Depois de avaliar todos esses casos, os completamentos potenciais são exibidos, um em cada linha. Se a cadeia de caracteres de conclusão contiver um espaço, ela será encapsulada entre aspas.

  • Last updated on