# resolver arquivos

[Conexão detalhada] Expanda um conjunto de globs de inclusão/exclusão de arquivos.

> [!NOTE]
> Este conteúdo descreve a versão mais recente do CodeQL CLI. Para obter mais informações sobre essa versão, confira https://github.com/github/codeql-cli-binaries/releases.
>
> Para ver os detalhes das opções disponíveis para esse comando em uma versão anterior, execute o comando com a opção <span style="white-space: nowrap;">`--help`</span> no terminal.

## Sinopse

```shell copy
codeql resolve files <options>... -- <dir>
```

## Description

              \[Conexão detalhada] Expanda um conjunto de globs de inclusão/exclusão de arquivos.

Esse comando de conexão é responsável por expandir os parâmetros de linha de comando dos subcomandos que operam em vários arquivos, identificados pelos respectivos caminhos. Por padrão, todos os arquivos são incluídos, ou seja, a execução desse comando sem argumentos de filtro coletará todos os arquivos em um diretório.

As opções `--include`, `--exclude` e `--prune` usam padrões glob, que podem usar os seguintes caracteres curinga:

* Um "?" corresponde a qualquer caractere diferente de uma barra "/" ou uma barra invertida;
* Um "\*" corresponde a qualquer número de caracteres que não seja uma barra "/" ou uma barra invertida;
* O padrão "\*\*" corresponde a zero ou mais componentes de diretório completos.

## Opções

### Opções principais

#### `<dir>`

O diretório a ser pesquisado.

#### `--format=<fmt>`

Selecione o formato de saída, `text`_(padrão)_ ou `json`.

### Opções para limitar o conjunto de arquivos coletados

#### `--include-extension=<.ext>`

Inclua todos os arquivos na árvore de diretórios de pesquisa que têm a extensão fornecida. Normalmente, você deve incluir o ponto antes da extensão.
Por exemplo, se você transmitir `--include-extension .xml`, isso incluirá todos os arquivos com a extensão ".xml". Essa opção é incompatível com as opções `--include` negadas.

#### `--include=<glob>`

Inclua todos os arquivos e os diretórios na árvore de diretórios de pesquisa que correspondam ao glob fornecido, usando o caminho relativo de cada arquivo e diretório do diretório de pesquisa. Se o glob começar com um caractere `!`, os arquivos e os diretórios correspondentes serão excluídos.

              `--include` são processadas em ordem, com as opções posteriores substituindo as anteriores. Por exemplo, `--include ** --include !sub/*.ts --include sub/main.*` incluirá `sub/main.ts` (porque é incluído por `sub/main.*`), excluirá `sub/index.ts` (porque é excluído por `!sub/*.ts`) e incluirá `sub/test.js` (porque é incluído por `**` sem ser excluído posteriormente).

#### `--also-match=<glob>`

Exija que todos os resultados também correspondam ao glob fornecido, usando o caminho relativo de cada arquivo e diretório do diretório de pesquisa. Essa opção tem a mesma estrutura e a mesma interpretação de `--include`, mas especifica uma sequência separada de globs que são aplicados em conjunto com `--include`.

#### `--exclude=<glob>`

Exclua todos os arquivos e os diretórios que correspondam ao glob fornecido, usando o caminho relativo de cada arquivo e diretório do diretório de pesquisa. Essa opção substitui todas as opções de inclusão. Essa opção é incompatível com as opções `--include` negadas.

#### `--prune=<glob>`

Exclua todos os arquivos e os diretórios que correspondam ao glob fornecido, usando o caminho relativo de cada arquivo e diretório do diretório de pesquisa. Essa opção substitui todas as opções de inclusão. Essa opção é incompatível com as opções `--include` negadas.

#### `--size-limit=<bytes>`

Exclua todos os arquivos cujo tamanho excede o limite especificado. O limite de tamanho é indicado em bytes ou em KiB (kibibytes) com o sufixo "k", em MiB (mebibytes) com o sufixo "m" e em GiB (gibibytes) com o sufixo "g". Essa opção substitui todas as opções de inclusão.

#### `--total-size-limit=<bytes>`

Faz com que o comando saia com um erro se o tamanho combinado de todos os arquivos resolvidos excede o limite fornecido. O limite de tamanho é indicado em bytes ou em KiB (kibibytes) com o sufixo "k", em MiB (mebibytes) com o sufixo "m" e em GiB (gibibytes) com o sufixo "g".

#### `--[no-]follow-symlinks`

Siga os links simbólicos para os respectivos destinos.

#### `--[no-]find-any`

Encontre, no máximo, uma correspondência (em vez de todas as correspondências).

Disponível desde `v2.11.3`.

### Opções comuns

#### `-h, --help`

Mostre este texto de ajuda.

#### `-J=<opt>`

              \[Avançado] Forneça a opção para a JVM que executa o comando.

(Use-a com cautela, pois as opções que contêm espaços não serão tratadas corretamente.)

#### `-v, --verbose`

Aumente incrementalmente o número de mensagens de progresso impressas.

#### `-q, --quiet`

Diminua incrementalmente o número de mensagens de progresso impressas.

#### `--verbosity=<level>`

              \[Avançado] Defina explicitamente o nível de detalhamento como erros, avisos, progresso, progresso+, progresso++ ou progresso+++. Substitui `-v` e `-q`.

#### `--logdir=<dir>`

              \[Avançado] Escreva logs detalhados em um ou mais arquivos no diretório fornecido, com nomes gerados que incluem carimbos de data/hora e o nome do subcomando em execução.

(Para gravar um arquivo de log com um nome sobre o qual você tem controle completo, forneça `--log-to-stderr` e redirecione stderr conforme desejado.)

#### `--common-caches=<dir>`

              \[Avançado] Controle a localização dos dados armazenados em cache no disco que persistirão entre várias execuções da CLI, como pacotes QL baixados e planos de consulta compilada. Se não for definido explicitamente, o padrão corresponde a um diretório intitulado `.codeql` no diretório inicial do usuário; que será criado se ainda não existir.

Disponível desde `v2.15.2`.