Verifique um caminho com padrões .gitignore

Verifique um caminho relativo ao repositório usando uma lista ordenada de padrões .gitignore, sem criar um repositório temporário nem executar o Git. O resultado informa se o caminho é ignorado e, quando há correspondência, identifica o último padrão decisivo e sua posição iniciada em zero. O verificador reconhece comentários, caracteres de escape, regras ancoradas na raiz, regras de diretório, curingas, classes de caracteres, padrões recursivos com asterisco duplo e negação. Padrões malformados geram erro em vez de serem tratados silenciosamente como texto literal inofensivo.

Forneça as regras na ordem verdadeira

Um arquivo .gitignore não é apenas um conjunto de globs independentes. O Git avalia as regras em sequência, e uma regra posterior que corresponda ao caminho pode alterar a decisão de uma anterior. Envie os padrões exatamente na ordem em que aparecem no arquivo de exclusão relevante.

Padrões comuns que correspondem marcam o caminho como ignorado, enquanto uma regra iniciada por um ponto de exclamação sem escape desfaz essa decisão. Linhas vazias e linhas iniciadas por uma cerquilha sem escape não são consideradas regras, assim como ocorre em um arquivo de exclusão normal. A resposta contém o último padrão correspondente e seu índice iniciado em zero, o que ajuda a explicar um resultado inesperado em uma ferramenta de build ou em um editor de configuração.

Os caminhos precisam ser relativos à raiz do repositório e usar barras normais. Um caminho estável e normalizado evita respostas diferentes por causa de prefixos absolutos, segmentos de diretório pai ou separadores específicos do sistema operacional.

Entenda o comportamento de correspondência

Um asterisco corresponde a qualquer quantidade de caracteres dentro de um único segmento do caminho, e um ponto de interrogação corresponde a um caractere que não seja barra. Uma barra inicial ancora a regra na raiz do repositório. Um padrão sem barra pode corresponder a um nome em qualquer profundidade; quando esse nome representa um diretório no caminho informado, todo o conteúdo abaixo dele também é abrangido.

Uma barra final expressa uma regra de diretório. Como o verificador recebe um caminho, e não uma árvore do sistema de arquivos, ele decide com base no texto e em seus ancestrais; não consulta se o componente final existe como arquivo ou pasta. Cerquilhas e pontos de exclamação iniciais com escape continuam literais, e espaços finais sem escape são removidos segundo as convenções do formato.

Use a validação para encontrar defeitos

Erros de glob são fáceis de perder quando um arquivo de exclusão cresce por meio de muitas alterações pequenas. Este verificador relata entrada inválida para estruturas incorretas, como classe de caracteres aberta ou vazia, escape pendente e marcador de negação sem expressão. Uma resposta bem-sucedida não modifica as regras e não depende de rede, horário atual, aleatoriedade, conteúdo do repositório nem sistema operacional do host.

Por isso, a função serve para verificações determinísticas antes de commits, formulários web, diagnósticos de IDE e testes de políticas em CI.