Справочник по шаблонам сопоставления файлов

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Синтаксис шаблона

Шаблон — это строка или список строк с разделителями новой строки. Имена файлов и каталогов сравниваются с шаблонами для включения (или иногда исключения) в задачу. Сложное поведение можно создать, стекируя несколько шаблонов. Полный синтаксис см. в fnmatch.

Совпадение символов

Большинство символов используются в качестве точных совпадений. То, что считается "точным" совпадением, зависит от платформы: файловая система Windows не учитывает регистр, поэтому шаблон ABC будет соответствовать файлу под названием abc. В файловых системах с учетом регистра этот шаблон и имя не совпадают.

Следующие символы имеют особое поведение.

• * соответствует нулю или нескольким символам в имени файла или каталога. См. примеры .
• ? соответствует любому одному символу в имени файла или каталога. См. примеры .
• [] соответствует набору или диапазону символов в имени файла или каталога. См. примеры .
• ** рекурсивный подстановочный знак. Например, /hello/**/* совпадают со всеми потомками /hello.

Расширенное глоббирование

• ?(hello|world) — совпадения hello или world ноль или один раз
• *(hello|world) — ноль или больше вхождения
• +(hello|world) — одно или несколько вхождений
• @(hello|world) - ровно один раз
• !(hello|world) - не hello или world

Обратите внимание, что расширенные глобы не могут охватывать разделители каталогов. Например, +(hello/world|other) недопустимы.

Комментарии

Шаблоны, начинающиеся с #, рассматриваются как комментарии.

Исключение шаблонов

Ведущий ! изменяет значение шаблона включения, чтобы исключить. Вы можете включить шаблон, исключить подмножество, а затем повторно включить подмножество этого: это называется "чередующимся" шаблоном.

Несколько ! переворачивает значение. См. примеры .

Перед исключением необходимо определить шаблон включения. См. примеры .

Экранирование

Перенос специальных символов в [] можно использовать для экранирования символов литеральных глобов в имени файла. Например, имя литерального файла hello[a-z] можно экранировать как hello[[]a-z].

Разрез

/ используется в качестве разделителя путей в Linux и macOS. В большинстве случаев агенты Windows принимают /. Случаи, когда необходимо задокументировать разделитель Windows (\).

Примеры

Базовые примеры шаблонов

Примеры звездочки

пример 1: учитывая шаблон *Website.sln и файлы:

ConsoleHost.sln
ContosoWebsite.sln
FabrikamWebsite.sln
Website.sln

Шаблон будет совпадать:

ContosoWebsite.sln
FabrikamWebsite.sln
Website.sln

пример 2: учитывая *Website/*.proj шаблонов и пути:

ContosoWebsite/index.html
ContosoWebsite/ContosoWebsite.proj
FabrikamWebsite/index.html
FabrikamWebsite/FabrikamWebsite.proj

Шаблон будет совпадать:

ContosoWebsite/ContosoWebsite.proj
FabrikamWebsite/FabrikamWebsite.proj

Примеры вопросительного знака

пример 1: учитывая шаблон log?.log и файлы:

log1.log
log2.log
log3.log
script.sh

Шаблон будет совпадать:

log1.log
log2.log
log3.log

пример 2: учитывая шаблон image.??? и файлы:

image.tiff
image.png
image.ico

Шаблон будет совпадать:

image.png
image.ico

Примеры набора символов

пример 1: учитывая шаблон Sample[AC].dat и файлы:

SampleA.dat
SampleB.dat
SampleC.dat
SampleD.dat

Шаблон будет совпадать:

SampleA.dat
SampleC.dat

пример 2: учитывая шаблон Sample[A-C].dat и файлы:

SampleA.dat
SampleB.dat
SampleC.dat
SampleD.dat

Шаблон будет совпадать:

SampleA.dat
SampleB.dat
SampleC.dat

пример 3: учитывая Sample[A-CEG].dat шаблонов и файлов:

SampleA.dat
SampleB.dat
SampleC.dat
SampleD.dat
SampleE.dat
SampleF.dat
SampleG.dat
SampleH.dat

Шаблон будет совпадать:

SampleA.dat
SampleB.dat
SampleC.dat
SampleE.dat
SampleG.dat

Примеры рекурсивных подстановочных знаков

Учитывая шаблон **/*.ext и файлы:

sample1/A.ext
sample1/B.ext
sample2/C.ext
sample2/D.not

Шаблон будет совпадать:

sample1/A.ext
sample1/B.ext
sample2/C.ext

Примеры шаблонов исключения

Учитывая шаблон:

*
!*.xml

и файлы:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
Fabrikam.dll
Fabrikam.pdb
Fabrikam.xml

Шаблон будет совпадать:

ConsoleHost.exe
ConsoleHost.pdb
Fabrikam.dll
Fabrikam.pdb

Двойное исключение

Учитывая шаблон:

*
!*.xml
!!Fabrikam.xml

и файлы:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
Fabrikam.dll
Fabrikam.pdb
Fabrikam.xml

Шаблон будет совпадать:

ConsoleHost.exe
ConsoleHost.pdb
Fabrikam.dll
Fabrikam.pdb
Fabrikam.xml

Исключение папки

Учитывая шаблон:

**
!sample/**

и файлы:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml
sample/Fabrikam.dll
sample/Fabrikam.pdb
sample/Fabrikam.xml

Шаблон будет совпадать:

ConsoleHost.exe
ConsoleHost.pdb
ConsoleHost.xml