API de sistema operativo

ptool.os expone utilidades para leer el entorno actual del runtime y consultar detalles básicos del proceso anfitrión.

ptool.os.getenv

ptool.os.getenv(name) devuelve el valor actual de una variable de entorno.

name (string, obligatorio): Nombre de la variable de entorno.
Devuelve: string|nil.

Comportamiento:

Devuelve nil cuando la variable no está definida.
Lee el entorno actual del runtime de ptool, incluidos los valores cambiados por ptool.os.setenv(...) y ptool.os.unsetenv(...).
Lanza un error cuando name está vacío o contiene caracteres inválidos como =.

ptool.os.env

ptool.os.env() devuelve una tabla instantánea del entorno actual del runtime.

Devuelve: table.

ptool.os.setenv

ptool.os.setenv(name, value) define una variable de entorno en el runtime actual de ptool.

name (string, obligatorio): Nombre de la variable.
value (string, obligatorio): Valor de la variable.

Comportamiento:

Esto actualiza el entorno del runtime actual de ptool, no el shell padre.
Los valores definidos aquí son visibles para ptool.os.getenv(...), ptool.os.env() y los procesos hijos lanzados después mediante ptool.run(...).

ptool.os.unsetenv

ptool.os.unsetenv(name) elimina una variable de entorno del runtime actual de ptool.

name (string, obligatorio): Nombre de la variable.

ptool.os.homedir

ptool.os.homedir() devuelve el directorio personal del usuario actual.

Devuelve: string|nil.

ptool.os.tmpdir

ptool.os.tmpdir() devuelve el directorio temporal del sistema.

Devuelve: string.

ptool.os.hostname

ptool.os.hostname() devuelve el nombre del host actual.

Devuelve: string|nil.

ptool.os.username

ptool.os.username() devuelve el nombre del usuario actual.

Devuelve: string|nil.

ptool.os.pid

ptool.os.pid() devuelve el PID del proceso actual de ptool.

Devuelve: integer.

ptool.os.exepath

ptool.os.exepath() devuelve la ruta resuelta del ejecutable ptool en ejecución.

Devuelve: string|nil.

ptool.os.getenv​

ptool.os.env​

ptool.os.setenv​

ptool.os.unsetenv​

ptool.os.homedir​

ptool.os.tmpdir​

ptool.os.hostname​

ptool.os.username​

ptool.os.pid​

ptool.os.exepath​