API de sistema operacional

ptool.os expõe utilitários para ler o ambiente atual do runtime e consultar detalhes básicos do processo hospedeiro.

ptool.os.getenv

ptool.os.getenv(name) retorna o valor atual de uma variável de ambiente.

name (string, obrigatório): Nome da variável de ambiente.
Retorna: string|nil.

ptool.os.env

ptool.os.env() retorna uma tabela instantânea do ambiente atual do runtime.

Retorna: table.

ptool.os.setenv

ptool.os.setenv(name, value) define uma variável de ambiente no runtime atual do ptool.

name (string, obrigatório): Nome da variável.
value (string, obrigatório): Valor da variável.

Comportamento:

Isso atualiza o ambiente do runtime atual do ptool, não o shell pai.
Os valores definidos aqui ficam visíveis para ptool.os.getenv(...), ptool.os.env() e processos filhos iniciados depois com ptool.run(...).

ptool.os.unsetenv

ptool.os.unsetenv(name) remove uma variável de ambiente do runtime atual do ptool.

name (string, obrigatório): Nome da variável.

ptool.os.homedir

ptool.os.homedir() retorna o diretório pessoal do usuário atual.

Retorna: string|nil.

ptool.os.tmpdir

ptool.os.tmpdir() retorna o diretório temporário do sistema.

Retorna: string.

ptool.os.hostname

ptool.os.hostname() retorna o nome do host atual.

Retorna: string|nil.

ptool.os.username

ptool.os.username() retorna o nome do usuário atual.

Retorna: string|nil.

ptool.os.pid

ptool.os.pid() retorna o PID do processo atual do ptool.

Retorna: integer.

ptool.os.exepath

ptool.os.exepath() retorna o caminho resolvido do executável ptool em execução.

Retorna: 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​