Skip to content

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 ​

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

Identificação do Sistema ​

ExportAssinaturaFinalidade
platform() => OsPlatformA plataforma alvo.
arch() => OsArchA arquitetura de CPU alvo.
EOLstringA constante nativa de fim de linha.
hostname() => stringO hostname de rede da máquina.
release() => stringA versão de release/build do kernel.
systemName() => stringO nome do sistema no padrão POSIX (uname -s).
locale() => stringO código de locale atual.
language() => stringO subtag de idioma do locale atual.

Usuário e Diretórios ​

ExportAssinaturaFinalidade
userInfo() => UserInfoLogin, diretório home e shell numa única chamada.
userName() => stringO nome de login.
whoami() => string?O nome real (GECOS), não o login.
homeDir() => stringO diretório home do usuário.
cacheDir() => stringO diretório de cache do usuário.
configDir() => stringO diretório de configuração do usuário.
dataDir() => stringO diretório de dados do usuário.
tempDir() => stringO 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) => stringUm subdiretório específico de aplicação dentro de dataDir.

Hardware e Performance ​

ExportAssinaturaFinalidade
cpus() => CpuInfo[]Uma entrada por núcleo lógico de CPU.
totalMem() => u64Memória total do sistema, em bytes.
freeMem() => u64Memória livre do sistema, em bytes.
uptime() => u64Segundos 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 ​

ExportAssinaturaPropósito
isDarkMode() => booleanSe a área de trabalho está em modo escuro.
terminalSize() => [u16, u16]?As colunas e linhas do terminal.
isScreenLocked() => booleanSe a proteção de tela/tela de bloqueio está ativa.
isSessionLocked() => booleanSe 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 ​

ExportAssinaturaPropósito
systemFonts() => FontInfo[]Uma entrada por face de fonte instalada no sistema.
accessibleColorContrast(fg: Color, bg: Color) => booleanSe um par de cores atende à proporção de contraste AA do WCAG.

Utilitários ​

ExportAssinaturaPropósito
hasCapability(cap: SystemCapability) => booleanSe 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 ​

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");
}