@jin7942/utils NPM

@jin7942/utils

파일 시스템 작업 및 로깅 기능을 지원하는 경량 유틸리티 모듈입니다.
CLI 도구, 배포 도구, 자동화 스크립트 등에 사용하기 좋도록 설계되었습니다.

설치

npm install @jin7942/utils

문서

DOCUMENT

제공 기능

파일 유틸 (fsHelper)

함수	설명
`ensureDirectoryExists(path)`	지정한 디렉토리가 없으면 재귀적으로 생성
`appendToFile(dir, file, content)`	파일에 로그 추가, 로그 용량 초과 시 자동 정리
`readFile(path)`	파일 내용을 UTF-8로 읽어 문자열 반환
`exists(path)`	해당 경로의 파일 존재 여부를 boolean으로 반환

로깅 유틸 (logger)

콘솔 출력 + 파일 저장 지원
로그 레벨 필터링 (info / warn / error)
ANSI 컬러 지원 (터미널 가독성 강화)

메서드	설명
`logger.info(msg)`	녹색 `[INFO]` 로그 출력
`logger.warn(msg)`	노란색 `[WARN]` 로그 출력
`logger.error(msg)`	빨간색 `[ERROR]` 로그 출력 (Error 객체도 지원)

로그 파일은 날짜 기준(YYYY-MM-DD.log)으로 저장됩니다.
기본 저장 경로는 'logs'이며, .env 또는 logConfig.ts로 설정 가능합니다.

예시

import { logger } from '@jin7942/utils';
import { appendToFile, ensureDirectoryExists } from '@jin7942/utils';

logger.info('작업 시작');
await ensureDirectoryExists('./data');
await appendToFile('./data', 'log.txt', '첫 번째 로그입니다');

⚙ 환경 변수 (.env 또는 process.env)

변수명	설명	기본값
`LOG_DIR`	로그 저장 디렉터리	`logs`
`LOG_MAX_SIZE`	최대 디렉터리 용량(byte)	`5242880`
`LOG_LEVEL`	출력 로그 레벨	`info`

라이선스

MIT

제작자

jin7942 GitHub
이 유틸은 RAY 자동배포 도구에서 파생되었습니다.

typescript utils logger file helper

1.0.0

9 months ago