tyrus:os
tyrus:os expõe informações multiplataforma sobre o sistema operacional em que o binário compilado está rodando: plataforma, arquitetura, hostname, versão do kernel, locale, a constante de fim de linha, o usuário ativo e diretórios padrão. É somente leitura e puramente informativo, informações no nível do processo (pid, cwd(), memoryUsage(), etc.) ficam no global embutido process, documentado em Variáveis de Ambiente.
Imports
import { EOL, arch, hostname, language, locale, platform, release, systemName } from "tyrus:os";
import { OsArch, OsPlatform } from "tyrus:os";Identificação do Sistema
| Export | Assinatura | Finalidade |
|---|---|---|
platform | () => OsPlatform | A plataforma alvo. |
arch | () => OsArch | A arquitetura de CPU alvo. |
EOL | string | A constante nativa de fim de linha. |
hostname | () => string | O hostname de rede da máquina. |
release | () => string | A versão de release/build do kernel. |
systemName | () => string | O nome do sistema no padrão POSIX (uname -s). |
locale | () => string | O código de locale atual. |
language | () => string | O subtag de idioma do locale atual. |
Usuário e Diretórios
| Export | Assinatura | Finalidade |
|---|---|---|
userInfo | () => UserInfo | Login, diretório home e shell numa única chamada. |
userName | () => string | O nome de login. |
whoami | () => string? | O nome real (GECOS), não o login. |
homeDir | () => string | O diretório home do usuário. |
cacheDir | () => string | O diretório de cache do usuário. |
configDir | () => string | O diretório de configuração do usuário. |
dataDir | () => string | O diretório de dados do usuário. |
tempDir | () => string | O diretório temporário do sistema. |
desktopDir | () => string? | O diretório da área de trabalho, se existir. |
documentsDir | () => string? | O diretório de documentos, se existir. |
appDataDir | (app: string) => string | Um subdiretório específico de aplicação dentro de dataDir. |
Hardware e Performance
| Export | Assinatura | Finalidade |
|---|---|---|
cpus | () => CpuInfo[] | Uma entrada por núcleo lógico de CPU. |
totalMem | () => u64 | Memória total do sistema, em bytes. |
freeMem | () => u64 | Memória livre do sistema, em bytes. |
uptime | () => u64 | Segundos desde a última inicialização do sistema. |
loadAvg | () => f64[] | As médias de carga de 1/5/15 minutos. |
battery | () => BatteryInfo? | Informações da primeira bateria, se houver. |
cpuTemp | (unit: string) => f32? | A maior temperatura de sensor reportada. |
Tela e Sessão
| Export | Assinatura | Propósito |
|---|---|---|
isDarkMode | () => boolean | Se a área de trabalho está em modo escuro. |
terminalSize | () => [u16, u16]? | As colunas e linhas do terminal. |
isScreenLocked | () => boolean | Se a proteção de tela/tela de bloqueio está ativa. |
isSessionLocked | () => boolean | Se a sessão do usuário atual está bloqueada. |
preventSleep | () => Result<void, OsError> | Inibe a suspensão automática do sistema/tela. |
allowSleep | () => Result<void, OsError> | Reverte preventSleep. |
isScreenLocked/isSessionLocked são de melhor esforço e, por enquanto, só Linux, false em outras plataformas, ou quando o serviço subjacente não pode ser alcançado.
Fontes e Acessibilidade
| Export | Assinatura | Propósito |
|---|---|---|
systemFonts | () => FontInfo[] | Uma entrada por face de fonte instalada no sistema. |
accessibleColorContrast | (fg: Color, bg: Color) => boolean | Se um par de cores atende à proporção de contraste AA do WCAG. |
Utilitários
| Export | Assinatura | Propósito |
|---|---|---|
hasCapability | (cap: SystemCapability) => boolean | Se uma dada capacidade está disponível neste sistema. |
Veja Interfaces e Enums para o formato de OsPlatform, OsArch, SystemCapability, UserInfo, CpuInfo, BatteryInfo, FontInfo, e Color.
Valores não resolvidos nunca abortam o programa
hostname(), release(), systemName(), userName(), e toda função de diretório caem para "unknown" ou uma string vazia se o sistema operacional não reportar um valor. locale() e language() caem para "und", o subtag padrão de "locale indeterminado". whoami(), desktopDir(), documentsDir(), battery(), e cpuTemp() devolvem um tipo opcional porque ausência é um resultado normal (um sistema headless, uma conta sem nome real configurado, um desktop sem bateria, um container sem sensor térmico), nenhuma dessas funções pode falhar o programa como um erro de filesystem falharia. A única exceção é o argumento unit de cpuTemp: "celsius"/"fahrenheit" são os únicos valores válidos, e qualquer outro aborta o programa.
Exemplo
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");
}