Skip to content

tyrus:os ​

tyrus:os expone información multiplataforma sobre el sistema operativo en el que se ejecuta el binario compilado: plataforma, arquitectura, hostname, versión del kernel, locale, la constante de fin de línea, el usuario activo y directorios estándar. Es de solo lectura y puramente informativo, la información a nivel de proceso (pid, cwd(), memoryUsage(), etc.) vive en el global integrado process, documentado en Variables de Entorno.

Imports ​

tyrus
import { EOL, arch, hostname, language, locale, platform, release, systemName } from "tyrus:os";
import { OsArch, OsPlatform } from "tyrus:os";

Identificación del Sistema ​

ExportFirmaPropósito
platform() => OsPlatformLa plataforma objetivo.
arch() => OsArchLa arquitectura de CPU objetivo.
EOLstringLa constante nativa de fin de línea.
hostname() => stringEl hostname de red de la máquina.
release() => stringLa versión de release/build del kernel.
systemName() => stringEl nombre del sistema al estilo POSIX (uname -s).
locale() => stringEl código de locale actual.
language() => stringEl subtag de idioma del locale actual.

Usuario y Directorios ​

ExportFirmaPropósito
userInfo() => UserInfoLogin, directorio home y shell en una sola llamada.
userName() => stringEl nombre de login.
whoami() => string?El nombre real (GECOS), no el login.
homeDir() => stringEl directorio home del usuario.
cacheDir() => stringEl directorio de caché del usuario.
configDir() => stringEl directorio de configuración del usuario.
dataDir() => stringEl directorio de datos del usuario.
tempDir() => stringEl directorio temporal del sistema.
desktopDir() => string?El directorio de escritorio, si existe.
documentsDir() => string?El directorio de documentos, si existe.
appDataDir(app: string) => stringUn subdirectorio específico de aplicación dentro de dataDir.

Hardware y Rendimiento ​

ExportFirmaPropósito
cpus() => CpuInfo[]Una entrada por núcleo lógico de CPU.
totalMem() => u64Memoria total del sistema, en bytes.
freeMem() => u64Memoria libre del sistema, en bytes.
uptime() => u64Segundos desde la última vez que arrancó el sistema.
loadAvg() => f64[]Los promedios de carga de 1/5/15 minutos.
battery() => BatteryInfo?Información de la primera batería, si existe.
cpuTemp(unit: string) => f32?La mayor temperatura de sensor reportada.

Pantalla y Sesión ​

ExportFirmaPropósito
isDarkMode() => booleanSi el escritorio está en modo oscuro.
terminalSize() => [u16, u16]?Las columnas y filas del terminal.
isScreenLocked() => booleanSi el salvapantallas/pantalla de bloqueo está activo.
isSessionLocked() => booleanSi la sesión del usuario actual está bloqueada.
preventSleep() => Result<void, OsError>Inhibe la suspensión automática del sistema/pantalla.
allowSleep() => Result<void, OsError>Revierte preventSleep.

isScreenLocked/isSessionLocked son de mejor esfuerzo y, por ahora, solo Linux, false en otras plataformas, o cuando el servicio subyacente no se puede alcanzar.

Fuentes y Accesibilidad ​

ExportFirmaPropósito
systemFonts() => FontInfo[]Una entrada por cada face de fuente instalada en el sistema.
accessibleColorContrast(fg: Color, bg: Color) => booleanSi un par de colores cumple la proporción de contraste AA de WCAG.

Utilidades ​

ExportFirmaPropósito
hasCapability(cap: SystemCapability) => booleanSi una capacidad dada está disponible en este sistema.

Consulta Interfaces y Enums para la forma de OsPlatform, OsArch, SystemCapability, UserInfo, CpuInfo, BatteryInfo, FontInfo, y Color.

Los valores no resueltos nunca abortan el programa

hostname(), release(), systemName(), userName(), y cada función de directorio recurren a "unknown" o una cadena vacía si el sistema operativo no reporta un valor. locale() y language() recurren a "und", el subtag estándar de "locale indeterminado". whoami(), desktopDir(), documentsDir(), battery(), y cpuTemp() devuelven un tipo opcional porque la ausencia es un resultado normal (un sistema headless, una cuenta sin nombre real configurado, un escritorio sin batería, un contenedor sin sensor térmico), ninguna de estas funciones puede fallar el programa como lo haría un error de filesystem. La única excepción es el argumento unit de cpuTemp: "celsius"/"fahrenheit" son los únicos valores válidos, y cualquier otro aborta el programa.

Ejemplo ​

tyrus
import { EOL, arch, hostname, language, locale, platform, release, systemName } from "tyrus:os";
import { OsArch, OsPlatform } from "tyrus:os";

const currentPlatform: OsPlatform = platform();
const currentArch: OsArch = arch();

print(`${systemName()} ${release()} (${hostname()})${EOL}locale ${locale()} (${language()})`);
// "Linux 6.8.0-generic (my-machine)"
// "locale en-US (en)"

if (currentPlatform === OsPlatform.Windows) {
    print("running on Windows");
}