Glob patterns

Glob (global의 약자)은 파일시스템 디렉토리에서 파일 이름에 대한 패턴 매칭을 수행하는 기능입니다. 이름 패턴을 해당 패턴과 일치하는 이름 목록으로 확장합니다. 원래는 파일시스템 이름 확장을 의미했지만, 현재는 모든 문자열에 대한 glob 스타일 패턴 매칭을 의미하기도 합니다.

Glob은 1970년대 초 Bell Labs에서 AT&T UNIX와 함께 개발되었으며, Unix 명령줄 유틸리티의 문법에 근본적인 영향을 미쳤습니다.

해당 개념이 필요한 이유

• 효율적인 파일 선택: 여러 파일을 하나하나 지정하지 않고 패턴으로 일괄 선택
• 유연한 매칭: 정규표현식보다 간단하면서도 강력한 파일 이름 매칭
• Shell 통합: Unix shell에서 기본 제공되어 명령줄에서 즉시 사용 가능
• 프로그래밍 언어 지원: 대부분의 언어에서 glob 패턴을 지원하여 파일 처리 간편화

AS-IS

파일을 하나하나 나열하거나 스크립트로 반복문을 작성해야 합니다.

# 모든 .js 파일을 처리하려면
cat file1.js
cat file2.js
cat file3.js
cat utils.js
cat helper.js
# ... 파일이 추가될 때마다 수동으로 업데이트 필요

TO-BE

Glob 패턴을 사용하면 간단하게 여러 파일을 선택할 수 있습니다.

# 모든 .js 파일을 한 번에
cat *.js
 
# src 디렉토리의 모든 .js 파일
cat src/**/*.js
 
# test로 시작하는 모든 파일
cat test*.js

기본 문법

1. * - 0개 이상의 문자 매치

가장 기본적이고 자주 사용되는 와일드카드입니다.

패턴	매치됨	매치 안됨
*.txt	file.txt, test.txt, README.txt	file.md, .txt
test*	test, test1, testing	mytest, atest
*test*	test, mytest, testing	tes, tst

주의: *는 경로 구분자(/)를 매치하지 않습니다.

src/*.js        # src/file.js (O), src/utils/file.js (X)

2. ** - 재귀적 디렉토리 매칭

0개 이상의 디렉토리 계층을 매치합니다.

패턴	매치됨	매치 안됨
**/*.js	file.js, src/file.js, src/utils/file.js	file.txt
src/**/*.test.js	src/file.test.js, src/utils/file.test.js	src/file.js

* vs ** 차이:

src/*.js        # src/file.js만 (1단계)
src/**/*.js     # src와 모든 하위 디렉토리의 .js 파일 (모든 단계)

3. [...] - 문자 집합/범위 매치

괄호 안의 문자 중 하나를 매치합니다.

패턴	매치됨	매치 안됨
[CB]at	Cat, Bat	cat, bat
file[0-9].txt	file0.txt, file9.txt	file10.txt, fileA.txt
[!0-9]*	test.txt, file.js	1test.txt, 9file.js

범위 표현:

[0-9]           # 숫자 하나
[a-z]           # 소문자 하나
[A-Z]           # 대문자 하나
[a-zA-Z]        # 알파벳 하나
[!0-9]          # 숫자가 아닌 것

실제 사용 예시

Claude Code - Project Rules

Claude Code의 .claude/rules/ 디렉토리에서 path-specific rules를 정의할 때 glob 패턴을 사용합니다.

---
paths:
  - "src/**/*.ts"          # src 아래 모든 TypeScript 파일
  - "lib/**/*.ts"          # lib 아래 모든 TypeScript 파일
  - "tests/**/*.test.ts"   # tests 아래 모든 테스트 파일
---
 
# TypeScript Rules
- Use strict type checking
- No implicit any

Brace expansion을 사용한 여러 확장자:

---
paths:
  - "src/**/*.{ts,tsx}"    # TypeScript와 TSX 파일
---
 
# TypeScript/React Rules

여러 디렉토리:

---
paths:
  - "{src,lib}/**/*.ts"    # src와 lib의 TypeScript 파일
---
 
# Shared TypeScript Rules

.gitignore 파일

Git의 .gitignore 파일도 glob 패턴을 사용합니다.

# 모든 .log 파일 무시
*.log
 
# node_modules 디렉토리 무시 (모든 위치)
**/node_modules/
 
# 루트의 build 디렉토리만 무시
/build/
 
# dist 디렉토리의 모든 것 제외하고 .gitkeep은 포함
dist/*
!dist/.gitkeep
 
# .env로 시작하는 모든 파일 무시
.env*
 
# 모든 .txt 파일 무시하되 README.txt는 포함
*.txt
!README.txt

참고 문서

• Wikipedia - Glob (programming)
• POSIX.2 Standard (IEEE Std 1003.2)