{"meta":{"title":"resolver arquivos","intro":"[Conexão detalhada] Expanda um conjunto de globs de inclusão/exclusão de arquivos.","product":"Qualidade de segurança e código","breadcrumbs":[{"href":"/pt/code-security","title":"Qualidade de segurança e código"},{"href":"/pt/code-security/reference","title":"Referência"},{"href":"/pt/code-security/reference/code-scanning","title":"Varredura de código"},{"href":"/pt/code-security/reference/code-scanning/codeql","title":"CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual","title":"Manual da CLI do CodeQL"},{"href":"/pt/code-security/reference/code-scanning/codeql/codeql-cli-manual/resolve-files","title":"resolver arquivos"}],"documentType":"article"},"body":"# resolver arquivos\n\n[Conexão detalhada] Expanda um conjunto de globs de inclusão/exclusão de arquivos.\n\n> [!NOTE]\n> 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.\n>\n> 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.\n\n## Sinopse\n\n```shell copy\ncodeql resolve files <options>... -- <dir>\n```\n\n## Description\n\n              \\[Conexão detalhada] Expanda um conjunto de globs de inclusão/exclusão de arquivos.\n\nEsse 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.\n\nAs opções `--include`, `--exclude` e `--prune` usam padrões glob, que podem usar os seguintes caracteres curinga:\n\n* Um \"?\" corresponde a qualquer caractere diferente de uma barra \"/\" ou uma barra invertida;\n* Um \"\\*\" corresponde a qualquer número de caracteres que não seja uma barra \"/\" ou uma barra invertida;\n* O padrão \"\\*\\*\" corresponde a zero ou mais componentes de diretório completos.\n\n## Opções\n\n### Opções principais\n\n#### `<dir>`\n\nO diretório a ser pesquisado.\n\n#### `--format=<fmt>`\n\nSelecione o formato de saída, `text`_(padrão)_ ou `json`.\n\n### Opções para limitar o conjunto de arquivos coletados\n\n#### `--include-extension=<.ext>`\n\nInclua 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.\nPor 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.\n\n#### `--include=<glob>`\n\nInclua 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.\n\n              `--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).\n\n#### `--also-match=<glob>`\n\nExija 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`.\n\n#### `--exclude=<glob>`\n\nExclua 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.\n\n#### `--prune=<glob>`\n\nExclua 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.\n\n#### `--size-limit=<bytes>`\n\nExclua 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.\n\n#### `--total-size-limit=<bytes>`\n\nFaz 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\".\n\n#### `--[no-]follow-symlinks`\n\nSiga os links simbólicos para os respectivos destinos.\n\n#### `--[no-]find-any`\n\nEncontre, no máximo, uma correspondência (em vez de todas as correspondências).\n\nDisponível desde `v2.11.3`.\n\n### Opções comuns\n\n#### `-h, --help`\n\nMostre este texto de ajuda.\n\n#### `-J=<opt>`\n\n              \\[Avançado] Forneça a opção para a JVM que executa o comando.\n\n(Use-a com cautela, pois as opções que contêm espaços não serão tratadas corretamente.)\n\n#### `-v, --verbose`\n\nAumente incrementalmente o número de mensagens de progresso impressas.\n\n#### `-q, --quiet`\n\nDiminua incrementalmente o número de mensagens de progresso impressas.\n\n#### `--verbosity=<level>`\n\n              \\[Avançado] Defina explicitamente o nível de detalhamento como erros, avisos, progresso, progresso+, progresso++ ou progresso+++. Substitui `-v` e `-q`.\n\n#### `--logdir=<dir>`\n\n              \\[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.\n\n(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.)\n\n#### `--common-caches=<dir>`\n\n              \\[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.\n\nDisponível desde `v2.15.2`."}