Show GN: mrg - macOS에서 자모 분리 현상을 해결하고 잡다한 메타데이터 파일들을 제거하는 툴

Context

macOS 파일 시스템 특유의 유니코드 NFD 방식 기반 자모 분리 현상 발생. .DS_Store 및 ._* 등 시스템 생성 메타데이터 파일로 인한 디렉토리 오염 문제 존재.

Technical Solution

• 유니코드 NFC 정규화 로직을 통한 한글 자모 분리 현상 해결 및 파일명 정규화 전략
• 파일 크기 및 대응 파일 존재 여부를 검증하여 ._* 메타데이터 파일을 안전하게 제거하는 필터링 구조
• .DS_Store 파일 타겟팅 삭제를 통한 OS 생성 정크 파일 정리 기능
• Python 표준 라이브러리만 사용하는 외부 의존성 없는 런타임 설계
• 사용자 가시성 확보를 위한 ANSI 컬러 터미널 출력 및 JSON 형식의 기계 읽기 가능 리포트 제공
• CLI 실행 외에 Python 모듈 형태의 API를 제공하여 커스터마이징 가능한 확장 설계

Key Takeaway

OS 간 파일 시스템의 유니코드 정규화 방식 차이(NFD vs NFC)를 이해하고 이를 자동화된 툴로 해결하는 엔지니어링 접근 방식.