Building CLIAR — A simple drop-in Java class for parsing command-line arguments (Part 1)

Context

Java 프로그램에서 커맨드라인 인자를 처리할 때 위치 기반 배열 접근(args[0], args[1])만으로는 선택적 인자, 재정렬 가능한 인자, 옵션 플래그 등을 관리하기 어렵다. 기존의 picocli, Apache Commons CLI 같은 성숙한 라이브러리들은 강력하지만 소규모 도구에는 과도한 의존성과 추상화를 도입하게 된다.

Technical Solution

• 커맨드라인 인자 타입을 세 가지로 구분: Options(의미 기반, 위치 독립적), Positional arguments(순서 기반 정의), Subcommands(액션으로 구조화)
• 원시 토큰 배열을 구조화된 입력으로 변환: 고정 위치 의존성 대신 의미 기반 파싱으로 처리
• 간단하고 투명한 드롭인 솔루션으로 설계: 추가 프레임워크 없이 프로젝트에 직접 통합 가능한 단일 Java 클래스

Key Takeaway

소규모 커맨드라인 도구 개발에서 범용 파싱 라이브러리 대신 프로젝트 맥락에 맞는 경량 커스텀 솔루션을 작성하면 의존성 관리와 코드 이해도를 동시에 개선할 수 있다.