Nyx con Ejemplos

English

The best way to learn a language is to read real code. This collection of short, focused examples walks you through Nyx one concept at a time. Each recipe is self-contained: you can copy it, run it, and modify it to explore further.

No prior experience with Nyx is required. If you can read code in any C-like language, you will feel at home immediately.

Español

La mejor forma de aprender un lenguaje es leer código real. Esta colección de ejemplos cortos y enfocados recorre Nyx concepto por concepto. Cada receta es autocontenida: se puede copiar, ejecutar y modificar para explorar más.

No se requiere experiencia previa con Nyx. Si se puede leer código en cualquier lenguaje similar a C, resultará familiar de inmediato.

Fundamentos

El programa Nyx más simple — imprimir texto en la terminal.

let inmutable, var mutable, tipos básicos e interpolación de strings.

Definir funciones con parámetros, tipos de retorno y argumentos por defecto.

Flujo de Control

if/else, bucles while, for-range, for-in, break y continue.

Crear, indexar, agregar elementos e iterar sobre arrays dinámicos.

Almacenamiento clave-valor con Map.new(), insert, get, has e iteración de claves.

trim, length, substring, toUpper, split, contains e interpolación.

Definir tipos de datos con campos y agregar métodos vía impl.

Tipos de datos algebraicos con variantes que portan datos y match exhaustivo.

Funciones de primera clase que capturan su entorno circundante.

E/S y Datos

Lectura y Escritura de Archivos

Leer y escribir archivos con read_file y write_file.

Entrada por Stdin

Leer entrada del usuario desde la terminal con read_line.

Argumentos de CLI

Acceder a los argumentos de línea de comandos con get_args.

Variables de Entorno

Leer variables de entorno con getenv y getenv_default.

Parsear strings JSON hacia Maps y Arrays.

Serialización de JSON

Convertir estructuras de datos de vuelta a strings JSON.

Expresiones Regulares

Match, extracción y reemplazo con regex POSIX.

Dividir líneas y campos para procesar datos tabulares.

Timestamps, fechas formateadas y medición de tiempo.

Threads y Channels

Crear threads y comunicarse mediante channels.

Tipos y Patrones

Definir comportamiento compartido con trait e impl ... for.

Restringir genéricos con <T: Display>.

Generar automáticamente implementaciones de Clone, Debug y otros traits.

Manejar valores opcionales con Some y None.

Manejo de errores con Ok y Err.

Propagación de errores con cortocircuito usando ?.

Desestructurar enums en condiciones con if let.

Agregar condiciones a los brazos de match con guardas if.

Iterator: Map y Filter

Transformaciones perezosas con .iter().filter().map().collect().

Reducir una secuencia a un único valor con fold.

Avanzado

Iterator: Enumerate

Obtener pares índice-valor durante la iteración.

Iterator: Take y Skip

Recortar secuencias con take y skip.

Resolver problemas con funciones que se llaman a sí mismas.

Ordenar arrays de enteros y strings.

Manejo de Errores

Bloques try/catch para recuperarse de errores en tiempo de ejecución.

Limpieza garantizada con bloques defer { ... }.

Pausar la ejecución y medir tiempo transcurrido.

Crypto: Hashing

SHA-256, MD5 y HMAC-SHA256 para verificación de integridad.

Generar números aleatorios e identificadores únicos.

Ejecutar funciones de forma concurrente con thread_spawn.

Redes y Protocolos

Codificación/decodificación RFC 4648 — variantes estándar y URL-safe.

Percent-encoding, query strings y escape de entidades HTML.

Configuración TOML

Parsear strings de configuración con std/toml.

Serialización binaria — ~30% más liviana que JSON.

Resolución DNS

Convertir nombres de host a direcciones IP con resolve.

Conectar, escribir y leer sobre sockets TCP crudos.

Escuchar, aceptar y hacer eco con tcp_listen.

Datagramas sin conexión con udp_bind y udp_sendto.

Peticiones de cliente HTTP de alto nivel con std/http.

