Línea de comandos
Gestiona proyectos y despliegues desde la línea de comandos de IWE Code.
Usa el ejecutable de IWE Code para gestionar proyectos, configurar despliegues y transferir archivos. Los comandos del espacio de trabajo funcionan sin abrir ventanas. Las transferencias se conectan al servidor configurado en el perfil.
Comandos
Estos comandos se ejecutan desde el binario de la aplicación. Las carpetas, los archivos y los enlaces siguen abriendo el espacio de trabajo como antes.
iwe open [directory]- Inicia la aplicación. Con una carpeta, abre ese proyecto.
iwe workspace list [--json]- Muestra los espacios con sus proyectos.
iwe workspace add-project <directory> [--space NAME] [--json]- Añade una carpeta de proyecto a un espacio. Sin --space, la recibe el primer espacio.
iwe workspace remove-project <project> [--json]- Quita un proyecto por carpeta o por nombre exacto.
iwe --help, iwe --version- Muestra la ayuda localizada o la versión.
Comandos de despliegue
iwe deployment list- Enumera conexiones, claves SSH y perfiles.
iwe deployment connection add <name> --host HOST --username NAME [options]- Añade una conexión.
iwe deployment connection set <name> [options]- Actualiza una conexión.
iwe deployment connection remove <name>- Elimina una conexión sin uso y su secreto guardado.
iwe deployment key add <name> <path>- Registra un archivo de clave SSH.
iwe deployment key remove <name>- Elimina una clave SSH sin uso y su frase de contraseña guardada.
iwe deployment profile add <name> --project DIR --connection NAME --root PATH --mapping LOCAL=REMOTE [options]- Crea un perfil de despliegue con al menos una asignación de carpetas.
iwe deployment profile set <name> [options]- Actualiza un perfil.
iwe deployment profile remove <name> [--space NAME]- Elimina un perfil.
iwe deployment test <profile>- Comprueba la conexión de un perfil.
iwe deployment upload <profile> <path>- Sube un archivo o carpeta local.
iwe deployment download <profile> <remote> [--overwrite]- Descarga un archivo o carpeta remota. Usa --overwrite para reemplazar archivos locales.
iwe deployment list-remote <profile> [directory]- Enumera el contenido de un directorio remoto.
Opciones de despliegue
- Los comandos de despliegue admiten --json. Añade --help a un comando para ver sus opciones.
- Usa --space NAME con los comandos de perfil, test, upload, download o list-remote.
- Los comandos connection add y set también aceptan --protocol, --port, --auth, --key y --password-stdin. Introduce las contraseñas por la entrada estándar.
- Puedes repetir --mapping LOCAL=REMOTE y --exclude PATH. Usa --default false para quitar el estado predeterminado. En profile set, --clear-excluded borra las exclusiones.
- En la primera conexión SFTP, verifica la huella del servidor. Después repite el comando con --trust-host-key FINGERPRINT. Si el comando vuelve a indicar que la clave es desconocida, ejecútalo otra vez para usar la huella guardada.
Salida legible por programas
El indicador --json muestra JSON estable con sangría de dos espacios. Las claves usan snake_case, igual que el archivo guardado del espacio de trabajo.
{
"spaces": [
{
"name": "Work",
"projects": [
{
"name": "app",
"directory": "/Users/name/code/app",
"pinned": false
}
]
}
]
}Códigos de salida
Los scripts pueden distinguir el resultado por el código de salida.
0- El comando terminó correctamente.
1- El comando falló. Comprueba el archivo del espacio, el proyecto o perfil seleccionado y el resultado de la transferencia.
2- La llamada no fue válida: comando u opción desconocida, falta un valor u open recibió una carpeta inexistente.
Conviene saber
- Cierra la aplicación antes de cambiar el espacio de trabajo desde la línea de comandos. Ambos procesos guardan sin bloqueos.
- IWE_LANG o el idioma del sistema eligen el idioma de la salida, incluida la ayuda.
- Los comandos desconocidos ahora terminan con un error en lugar de abrir la ventana.