프로젝트 소개

fs-extra는 Node.js의 기본 `fs` 모듈을 향상시켜 자주 필요한 파일 시스템 작업과 완전한 프로미스 지원을 추가하는 포괄적인 라이브러리입니다. 표준 `fs` 메서드를 모두 포함하면서 새로운 유틸리티를 추가한 드롭인 대체재로 설계되었습니다. 주요 기능으로는 재귀적 파일 복사(`copy`), 재귀적 삭제(`remove`), 파일/디렉토리 존재 확인(`ensureFile`, `ensureDir`), 디렉토리 재귀 생성(`mkdirs`, `mkdirp`)이 있습니다. 또한 상위 디렉토리를 자동 생성하며 파일을 쓰는 `outputFile`, 파일 이동(`move`), JSON 데이터 직접 처리(`readJson`, `writeJson`, `outputJson`) 유틸리티도 제공합니다. 모든 비동기 메서드는 프로미스를 반환하고 콜백을 지원하며, 동기 변형(예: `copySync`)은 차단 작업에 사용할 수 있습니다. 대규모 파일 작업을 안전하게 처리하기 위해 fs-extra는 `graceful-fs`를 사용해 `EMFILE` 오류를 방지합니다. 이 라이브러리는 CommonJS와 ES 모듈 가져오기를 모두 지원합니다. 프로젝트에는 광범위한 테스트가 포함되어 있고 표준 자바스크립트 스타일을 따르며, CLI 인터페이스와 TypeScript 정의 같은 다양한 서드파티 도구 생태계를 갖추고 있습니다.