Add support for ** in the patterns
Some checks failed
Build / build-mac (push) Has been cancelled
Build / build-linux (push) Has been cancelled
Build / build-win (push) Has been cancelled
CodeQL / Analyze (push) Has been cancelled

This commit is contained in:
Andrea Mazzoleni 2026-01-10 16:57:04 +01:00
parent 36cef9ee89
commit 9f14dd94e5
55 changed files with 2274 additions and 1325 deletions

View file

@ -1276,30 +1276,56 @@ Configuration
:smartctl 2-parity -d areca,2/1 /dev/arcmsr0
Pattern
패턴은 처리에서 제외하거나 포함할 파일의 하위 집합을 선택하는 데
사용됩니다.
패턴은 포함하거나 제외할 파일을 필터링하는 유연한 방법을 제공합니다.
글로빙(globbing) 문자를 사용하면 모든 경로를 일일이 나열하지 않고도
특정 파일 이름이나 전체 디렉토리 구조와 일치하는 규칙을 정의할 수 있습니다.
물음표 `?`는 디렉토리 구분 기호를 제외한 모든 단일 문자와 일치합니다.
이는 패턴을 단일 디렉토리 수준으로 제한하면서 가변 문자가 포함된
파일 이름을 일치시키는 데 유용합니다.
단일 별표 `*`는 모든 문자 시퀀스와 일치하지만, 물음표와 마찬가지로
디렉토리 경계를 넘지 않습니다. 슬래시에서 멈추므로 단일 경로 구성 요소
내에서의 일치에 적합합니다. 이는 쉘 글로빙에서 익숙한 표준 와일드카드
동작입니다.
이중 별표 `**`는 더 강력하며 디렉토리 구분 기호를 포함한 모든 문자
시퀀스와 일치합니다. 이를 통해 패턴이 여러 디렉토리 수준에서 일치할 수
있습니다. `**`가 패턴 내에 직접 포함된 경우, 주변 리터럴 텍스트 사이의
슬래시를 포함하여 0개 이상의 문자와 일치할 수 있습니다.
`**`의 가장 중요한 용도는 특수 형식인 `/**/`입니다. 이는 0개 이상의
전체 디렉토리 수준과 일치하므로 정확한 경로 구조를 모르더라도
디렉토리 트리의 모든 깊이에서 파일과 일치시킬 수 있습니다.
예를 들어, `src/**/main.js` 패턴은 `src/main.js`(0개의 디렉토리 건너뜀),
`src/ui/main.js`(1개의 디렉토리 건너뜀), `src/ui/components/main.js`
(2개의 디렉토리 건너뜀)와 일치합니다.
대괄호 `[]`를 사용하는 문자 클래스는 지정된 세트 또는 범위에서
단일 문자와 일치합니다. 다른 단일 문자 패턴과 마찬가지로 디렉토리
구분 기호와는 일치하지 않습니다. 클래스는 범위 및 느낌표를 사용한
부정을 지원합니다.
기억해야 할 근본적인 차이점은 `*`, `?` 및 문자 클래스는 모두
디렉토리 경계를 준수하고 단일 경로 구성 요소 내에서만 일치하는 반면,
`**`는 디렉토리 구분 기호를 가로질러 일치할 수 있는 유일한 패턴이라는 것입니다.
네 가지 유형의 패턴이 있습니다:
=FILE
FILE이라는 이름의 모든 파일을 선택합니다. *, ?와 같은 글로빙
문자와 [a-z]와 같은 문자 클래스를 사용할 수 있습니다.
FILE이라는 이름의 모든 파일을 선택합니다.
이 패턴은 디렉토리가 아닌 파일에만 적용됩니다.
=DIR/
DIR이라는 이름의 모든 디렉토리와 그 안의 모든 것을 선택합니다.
*, ?와 같은 글로빙 문자를 사용할 수 있습니다.
이 패턴은 파일이 아닌 디렉토리에만 적용됩니다.
=/PATH/FILE
정확히 지정된 파일 경로를 선택합니다. *, ?와 같은 글로빙
문자를 사용할 수 있지만, 디렉토리 슬래시와는 절대 일치하지 않습니다.
이 패턴은 디렉토리가 아닌 파일에만 적용됩니다.
지정된 정확한 파일 경로를 선택합니다. 이 패턴은 디렉토리가 아닌
파일에만 적용됩니다.
=/PATH/DIR/
정확히 지정된 디렉토리 경로와 그 안의 모든 것을 선택합니다.
*, ?와 같은 글로빙 문자를 사용할 수 있지만, 디렉토리 슬래시와는
절대 일치하지 않습니다.
지정된 정확한 디렉토리 경로와 그 안의 모든 것을 선택합니다.
이 패턴은 파일이 아닌 디렉토리에만 적용됩니다.
/로 시작하는 절대 경로를 지정하면 로컬 파일 시스템의 루트 디렉토리가