Skip to content

Módulos nativos ​

Módulos nativos expõem funcionalidades de runtime por caminhos de import estáveis tyrus:*. Suas APIs são concisas, e suas implementações são linkadas em binários nativos. Todo módulo faz parte da distribuição padrão, sem package manager, sem npm install, sem runtime externo.

Módulos disponíveis ​

MóduloFinalidade
tyrus:algorithmEstruturas de dados e algoritmos nativos para ordenação, busca, grafos, árvores e coleções.
tyrus:archiveCria, inspeciona e extrai com segurança arquivos ZIP, TAR e TAR.GZ.
tyrus:cliHelpers interativos de prompt de terminal.
tyrus:compressComprime e descomprime bytes com Gzip, Deflate, Deflate cru e Brotli.
tyrus:cryptoPrimitivas criptográficas: digest, HMAC, AES-256-GCM, Argon2, JWT e aleatório seguro.
tyrus:dbSnapshots versionados de schema SQLite, verificações somente leitura e contrato de erro do banco.
tyrus:encodingConversão explícita de UTF-8, UTF-16, hexadecimal, Base64, Base32 e radix.
tyrus:fsLeitura e escrita síncrona de arquivos para programas nativos.
tyrus:httpServidor HTTP, rotas, resposta, status e helpers orientados a API.
tyrus:mathConstantes e funções matemáticas.
tyrus:memoryOwnership explícito, apagamento seguro e consultas de layout em tempo de compilação.
tyrus:netParsing de endereços, resolução de nomes com Result, comunicação TCP e UDP assíncrona e sondagens condicionais à capacidade.
tyrus:osIdentificação multiplataforma do sistema operacional: plataforma, arquitetura, hostname, locale.
tyrus:processSubprocessos sem shell com streams padrão de bytes limitados.
tyrus:simdSoma vetorizada de arrays f32[] e f64[] de mesmo tamanho, com erros recuperáveis em Result.
tyrus:streamTransporte progressivo limitado com capacidades separadas de leitura e escrita.
tyrus:taskGerenciamento cooperativo de async tasks: cancelamento e suspensão temporizada.
tyrus:temporalInstantes nativos, valores de calendário, durações e fusos horários IANA.
tyrus:testSuítes de teste, asserções, hooks e modificadores executados por tyrus test.
tyrus:utilsHelpers nativos de texto como estilo ANSI e banners FIGlet.

Estilo de import ​

tyrus
import { readFileSync } from "tyrus:fs";
import { HttpStatus } from "tyrus:http";
import { input } from "tyrus:cli";
import { styleText } from "tyrus:utils";
import { digest, hmac, cipher, jwt } from "tyrus:crypto";
import { cancel, sleep } from "tyrus:task";

Imports tyrus:* são resolvidos pelo compilador como módulos integrados.

Usando módulos juntos ​

Módulos nativos se compõem naturalmente. Um projeto CLI típico pode ler config do filesystem, pedir input e aplicar estilos:

tyrus
import { writeFileSync, type FsError } from "tyrus:fs";
import { input, confirm } from "tyrus:cli";
import { styleText } from "tyrus:utils";

const main = (): void => {
    const name: string = input({ message: "Project name?" });
    const proceed: boolean = confirm({ message: `Create "${name}"?` });

    if (proceed) {
        match (writeFileSync(`${name}/main.tyr`, `print("hello from ${name}");`)) {
            Ok() => print(styleText("green", `Created ${name}`));
            Err(error) => printError(error.message);
        }
    }
};

Fronteira de runtime ​

Módulos nativos devem documentar imports públicos, tipos de retorno, comportamento de erro e diagnósticos antes de serem tratados como estáveis. APIs que imprimem UI chrome de terminal usam stderr para manter stdout reservado à saída normal do programa.