Procesos
El módulo tyrus:process inicia programas externos sin shell. Cada proceso hijo expone streams limitados e independientes para la entrada, la salida y el error estándar.
Importación
import { ChildProcess, ProcessError, exec } from "tyrus:process";exec(command, args?) pasa el ejecutable y cada argumento directamente al sistema operativo. No interpreta comillas de shell, pipes, redirecciones ni otra sintaxis de shell.
Referencia de la API
| Nombre | Tipo | Descripción |
|---|---|---|
exec | Función | Inicia un proceso hijo y devuelve Result<ChildProcess, ProcessError>. |
ChildProcess | Interfaz | Proporciona el ID del proceso, los streams estándar y los métodos wait() y kill(). |
wait() | Método | Espera a que termine el proceso hijo y devuelve su código de salida. |
kill() | Método | Solicita la terminación de un proceso hijo en ejecución. |
ProcessError | Interfaz | Describe fallos recuperables de exec, wait() y kill(). |
| Proceso actual | API ambiente | Documenta process.argv, la información del proceso y process.exit(). |
Streams del Proceso Hijo
stdin es un WritableStream<u8[]>; ciérralo con await child.stdin.close() para enviar EOF. stdout y stderr son valores independientes de ReadableStream<u8[]>. Los métodos de estos streams están documentados en el módulo tyrus:stream.
Cada stream del proceso usa un buffer limitado de 256 KiB y produce chunks de como máximo 64 KiB. Un consumidor lento pausa la lectura de ese descriptor en vez de acumular la salida en memoria. stdout y stderr preservan todos los bytes, incluidos los bytes cero.
Liberar el último handle de ChildProcess termina y recolecta un hijo que sigue en ejecución. Un código de salida distinto de cero y los bytes escritos en stderr son resultados normales del proceso, no valores ProcessError.
Disponibilidad en el playground
tyrus:process requiere acceso a procesos del sistema operativo y no está disponible en compilaciones sandboxed.
