fixname-cli

macOS에서 유래된 자소 분해된 파일명을 수정해주는 간단하고 가벼운 CLI 도구입니다.

🚀 설치

npm을 이용해 fixname-cli를 전역으로 설치할 수 있습니다:

npm install -g fixname-cli

💡 사용법

fixname 명령어는 간단하고 직관적인 인터페이스를 제공합니다.

1. 자소 분해된 파일 찾기 (기본)

기본적으로 fixname 명령어는 현재 디렉터리를 스캔하여 자소 분해된 파일명만 목록으로 보여줍니다. 이때 파일명은 수정되지 않습니다.

fixname

2. 파일명 수정하기

-f 또는 --fix 옵션을 사용하면 발견된 파일명을 정규화된 (NFC) 형식으로 변경합니다.

fixname --fix

3. 하위 디렉터리 포함하기

하위 디렉터리까지 스캔하여 파일을 찾거나 수정하려면 -r 또는 --recurse 옵션을 사용하세요.

fixname -r --fix

4. 특정 디렉터리 지정하기

특정 경로를 지정하여 스캔할 수도 있습니다.

fixname "/path/to/your/folder" -r --fix

🌐 다국어 지원

fixname-cli는 사용자의 시스템 언어 설정을 감지하여 한글과 영어 메시지를 자동으로 출력합니다.

⚙️ 동작 원리

이 도구는 Node.js에 내장된 String.prototype.normalize('NFC') 메서드를 사용합니다. macOS에서 자주 사용되는 자소 분해 형식(NFD)의 파일명을 대부분의 다른 운영체제에서 표준으로 사용하는 완성형(NFC) 형식으로 변환합니다.

🤝 기여

이슈를 제출하거나 GitHub 저장소에 풀 리퀘스트를 보내주세요. 언제든지 환영합니다.

📄 라이선스

이 프로젝트는 MIT 라이선스를 따릅니다. 자세한 내용은 LICENSE 파일을 참조하세요.