go-filewatcher

Go용 고성능, 조합 가능한 파일 시스템 감시자(fsnotify 기반). 적절한 기본값, 자동 재귀 감시, 강력한 필터링, 우아한 미들웨어 체인을 통해 원시 fsnotify 사용 시의 보일러플레이트를 없앴습니다.

---

✨ 기능

• 🎯 제로 보일러플레이트 — 5줄 코드로 감시 시작
• 🌳 자동 재귀 — 새로 생성된 폴더를 포함한 하위 디렉터리 자동 감시
• ⏱️ 스마트 디바운싱 — 파일 변경이 빠른 경우를 처리하기 위한 전역 또는 경로별 디바운싱
• 🔍 강력한 필터링 — AND/OR/NOT 조합이 가능한 13개 내장 필터
• 🤖 자동 생성 코드 감지 — gogenfilter를 이용하여 sqlc, protobuf, templ 등의 파일 필터링
• 🔗 미들웨어 체인 — 로깅, 복구, 메트릭과 같은 공통 관심사 처리를 조합 가능한 미들웨어 방식으로
• 🎬 컨텍스트 인식 — Go의 context.Context를 이용한 우아한 종료 처리
• ⚡ 고성능 — 채널 기반 스트리밍, 최소 할당, 레이스 안전
• 📦 최소 의존성 — fsnotify만 필요 (그 외는 표준 라이브러리 사용)
• 🧪 철저한 검증 — 레이스 검출 포함 종합 테스트 스위트

---

📑 목차

• 설치
• 빠른 시작
• 구성 옵션
• 필터
• 미들웨어
• 디바운스 모드
• 이벤트 유형
• 오류 처리
• 고급 사용법
• 설계 원칙
• 예제
• 라이선스

---

설치

Go 1.26.1 이상 필요.

Nix로 개발

이 프로젝트는 재현 가능한 빌드 및 개발을 위해 Nix Flakes를 사용합니다:

---

🌐 본 텍스트는 빠른 이해를 돕기 위한 요약 번역본입니다. 정확한 기술 정보 및 전체 코드는 GitHub 원문에서 확인하실 수 있습니다.