빠른 참조

Minimist CLI 인자 파서 치트시트

Node.js용 CLI 인자 파서 Minimist 빠른 참조 가이드: 플래그 타입, 별칭, 기본값, 전체 옵션 설정 및 파싱 결과 구조를 정리합니다.

· 게시일

minimist는 Node.js용 초경량 CLI 인자 파서 엔진입니다.

기본 사용법

const minimist = require('minimist');

const args = minimist(process.argv.slice(2), {
  string: ['lang'],         // Always parse --lang as a string
  boolean: ['verbose'],     // Always parse --verbose as a boolean
  alias: { v: 'verbose', l: 'lang' }
});

console.log(args);

전체 옵션 참조

const args = minimist(process.argv.slice(2), {
  string: ['lang'],           // Strings that preserve leading zeros
  boolean: ['pager', 'help'], // Treat flags as boolean switches
  alias: { h: 'help', p: 'pager' }, // Short-to-long alias mapping
  default: { lang: 'en', pager: true }, // Default values if omitted
  '--': true,                 // Store arguments after '--' in args['--']
  stopEarly: true,            // Stop parsing flags at the first non-option
  unknown: (arg) => {         // Callback triggered when an unrecognized flag is seen
    console.error(`Unknown flag: ${arg}`);
    return false;
  }
});

파싱 결과 구조

다음 명령을 실행할 때:

node cli.js --lang es --no-pager -v input.txt

생성되는 파싱 결과 객체:

{
  lang: 'es',
  pager: false,
  v: true,
  verbose: true,
  _: ['input.txt'] // Positional non-flag arguments
}

참고 자료

관련 주제