Tester vzorů glob
Vzory glob
Cesty
Výsledky
Přehled syntaxe
- *
- Libovolné znaky v rámci jednoho segmentu cesty (neodpovídá /)
- **
- Libovolný počet segmentů cesty, včetně žádného
- ?
- Přesně jeden znak (ne /)
- [abc]
- Jeden znak z množiny; [a-z] pro rozsah, [!abc] pro negaci
- {a,b}
- Alternativy, např. *.{ts,tsx}, nebo rozsahy jako {1..3}
- !(x)
- Cokoli kromě uvedených alternativ, např. !(*.test).ts
- +(x)
- Jedna nebo více uvedených alternativ, např. +(a|b)
- @(x)
- Přesně jedna z uvedených alternativ, např. @(js|ts)
Technické detaily
Jak funguje tester vzorů glob
Co nástroj dělá
Tester vzorů glob porovná jeden nebo více vzorů glob se seznamem cest k souborům a každou cestu označí jako odpovídající nebo neodpovídající. Vzory se vyhodnocují postupně ve stylu gitignore: vzor začínající ! odebere cesty z výsledku a pozdější vzory přepisují dřívější. Každý výsledek ukazuje, který vzor rozhodl, a můžete si prohlédnout regulární výraz, který picomatch pro každý vzor zkompiluje. Vše běží ve vašem prohlížeči.
Typické případy použití pro vývojáře
Vývojáři používají testery glob k ladění seznamů include a exclude v tsconfig.json, souborů ignore pro ESLint a Prettier, testovacích vzorů Jest a Vitest, filtrů cest v GitHub Actions, konfigurace bundlerů a klíčů cache v CI. Hodí se také ke kontrole pravidel .gitignore a .dockerignore před commitem a k pochopení, proč build nástroj určitý soubor zahrne, nebo tiše přeskočí.
Datové formáty, typy nebo varianty
Výchozí režim používá picomatch, porovnávač za micromatch a mnoha build nástroji, s podporou zástupných znaků * a **, ? pro jediný znak, tříd znaků [abc], alternativ ve složených závorkách {a,b} a extglobů jako !(x), +(x) a @(x). Volitelný režim .gitignore přidává pravidla gitignore: vzory bez lomítka odpovídají v libovolné hloubce, úvodní lomítko ukotví vzor ke kořeni a koncové lomítko odpovídá jen adresářům. Soubory .gitignore v podadresářích a pravidlo, že soubor nelze znovu zahrnout, pokud je jeho nadřazený adresář vyloučen, nejsou modelovány.
Časté úskalí a osvědčené postupy
Zástupné znaky neodpovídají souborům začínajícím tečkou, pokud není zapnutá volba dot nebo tečka není napsána explicitně, takže **/* přeskočí .github a .env. * nikdy nepřekročí lomítko, takže *.ts odpovídá jen souborům nejvyšší úrovně; pro libovolnou hloubku použijte **/*.ts. U negace záleží na pořadí: vzor s ! vylučuje jen cesty, které odpovídaly dřívějšímu vzoru. Porovnávání glob ve výchozím stavu rozlišuje velikost písmen a různé nástroje (minimatch, micromatch, shell globbing, .gitignore) mají drobné rozdíly, takže výsledky potvrďte v nástroji, se kterým skutečně nasazujete.