Peticiones POST y métodos personalizados con http_request.

Servidor mínimo con http_serve y enrutamiento de peticiones.

Middleware HTTP

Framework web con App, rutas, logging y CORS.

Framing RFC 6455, parseo y respuestas de handshake.

Construir manualmente mensajes en el formato de cable de Redis.

Base de datos SQL en memoria con sqlite_open y sqlite_query.

Escritura de CSV

Crear y serializar documentos CSV con std/csv.

Concurrencia

Proteger estado compartido entre threads con locks.

Patrones de Channel

Paso de mensajes con channels con buffer y centinelas.

Despachar tareas a N threads mediante channels compartidos.

Productor-Consumidor

Pipeline desacoplado con contrapresión de channel acotado.

Esperar a múltiples threads con wg_add/wg_done/wg_wait.

Limitar el acceso concurrente con sem_acquire/sem_release.

Multiplexar channels con la sentencia select.

Sistemas

Ejecutar comandos externos con fork, execvp y waitpid.

Conectar procesos con pipe_new y dup2.

Manejo de Señales

Registrar callbacks de señales con signal_handle.

Monitor de Archivos

Detectar cambios en archivos mediante polling con stat.

Control de Procesos

PID, directorio de trabajo, detección de terminal y stat de archivos.

Entrada carácter por carácter con raw_mode_enter.

Script con Shebang

Ejecutar archivos Nyx como scripts ejecutables con #!/usr/bin/env nyx.

nyx-kv (Almacén Clave-Valor)

Conectarse a nyx-kv y emitir comandos SET/GET/DEL sobre RESP.

RPUSH, LPOP, LRANGE, LLEN para colas FIFO y pilas.

HSET/HGET/HLEN para datos estructurados como perfiles de usuario.

Autenticación multi-tenant con tokens y namespaces.

Mensajería en tiempo real con SUBSCRIBE y PUBLISH.

TTL con EXPIRE, PERSIST y SET EX para caché y sesiones.

Comandos en lote para un throughput de 250K+ ops/seg.

nyx-serve (Framework Web)

Enrutamiento RESTful con GET/POST/PUT/DELETE y parámetros de ruta.

Parsear cuerpos de petición y construir respuestas JSON con helpers.

Archivos Estáticos

Servir CSS, JS e imágenes con app_static y detección de MIME.

Sesiones basadas en cookies respaldadas por nyx-kv con TTL.

http_serve_mt con N threads de trabajo para 73K req/s.

Headers cross-origin con mw_cors y cors_configure.

Servidor HTTP + API JSON + backend nyx-kv en un solo binario.

nyx-proxy (Proxy Reverso)

Configuración de Proxy

Parsear proxy.toml con std/toml.

Hosts Virtuales

Enrutar por el header Host hacia distintos upstreams.

Sondear upstreams por TCP con umbral y recuperación automática.

Ventana deslizante por IP que devuelve HTTP 429 al exceder el límite.

HTTPS multi-dominio en un solo puerto con certificados de Let's Encrypt.

Queue, DB y HTTP/2

Cola de mensajes persistente con ENQUEUE y QLEN.

Bucle DEQUEUE + ACK/NACK con reentrega automática.

CREATE/INSERT/SELECT sobre el protocolo RESP de nyx-db.

Transacciones de DB

BEGIN/COMMIT/ROLLBACK para operaciones atómicas.

Servidor HTTP/2

Multiplexado de streams y compresión de headers con HPACK.

Frames de HTTP/2

Tipos de frame binarios: DATA, HEADERS, SETTINGS, PING.

Patrones Full-stack

API CRUD completa con middleware y backend nyx-kv.

Pub/Sub en Tiempo Real

WebSocket + Pub/Sub de nyx-kv para actualizaciones en vivo.

Consumidor de cola con patrón cache-aside vía nyx-kv.

API con Rate Limit

INCR + EXPIRE atómicos para límites de tasa por usuario.

Stack de Producción

Arquitectura completa de nyxlang.com: proxy + web + kv + queue.