개발자가 TOML 기반 xeq 태스크 러너를 자체 개발해 프로젝트별 반복 명령어를 단일 파일로 관리 가능하게 함

Context

모든 프로젝트마다 의존성 설정, 빌드, 검사 등 동일한 명령어를 반복 실행해야 하는 문제가 있었습니다. 기존 해결책들(Makefile, npm scripts, just)은 각각 특정 언어 또는 새로운 문법 학습을 강요했습니다.

Technical Solution

• TOML 설정 파일로 명명된 스크립트 정의: xeq.toml에서 [check], [build] 등의 섹션으로 실행할 명령어 목록 구성
• 변수와 폴백 값 지원: 필수 및 선택적 설정값을 TOML 변수로 처리
• 위치 기반 및 명명된 인자, 환경 변수 지원: 스크립트 실행 시 동적 값 전달 가능
• 중첩 스크립트 호출: xeq:check와 같이 다른 스크립트를 내부에서 참조
• 병렬 실행과 스레드 제어: 여러 명령어를 동시에 실행하되 스레드 수 조절 가능
• on_success / on_error 이벤트 훅: 스크립트 성공 또는 실패 시 특정 동작 자동 실행
• xeq validate 명령으로 사전 검증: 정의되지 않은 변수, 누락된 중첩 스크립트, 순환 의존성, 병렬 실행 충돌을 실행 전에 감지
• 30개 이상의 초기 템플릿 제공: rust, docker, nextjs 등 프로젝트 유형별 즉시 시작 가능
• Linux, macOS, Windows 크로스플랫폼 지원

Key Takeaway

프로젝트 오토메이션 도구는 기존 생태계와의 문법 일관성을 우선하고, 실행 전 검증 단계를 내장하면 개발자의 학습 곡선과 런타임 오류를 동시에 감소시킬 수 있습니다.