Referencia CLI

Interfaz de línea de comandos para el runtime de Wippy.

Flags Globales

Disponibles en todos los comandos:

Flag	Corto	Descripción
`--config`		Archivo de configuración (por defecto: .wippy.yaml)
`--verbose`	`-v`	Habilitar logging de debug
`--very-verbose`		Debug con stack traces
`--console`	`-c`	Logging de consola colorido
`--silent`	`-s`	Deshabilitar logging de consola
`--event-streams`	`-e`	Transmitir logs al bus de eventos
`--profiler`	`-p`	Habilitar pprof en localhost:6060
`--memory-limit`	`-m`	Límite de memoria (ej., 1G, 512M)

Prioridad de límite de memoria: flag --memory-limit > env GOMEMLIMIT > 1GB por defecto.

wippy init

Crear un nuevo archivo lock.

wippy init
wippy init --src-dir ./src --modules-dir .wippy

Flag	Corto	Por Defecto	Descripción
`--src-dir`	`-d`	./src	Directorio fuente
`--modules-dir`		.wippy	Directorio de módulos
`--lock-file`	`-l`	wippy.lock	Ruta del archivo lock

wippy run

Iniciar el runtime o ejecutar un comando.

wippy run                                    # Iniciar runtime
wippy run list                               # Listar comandos disponibles
wippy run test                               # Ejecutar pruebas
wippy run snapshot.wapp                      # Ejecutar desde archivo pack
wippy run acme/http                          # Ejecutar módulo
wippy run --exec app:processes/app:worker   # Ejecutar proceso único

Flag	Corto	Descripción
`--override`	`-o`	Sobrescribir valores de entrada (namespace:entry:field=value)
`--exec`	`-x`	Ejecutar proceso y salir (host/namespace:entry)
`--host`		Host para ejecución
`--registry`		URL del registro

wippy lint

Verificar código Lua en busca de errores de tipo y advertencias.

wippy lint
wippy lint --level warning

Valida todas las entradas Lua: function.lua.*, library.lua.*, process.lua.*, workflow.lua.*.

Flag	Descripción
`--level`	Nivel mínimo de severidad a reportar

wippy add

Agregar una dependencia de módulo.

wippy add acme/http
wippy add acme/http@1.2.3
wippy add acme/http@latest

Flag	Corto	Por Defecto	Descripción
`--lock-file`	`-l`	wippy.lock	Ruta del archivo lock
`--registry`			URL del registro

wippy install

Instalar dependencias desde archivo lock.

wippy install
wippy install --force
wippy install --repair

Flag	Corto	Descripción
`--lock-file`	`-l`	Ruta del archivo lock
`--force`		Ignorar caché, siempre descargar
`--repair`		Verificar hashes, redescargar si no coinciden
`--registry`		URL del registro

wippy update

Actualizar dependencias y regenerar archivo lock.

wippy update                      # Actualizar todo
wippy update acme/http            # Actualizar módulo específico
wippy update acme/http demo/sql   # Actualizar múltiples

Flag	Corto	Por Defecto	Descripción
`--lock-file`	`-l`	wippy.lock	Ruta del archivo lock
`--src-dir`	`-d`	.	Directorio fuente
`--modules-dir`		.wippy	Directorio de módulos
`--registry`			URL del registro

wippy pack

Crear un pack de snapshot (archivo .wapp).

wippy pack snapshot.wapp
wippy pack release.wapp --description "Release 1.0"
wippy pack app.wapp --embed app:assets --bytecode **

Flag	Corto	Descripción
`--lock-file`	`-l`	Ruta del archivo lock
`--description`	`-d`	Descripción del pack
`--tags`	`-t`	Tags del pack (separados por coma)
`--meta`		Metadatos personalizados (key=value)
`--embed`		Embeber entradas fs.directory (patrones)
`--list`		Listar entradas fs.directory (dry-run)
`--exclude-ns`		Excluir namespaces (patrones)
`--exclude`		Excluir entradas (patrones)
`--bytecode`		Compilar Lua a bytecode (** para todo)

wippy publish

Publicar módulo al hub.

wippy publish
wippy publish --version 1.0.0
wippy publish --dry-run

Lee desde wippy.yaml en el directorio actual.

Flag	Descripción
`--version`	Versión a publicar
`--dry-run`	Validar sin publicar
`--label`	Etiqueta de versión
`--release-notes`	Notas de release
`--registry`	URL del registro

wippy search

Buscar módulos en el hub.

wippy search http
wippy search "sql driver" --limit 20
wippy search auth --json

Flag	Descripción
`--json`	Salida como JSON
`--limit`	Máximo de resultados
`--registry`	URL del registro

wippy auth

Gestionar autenticación del registro.

wippy auth login
wippy auth login --token YOUR_TOKEN

Flag	Descripción
`--token`	Token de API
`--registry`	URL del registro
`--local`	Almacenar credenciales localmente

wippy auth logout

wippy auth logout

Flag	Descripción
`--registry`	URL del registro
`--local`	Eliminar credenciales locales

wippy auth status

wippy auth status
wippy auth status --json

wippy registry

Consultar e inspeccionar entradas del registro.

wippy registry list

wippy registry list
wippy registry list --kind function.lua
wippy registry list --ns app --json

Flag	Corto	Descripción
`--kind`	`-k`	Filtrar por kind
`--ns`	`-n`	Filtrar por namespace
`--name`		Filtrar por nombre
`--meta`		Filtrar por metadatos
`--json`		Salida como JSON
`--yaml`		Salida como YAML
`--lock-file`	`-l`	Ruta del archivo lock

wippy registry show

wippy registry show app:http:handler
wippy registry show app:config --yaml

Flag	Corto	Descripción
`--field`	`-f`	Mostrar campo específico
`--json`		Salida como JSON
`--yaml`		Salida como YAML
`--raw`		Salida sin formato
`--lock-file`	`-l`	Ruta del archivo lock

wippy version

Mostrar información de versión.

wippy version
wippy version --short

Ejemplos

Flujo de Trabajo de Desarrollo

# Inicializar proyecto
wippy init
wippy add wippy/http wippy/sql
wippy install

# Verificar errores
wippy lint

# Ejecutar con salida de debug
wippy run -c -v

# Sobrescribir config para desarrollo local
wippy run -o app:db:host=localhost -o app:db:port=5432

Despliegue en Producción

# Crear pack de release con bytecode
wippy pack release.wapp --bytecode ** --exclude-ns test.**

# Ejecutar desde pack con límite de memoria
wippy run release.wapp -m 2G

Depuración

# Ejecutar proceso único
wippy run --exec app:processes/app:worker

# Con profiler habilitado
wippy run -p -v
# Luego: go tool pprof http://localhost:6060/debug/pprof/heap

Gestión de Dependencias

# Agregar nueva dependencia
wippy add acme/http@latest

# Reparar módulos corruptos
wippy install --repair

# Forzar redescarga
wippy install --force

# Actualizar módulo específico
wippy update acme/http

Publicación

# Login al hub
wippy auth login

# Validar módulo
wippy publish --dry-run

# Publicar
wippy publish --version 1.0.0 --release-notes "Release inicial"

Archivo de Configuración

Cree .wippy.yaml para configuraciones persistentes:

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"

Ver También

Configuración - Referencia del archivo de configuración
Observabilidad - Monitoreo y logging