El lenguaje Zig es conocido por su enfoque minimalista y por su herramienta integrada, la cual sirve como gestor de compilación, formato, prueba, y mucho más. Cuando hablamos de una lista de herramientas del lenguaje Zig, nos referimos a los diferentes comandos y utilidades que ofrece la distribución oficial del compilador zig para facilitar el flujo de trabajo de desarrollo.
Componentes principales de la herramienta Zig
zig build– Sistema de construcción basado en archivosbuild.zig.zig build-exe– Compilación directa de un ejecutable a partir de una fuente.zig run– Compila y ejecuta un programa de forma instantánea.zig test– Ejecuta los tests definidos en archivos.zig.zig fmt– Formateador de código fuente.zig mod– Gestor de dependencias y módulos.zig docs– Generador de documentación para proyectos Zig.
Herramientas de compilación y ejecución
Para la mayoría de los desarrolladores, los comandos zig build-exe y zig run son los primeros que encuentran. A continuación se describen con mayor detalle:
- zig build-exe: Compila directamente un archivo fuente y genera un binario. Útil cuando se trabaja con proyectos pequeños.
- zig run: Hace lo mismo que
zig build-exepero además ejecuta el binario resultante, lo que facilita la prueba rápida de código.
Formateo y linting
El formateador zig fmt garantiza que todo el código siga las convenciones de estilo oficiales. No existe un linter oficial aparte del formateador, pero el propio compilador ofrece advertencias y mensajes de error que ayudan a mantener la calidad del código.
Gestión de dependencias y módulos
Zig introduce un sistema de módulos que permite importar y compartir código de forma segura y eficiente. El comando zig mod permite descargar, actualizar y eliminar dependencias:
zig mod fetch <URL>– Descarga un módulo desde un repositorio remoto.zig mod update– Actualiza las dependencias según el archivobuild.zig.zig mod remove <module>– Elimina un módulo.
Generación de documentación
Con zig docs se pueden producir archivos HTML que describen la API de un proyecto. Este comando lee los comentarios /// que siguen la sintaxis de documentación de Zig.
Ejemplo práctico 1: Compilación y ejecución rápida
Supongamos que queremos compilar y ejecutar un pequeño programa que imprime “Hola, mundo”. El siguiente código se escribe en el archivo hello.zig:
// hello.zig
// El paquete estándar ofrece funciones básicas, incluidas las de entrada y salida
const std = @import("std"); // Importa el paquete estándar
pub fn main() !void { // Función principal, devuelve error opcional
// Obtiene un escritor de salida estándar (stdout)
const stdout = std.io.getStdOut().writer();
// Escribe la cadena "Hola, mundo\n" en stdout
try stdout.print("Hola, mundo\\n", .{});
}
Explicación línea por línea:
- const std = @import(“std”); – Importa el paquete estándar de Zig, que contiene utilidades de I/O, manejo de errores, y más.
- pub fn main() !void { – Define la función pública
mainque es el punto de entrada del programa. El símbolo!indica que la función puede devolver un error opcional. - const stdout = std.io.getStdOut().writer(); – Obtiene un escritor que escribe en la salida estándar.
- try stdout.print(“Hola, mundo\\n”, .{}); – Llama a la función
printdel escritor, pasando la cadena y un conjunto vacío de parámetros. Eltrypropaga cualquier error que ocurra.
Para compilar y ejecutar, en la terminal ejecutamos:
zig run hello.zig
El comando zig run compila hello.zig y lo ejecuta, mostrando en pantalla:
Hola, mundo
Ejemplo práctico 2: Construcción con build.zig
Cuando el proyecto crece, es conveniente usar el sistema de construcción de Zig. Creamos un directorio llamado project con los siguientes archivos:
build.zigsrc/main.zig
Contenido de build.zig:
const std = @import("std");
pub fn build(b: *std.Build) void {
// Crea una opción para el objetivo del compilador
const target = b.standardTargetOptions(.{});
// Crea una opción para la configuración de optimización
const optimize = b.standardOptimizeOption(.{});
// Añade un ejecutable llamado "app" usando el archivo src/main.zig
const exe = b.addExecutable("app", "src/main.zig");
exe.setTarget(target);
exe.setBuildMode(optimize);
// Agrega el ejecutable al paso de compilación por defecto
b.installArtifact(exe);
}
Contenido de src/main.zig (el mismo que antes, pero en otro directorio):
const std = @import("std");
pub fn main() !void {
const stdout = std.io.getStdOut().writer();
try stdout.print("Hola, mundo\n", .{});
}
Explicación de build.zig:
- <
