Compruebe una ruta con patrones .gitignore

Compruebe una ruta relativa al repositorio con una lista ordenada de patrones .gitignore, sin crear un repositorio temporal ni ejecutar Git. El resultado indica si la ruta se ignora y, cuando coincide una regla, identifica el último patrón decisivo y su posición basada en cero. El comprobador admite comentarios, caracteres escapados, reglas ancladas a la raíz, reglas de directorio, comodines, clases de caracteres, patrones recursivos con doble asterisco y negaciones. Además, rechaza los patrones mal formados en lugar de interpretarlos silenciosamente como literales inofensivos.

Proporcione las reglas en su orden real

Un archivo .gitignore no es simplemente un conjunto de globs independientes. Git evalúa las reglas en orden, y una regla posterior que coincida puede cambiar la decisión de una anterior. Envíe los patrones exactamente en el orden en que aparecen en el archivo de exclusión correspondiente.

Los patrones coincidentes normales marcan la ruta como ignorada, mientras que una regla que comienza con un signo de exclamación sin escapar revoca esa decisión. Las líneas vacías y las que empiezan con una almohadilla sin escapar se tratan como líneas sin regla, igual que en un archivo de exclusión habitual. La respuesta incluye el último patrón coincidente y su índice de matriz basado en cero, lo que permite explicar resultados inesperados en una herramienta de compilación o un editor de configuración.

Las rutas deben ser relativas a la raíz del repositorio y utilizar barras diagonales. Una ruta estable y normalizada evita resultados distintos por un prefijo absoluto, un segmento de directorio superior o separadores propios del sistema operativo.

Conozca el comportamiento de coincidencia

Un asterisco coincide con cualquier cantidad de caracteres dentro de un único segmento de ruta, y un signo de interrogación coincide con un carácter que no sea una barra. Una barra inicial ancla la regla en la raíz del repositorio. Un patrón sin barras puede coincidir con un nombre a cualquier profundidad; si ese nombre representa un directorio en la ruta proporcionada, también queda cubierto todo su contenido.

Una barra final expresa una regla de directorio. Como el comprobador recibe una ruta y no un árbol de archivos, decide a partir del texto de la ruta y sus antecesores; no consulta si el componente final existe como archivo o directorio. Las almohadillas y exclamaciones iniciales escapadas siguen siendo literales, y los espacios finales sin escapar se descartan según las convenciones de estos archivos.

Use la validación para detectar defectos

Los errores de glob pueden pasar inadvertidos cuando un archivo de exclusión crece mediante muchas modificaciones pequeñas. Este comprobador devuelve una entrada no válida ante estructuras incorrectas, como una clase de caracteres sin cerrar o vacía, un escape colgante o un signo de negación sin expresión. Una respuesta correcta no modifica las reglas ni depende de un servicio de red, la hora actual, un valor aleatorio, el contenido del repositorio o el sistema operativo anfitrión.

Por ello resulta adecuada para comprobaciones deterministas antes de confirmar cambios, formularios web, diagnósticos de IDE y pruebas de políticas en CI.