Tester vzorov glob
Vzory glob
Cesty
Výsledky
Ťahák syntaxe
- *
- Ľubovoľné znaky v rámci jedného segmentu cesty (nezodpovedá /)
- **
- Ľubovoľný počet segmentov cesty vrátane žiadneho
- ?
- Presne jeden znak (nie /)
- [abc]
- Jeden znak z množiny; [a-z] pre rozsah, [!abc] pre negáciu
- {a,b}
- Alternatívy, napr. *.{ts,tsx}, alebo rozsahy ako {1..3}
- !(x)
- Čokoľvek okrem uvedených alternatív, napr. !(*.test).ts
- +(x)
- Jedna alebo viac uvedených alternatív, napr. +(a|b)
- @(x)
- Presne jedna z uvedených alternatív, napr. @(js|ts)
Technické podrobnosti
Ako funguje tester vzorov glob
Čo tento nástroj robí
Tester vzorov glob kontroluje jeden alebo viac vzorov glob nad zoznamom ciest k súborom a každú cestu označí ako zhodnú alebo nezhodnú. Vzory sa vyhodnocujú v poradí, v štýle gitignore: vzor začínajúci znakom ! odstráni cesty z výsledku a neskoršie vzory prepisujú skoršie. Každý výsledok ukazuje, ktorý vzor urobil konečné rozhodnutie, a môžete si pozrieť regulárny výraz, ktorý picomatch skompiluje pre každý vzor. Všetko beží vo vašom prehliadači.
Bežné prípady použitia pre vývojárov
Vývojári používajú testery glob na ladenie zoznamov include a exclude v tsconfig.json, súboroch ignore pre ESLint a Prettier, vzoroch testov Jest a Vitest, filtroch ciest GitHub Actions, konfigurácii bundlerov a kľúčoch cache v CI. Hodí sa aj na kontrolu pravidiel .gitignore a .dockerignore pred commitom a na pochopenie, prečo nástroj na build určitý súbor zachytí alebo ticho preskočí.
Dátové formáty, typy alebo varianty
Predvolený režim používa picomatch, matcher, na ktorom stavia micromatch a mnohé nástroje na build, s podporou zástupných znakov * a **, ? pre jeden znak, tried znakov [abc], alternatív v zložených zátvorkách {a,b} a extglobov !(x), +(x) a @(x). Voliteľný režim .gitignore pridáva pravidlá gitignore: vzory bez lomky sa zhodujú v ľubovoľnej hĺbke, úvodná lomka ukotví k koreňu a koncová lomka zodpovedá iba adresárom. Súbory .gitignore v podadresároch a pravidlo, že súbor nemožno znova zahrnúť, ak je jeho nadradený adresár vylúčený, nie sú modelované.
Bežné úskalia a osvedčené postupy
Zástupné znaky sa nezhodujú so súbormi začínajúcimi bodkou, pokiaľ nie je zapnutá voľba dot alebo nie je bodka zapísaná výslovne, takže **/* preskočí .github a .env. * nikdy nepresahuje lomku, takže *.ts sa zhoduje iba so súbormi na najvyššej úrovni; pre ľubovoľnú hĺbku použite **/*.ts. Pri negácii záleží na poradí: vzor ! vylúči iba cesty zhodné s predchádzajúcim vzorom. Porovnávanie glob štandardne rozlišuje veľkosť písmen a rôzne nástroje (minimatch, micromatch, globbing v shelli, .gitignore) majú jemné rozdiely, preto výsledky potvrďte v nástroji, s ktorým skutočne nasadzujete.