Verifichi un percorso con pattern .gitignore

Verifichi un percorso relativo al repository rispetto a un elenco ordinato di pattern .gitignore, senza creare un repository temporaneo né eseguire Git. Il risultato indica se il percorso è ignorato e, quando una regola corrisponde, identifica l’ultimo pattern decisivo e la sua posizione con indice iniziale zero. Il controllo gestisce commenti, caratteri di escape, regole ancorate alla radice, regole per directory, caratteri jolly, classi di caratteri, doppi asterischi ricorsivi e negazioni. Inoltre rifiuta i pattern malformati, anziché interpretarli silenziosamente come innocui valori letterali.

Fornisca le regole nel loro ordine reale

Un file .gitignore non è un semplice insieme di glob indipendenti. Git valuta le regole in ordine e una regola successiva corrispondente può modificare la decisione presa da una precedente. Invii i pattern esattamente nell’ordine in cui compaiono nel file di esclusione pertinente.

I normali pattern corrispondenti contrassegnano il percorso come ignorato, mentre una regola che inizia con un punto esclamativo senza escape annulla tale decisione. Le righe vuote e quelle che iniziano con un cancelletto senza escape non vengono considerate regole, proprio come in un normale file di esclusione. La risposta include l’ultimo pattern corrispondente e il relativo indice dell’array a partire da zero, così è possibile spiegare un risultato inatteso in uno strumento di build o in un editor di configurazione.

I percorsi devono essere relativi alla radice del repository e usare barre normali. Un percorso stabile e normalizzato evita risultati differenti dovuti a un prefisso assoluto, a un segmento di directory superiore o a separatori specifici del sistema operativo.

Comprenda il comportamento della corrispondenza

Un singolo asterisco corrisponde a un numero qualsiasi di caratteri all’interno di un solo segmento del percorso, mentre un punto interrogativo corrisponde a un carattere diverso dalla barra. Una barra iniziale ancora la regola alla radice del repository. Un pattern privo di barre può corrispondere a un nome a qualsiasi profondità; se quel nome indica una directory nel percorso fornito, viene coperto anche tutto ciò che si trova al suo interno.

Una barra finale esprime una regola per directory. Poiché il controllo riceve un percorso anziché un albero del filesystem, decide in base al testo e ai suoi antenati; non verifica se il componente finale esista come file o directory. I cancelletti e i punti esclamativi iniziali con escape restano letterali, mentre gli spazi finali senza escape vengono rimossi secondo le convenzioni del formato.

Usi la convalida per trovare i difetti

Gli errori nei glob possono sfuggire facilmente quando un file di esclusione cresce attraverso molte piccole modifiche. Questo controllo segnala un input non valido per strutture errate come una classe di caratteri non chiusa o vuota, un escape incompleto o un segno di negazione privo di espressione. Una risposta corretta non modifica le regole e non dipende dalla rete, dall’ora corrente, da valori casuali, dal contenuto del repository o dal sistema operativo host.

È quindi adatta a controlli deterministici prima dei commit, moduli web, diagnostica degli IDE e test delle policy in CI.