아임웹 마스터 CLI (imweb-master-cli)

NPM

https://www.npmjs.com/package/imweb-master-cli

아임웹 커스텀 개발을 위한 워크스페이스를 손쉽게 초기화하고 관리할 수 있는 CLI 도구입니다.

개발 환경

이 CLI 도구는 아임웹 커스텀 개발 환경에 최적화되어 있습니다.

주요 기능

• 프로젝트 초기화: init 명령어로 필요한 모든 템플릿 파일과 개발 규칙을 포함한 새로운 워크스페이스를 설정합니다.
• 개발 규칙 관리: push-rules와 pull-rules 명령어를 통해 여러 프로젝트 간의 개발 규칙(.imweb)을 일관성 있게 동기화합니다.
• 템플릿 동기화: push-template과 pull-template 명령어로 핵심 템플릿 파일(jsdoc.json, package.json, README.example.md)을 동기화하여 개발 환경의 일관성을 유지합니다.

설치

npm을 통해 이 도구를 전역으로 설치하여 어디서든 imweb-master 명령어를 사용할 수 있습니다.

기본 설치

npm install -g imweb-master-cli

NVM 등 여러 Node 버전을 사용하는 경우

npm install -g의 설치 위치는 활성화된 Node 버전에 따라 달라질 수 있습니다. 모든 Node 버전에서 동일한 CLI를 사용하려면 사용자 공용 경로에 설치하세요.

mkdir -p "$HOME/.local"
npm install -g --prefix "$HOME/.local" imweb-master-cli

Zsh 사용자는 ~/.zshrc에 다음 설정을 추가합니다. alias는 nvm use 실행 후 NVM의 전역 설치본이 우선되는 것을 방지합니다.

export PATH="$HOME/.local/bin:$PATH"
alias imweb-master="$HOME/.local/bin/imweb-master"

설정을 현재 터미널에 적용하고 설치 경로를 확인합니다.

source ~/.zshrc
type imweb-master

정상적으로 설정되면 imweb-master가 $HOME/.local/bin/imweb-master를 가리킵니다.

업데이트할 때도 같은 공용 경로를 지정합니다.

npm install -g --prefix "$HOME/.local" imweb-master-cli@latest

사용법

1. 새로운 워크스페이스 초기화

새로운 프로젝트를 시작할 디렉터리로 이동한 후, 다음 명령어를 실행하세요.

imweb-master init

이 명령어는 다음 작업을 자동으로 수행합니다.

1. 프로젝트 템플릿 파일 복사
2. .imweb 폴더 생성 및 개발 규칙 복사
3. package.json의 프로젝트 이름 설정
4. 필요한 npm 의존성 설치

2. 개발 규칙 동기화

현재 프로젝트의 규칙을 원본으로 푸시

# 일반 프로젝트 폴더 내에서 실행
imweb-master push-rules

# 다른 위치에서 특정 프로젝트를 대상으로 실행
imweb-master push-rules /path/to/project

원본 규칙을 현재 프로젝트로 가져오기

# 일반 프로젝트 폴더 내에서 실행
imweb-master pull-rules

# 다른 위치에서 특정 프로젝트를 대상으로 실행
imweb-master pull-rules /path/to/project

3. 템플릿 파일 동기화

현재 프로젝트의 템플릿을 원본으로 푸시

# 일반 프로젝트 폴더 내에서 실행
imweb-master push-template

# 다른 위치에서 특정 프로젝트를 대상으로 실행
imweb-master push-template /path/to/project

원본 템플릿을 현재 프로젝트로 가져오기

# 일반 프로젝트 폴더 내에서 실행
imweb-master pull-template

# 다른 위치에서 특정 프로젝트를 대상으로 실행
imweb-master pull-template /path/to/project

참고: push/pull 명령어는 개별 프로젝트 폴더 내에서 실행하여 원본과 동기화하는 것이 주된 목적입니다. imweb-master 루트에서 이 명령어들을 사용할 경우, 동기화할 대상 프로젝트의 경로를 반드시 지정해야 합니다.

라이선스

ISC