CLI

tsumugi 패키지에는 설정용 CLI가 포함되어 있습니다.
별도로 설치할 필요는 없습니다.
패키지를 추가한 프로젝트에서 npx tsumugi를 실행합니다.
인수 없이 실행하면 대화 모드로 시작합니다.
파이프나 CI처럼 TTY가 아닌 환경에서는 대화 모드로 전환되지 않고, 사용 방법을 출력한 뒤 종료합니다.

npx tsumugi

tsumugi init

프로젝트에 Tsumugi를 설정합니다.

npx tsumugi init [--name <name>] [--format jsonc|toml]

init은 wrangler queues create <name>과 wrangler d1 create <name>으로 리소스를 생성합니다.
wrangler 설정 파일이 없으면 새로 생성하고, wrangler d1 create가 출력한 database_id를 기록합니다.
다음으로 src/index.ts, src/performers/, .dev.vars를 생성합니다.
마지막으로 wrangler d1 migrations apply(--local과 --remote)와 wrangler types를 실행합니다.

옵션

기존 파일의 처리

init은 기존 파일을 변경하지 않습니다.
wrangler 설정 파일(wrangler.json, wrangler.jsonc, wrangler.toml)이 이미 존재하는 경우에는 추가할 내용을 해당 파일의 형식으로 출력합니다.
src/index.ts 등의 템플릿 중 이미 존재하는 파일은 다시 생성하지 않습니다.

tsumugi add-performer

performer를 추가합니다.

npx tsumugi add-performer <NAME>

add-performer는 src/performers/<name>.ts에 performer 클래스를 생성합니다.
src/performers/index.ts에는 export 줄을 한 줄 추가합니다.
이름은 kebab-case, camelCase, PascalCase, SNAKE_CASE 중 어느 형식이든 받아들입니다.
클래스 이름은 PascalCase로, 파일 이름은 kebab-case로 변환합니다.
예를 들어 send-mail은 클래스 SendMail과 파일 send-mail.ts로 생성됩니다.

Service Binding 설정

다른 Worker에서 이 performer를 호출하는 경우에는 호출하는 쪽의 설정 파일에 services 값을 추가하세요.
add-performer는 추가해야 할 값을 출력합니다.
같은 Worker 안에서 performer를 실행하는 경우에는 추가할 필요가 없습니다.