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
import { EOL, arch, hostname, language, locale, platform, release, systemName } from "tyrus:os";
import { OsArch, OsPlatform } from "tyrus:os";Identificación del Sistema
| Export | Firma | Propósito |
|---|---|---|
platform | () => OsPlatform | La plataforma objetivo. |
arch | () => OsArch | La arquitectura de CPU objetivo. |
EOL | string | La constante nativa de fin de línea. |
hostname | () => string | El hostname de red de la máquina. |
release | () => string | La versión de release/build del kernel. |
systemName | () => string | El nombre del sistema al estilo POSIX (uname -s). |
locale | () => string | El código de locale actual. |
language | () => string | El subtag de idioma del locale actual. |
Usuario y Directorios
| Export | Firma | Propósito |
|---|---|---|
userInfo | () => UserInfo | Login, directorio home y shell en una sola llamada. |
userName | () => string | El nombre de login. |
whoami | () => string? | El nombre real (GECOS), no el login. |
homeDir | () => string | El directorio home del usuario. |
cacheDir | () => string | El directorio de caché del usuario. |
configDir | () => string | El directorio de configuración del usuario. |
dataDir | () => string | El directorio de datos del usuario. |
tempDir | () => string | El directorio temporal del sistema. |
desktopDir | () => string? | El directorio de escritorio, si existe. |
documentsDir | () => string? | El directorio de documentos, si existe. |
appDataDir | (app: string) => string | Un subdirectorio específico de aplicación dentro de dataDir. |
Hardware y Rendimiento
| Export | Firma | Propósito |
|---|---|---|
cpus | () => CpuInfo[] | Una entrada por núcleo lógico de CPU. |
totalMem | () => u64 | Memoria total del sistema, en bytes. |
freeMem | () => u64 | Memoria libre del sistema, en bytes. |
uptime | () => u64 | Segundos 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
| Export | Firma | Propósito |
|---|---|---|
isDarkMode | () => boolean | Si el escritorio está en modo oscuro. |
terminalSize | () => [u16, u16]? | Las columnas y filas del terminal. |
isScreenLocked | () => boolean | Si el salvapantallas/pantalla de bloqueo está activo. |
isSessionLocked | () => boolean | Si 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
| Export | Firma | Propósito |
|---|---|---|
systemFonts | () => FontInfo[] | Una entrada por cada face de fuente instalada en el sistema. |
accessibleColorContrast | (fg: Color, bg: Color) => boolean | Si un par de colores cumple la proporción de contraste AA de WCAG. |
Utilidades
| Export | Firma | Propósito |
|---|---|---|
hasCapability | (cap: SystemCapability) => boolean | Si 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
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");
}