CLI 레퍼런스
Wippy 런타임의 커맨드라인 인터페이스입니다.
전역 플래그
모든 명령어에서 사용할 수 있습니다:
| 플래그 | 약어 | 설명 |
|---|---|---|
--config |
설정 파일 (기본값: .wippy.yaml) | |
--verbose |
-v |
디버그 로깅 활성화 |
--very-verbose |
스택 트레이스를 포함한 디버그 | |
--console |
-c |
컬러 콘솔 로깅 |
--silent |
-s |
콘솔 로깅 비활성화 |
--event-streams |
-e |
이벤트 버스로 로그 스트리밍 |
--profiler |
-p |
localhost:6060에서 pprof 활성화 |
--memory-limit |
-m |
메모리 제한 (예: 1G, 512M) |
메모리 제한 우선순위: --memory-limit 플래그 > GOMEMLIMIT 환경 변수 > 1GB 기본값.
wippy init
새 lock 파일을 생성합니다.
wippy init
wippy init --src-dir ./src --modules-dir .wippy
| 플래그 | 약어 | 기본값 | 설명 |
|---|---|---|---|
--src-dir |
-d |
./src | 소스 디렉토리 |
--modules-dir |
.wippy | 모듈 디렉토리 | |
--lock-file |
-l |
wippy.lock | Lock 파일 경로 |
wippy run
런타임을 시작하거나 명령어를 실행합니다.
wippy run # 런타임 시작
wippy run list # 사용 가능한 명령어 목록
wippy run test # 테스트 실행
wippy run snapshot.wapp # 팩 파일에서 실행
wippy run acme/http # 모듈 실행
wippy run --exec app:processes/app:worker # 단일 프로세스 실행
| 플래그 | 약어 | 설명 |
|---|---|---|
--override |
-o |
엔트리 값 오버라이드 (namespace:entry:field=value) |
--exec |
-x |
프로세스를 실행하고 종료 (host/namespace:entry) |
--host |
실행 호스트 | |
--registry |
레지스트리 URL |
wippy lint
Lua 코드의 타입 오류 및 경고를 검사합니다.
wippy lint
wippy lint --level warning
모든 Lua 엔트리를 검증합니다: function.lua.*, library.lua.*, process.lua.*, workflow.lua.*.
| 플래그 | 설명 |
|---|---|
--level |
보고할 최소 심각도 수준 |
wippy add
모듈 의존성을 추가합니다.
wippy add acme/http
wippy add acme/http@1.2.3
wippy add acme/http@latest
| 플래그 | 약어 | 기본값 | 설명 |
|---|---|---|---|
--lock-file |
-l |
wippy.lock | Lock 파일 경로 |
--registry |
레지스트리 URL |
wippy install
Lock 파일에서 의존성을 설치합니다.
wippy install
wippy install --force
| 플래그 | 약어 | 설명 |
|---|---|---|
--lock-file |
-l |
Lock 파일 경로 |
--force |
캐시를 무시하고 항상 다운로드 | |
--registry |
레지스트리 URL |
wippy update
의존성을 업데이트하고 lock 파일을 재생성합니다.
wippy update # 전체 업데이트
wippy update acme/http # 특정 모듈 업데이트
wippy update acme/http demo/sql # 여러 모듈 업데이트
| 플래그 | 약어 | 기본값 | 설명 |
|---|---|---|---|
--lock-file |
-l |
wippy.lock | Lock 파일 경로 |
--src-dir |
-d |
. | 소스 디렉토리 |
--modules-dir |
.wippy | 모듈 디렉토리 | |
--registry |
레지스트리 URL |
wippy pack
스냅샷 팩(.wapp 파일)을 생성합니다.
wippy pack snapshot.wapp
wippy pack release.wapp --description "Release 1.0"
wippy pack app.wapp --embed app:assets --bytecode **
| 플래그 | 약어 | 설명 |
|---|---|---|
--lock-file |
-l |
Lock 파일 경로 |
--description |
-d |
팩 설명 |
--tags |
-t |
팩 태그 (쉼표로 구분) |
--meta |
커스텀 메타데이터 (key=value) | |
--embed |
fs.directory 엔트리 임베드 (패턴) | |
--list |
fs.directory 엔트리 목록 (dry-run) | |
--exclude-ns |
네임스페이스 제외 (패턴) | |
--exclude |
엔트리 제외 (패턴) | |
--bytecode |
Lua를 바이트코드로 컴파일 (** 으로 전체 대상) |
wippy publish
모듈을 허브에 퍼블리시합니다.
wippy publish
wippy publish --version 1.0.0
wippy publish --dry-run
현재 디렉토리의 wippy.yaml을 읽습니다.
| 플래그 | 설명 |
|---|---|
--version |
퍼블리시할 버전 |
--dry-run |
퍼블리시 없이 검증만 수행 |
--label |
버전 대신 변경 가능한 레이블로 퍼블리시 |
--release-notes |
릴리스 노트 |
--protected |
버전을 보호됨으로 표시 |
--embed |
id 또는 name으로 fs.directory 엔트리 임베드 |
--config |
wippy.yaml이 있는 디렉토리 경로 (기본값: .) |
--registry |
레지스트리 URL |
wippy search
허브에서 모듈을 검색합니다.
wippy search http
wippy search "sql driver" --limit 20
wippy search auth --json
| 플래그 | 설명 |
|---|---|
--json |
JSON으로 출력 |
--limit |
최대 결과 수 |
--registry |
레지스트리 URL |
wippy auth
레지스트리 인증을 관리합니다.
wippy auth login
wippy auth login
wippy auth login --token YOUR_TOKEN
| 플래그 | 설명 |
|---|---|
--token |
API 토큰 |
--registry |
레지스트리 URL |
--local |
자격 증명을 로컬에 저장 |
wippy auth logout
wippy auth logout
| 플래그 | 설명 |
|---|---|
--registry |
레지스트리 URL |
--local |
로컬 자격 증명 제거 |
wippy auth status
wippy auth status
wippy auth status --json
wippy registry
레지스트리 엔트리를 조회하고 검사합니다.
wippy registry list
wippy registry list
wippy registry list --kind function.lua
wippy registry list --ns app --json
| 플래그 | 약어 | 설명 |
|---|---|---|
--kind |
-k |
종류별 필터 |
--ns |
-n |
네임스페이스별 필터 |
--name |
이름별 필터 | |
--meta |
메타데이터별 필터 | |
--json |
JSON으로 출력 | |
--yaml |
YAML로 출력 | |
--lock-file |
-l |
Lock 파일 경로 |
wippy registry show
wippy registry show app:http:handler
wippy registry show app:config --yaml
| 플래그 | 약어 | 설명 |
|---|---|---|
--field |
-f |
특정 필드 표시 |
--json |
JSON으로 출력 | |
--yaml |
YAML로 출력 | |
--raw |
원시 출력 | |
--lock-file |
-l |
Lock 파일 경로 |
wippy version
버전 정보를 출력합니다.
wippy version
wippy version --short
커스텀 명령어
모든 process.lua 또는 process.wasm 엔트리는 command 메타데이터를 추가하여 이름이 있는 명령어로 등록할 수 있습니다:
entries:
- name: test_runner
kind: process.lua
meta:
command:
name: test
short: Run application tests
source: file://runner.lua
method: main
modules:
- io
- registry
- funcs
다음과 같이 실행합니다:
wippy run test
사용 가능한 모든 명령어를 나열합니다:
wippy run list
명령어 메타데이터 필드
| 필드 | 필수 | 설명 |
|---|---|---|
name |
예 | wippy run <name>으로 사용하는 명령어 이름 |
short |
아니오 | wippy run list에 표시되는 간단한 설명 |
모든 프로세스 엔트리 종류(process.lua, process.wasm)를 사용할 수 있습니다. 명령어 이름은 로드된 모든 엔트리에서 고유해야 합니다. 명령어 이름 뒤의 인수는 프로세스에 전달됩니다.
예제
개발 워크플로우
# 프로젝트 초기화
wippy init
wippy add wippy/http wippy/sql
wippy install
# 오류 검사
wippy lint
# 디버그 출력과 함께 실행
wippy run -c -v
# 로컬 개발을 위한 설정 오버라이드
wippy run -o app:db:host=localhost -o app:db:port=5432
프로덕션 배포
# 바이트코드로 릴리스 팩 생성
wippy pack release.wapp --bytecode ** --exclude-ns test.**
# 메모리 제한과 함께 팩에서 실행
wippy run release.wapp -m 2G
디버깅
# 단일 프로세스 실행
wippy run --exec app:processes/app:worker
# 프로파일러 활성화와 함께
wippy run -p -v
# 이후: go tool pprof http://localhost:6060/debug/pprof/heap
의존성 관리
# 새 의존성 추가
wippy add acme/http@latest
# 강제 재다운로드
wippy install --force
# 특정 모듈 업데이트
wippy update acme/http
퍼블리싱
# 허브에 로그인
wippy auth login
# 모듈 검증
wippy publish --dry-run
# 퍼블리시
wippy publish --version 1.0.0 --release-notes "Initial release"
설정 파일
영구적인 설정을 위해 .wippy.yaml을 생성합니다:
logger:
mode: development
level: debug
encoding: console
logmanager:
min_level: -1 # debug
profiler:
enabled: true
address: localhost:6060
override:
app:gateway:addr: ":9090"
app:db:host: "localhost"