zig network

Abstracción de la red Zig

Pequeña capa de abstracción de red alrededor de TCP y UDP.

Características

• Implementa la superficie API mínima para redes básicas.
• Hace abstracciones multiplataforma
• Admite E/S con y sin bloqueo mediante select / poll
• Soporte de multidifusión UDP

Uso

Usar con el administrador de paquetes

build.zig.zon :

.{
    . name = "appname" ,
    . version = "0.0.0" ,
    . dependencies = .{
        . network = .{
            . url = "https://github.com/MasterQ32/zig-network/archive/<COMMIT_HASH_HERE>.tar.gz" ,
            . hash = "HASH_GOES_HERE" ,
        },
    },
}

(Para adquirir el hash, elimine la línea que contiene .hash , el compilador le indicará qué línea volver a colocar)

build.zig :

 exe . addModule ( "network" , b . dependency ( "network" , .{}). module ( "network" ));

Ejemplo de uso

 const network = @import ( "network" );

test "Connect to an echo server" {
    try network . init ();
    defer network . deinit ();

    const sock = try network . connectToHost ( std . heap . page_allocator , "tcpbin.com" , 4242 , .tcp );
    defer sock . close ();

    const msg = "Hi from socket! n " ;
    try sock . writer (). writeAll ( msg );

    var buf : [ 128 ] u8 = undefined ;
    std . debug . print ( "Echo: {}" , .{ buf [0 .. try sock . reader (). readAll ( buf [0 .. msg . len ])]});
}

Consulte async.zig para obtener un ejemplo más completo sobre cómo utilizar E/S asíncronas para crear un pequeño servidor TCP.

Ejecutar ejemplos

Construya todos los ejemplos:

$ zig build examples

Construya un ejemplo específico:

$ zig build sync-examples

Para probar un ejemplo, por ejemplo. echo :

$ ./zig-out/bin/echo 3000

en otra terminal

$ nc localhost 3000
hello
hello
how are you
how are you

Notas

En Windows, las llamadas a funciones de recepción y envío son asíncronas y cooperan con el bucle de eventos de la biblioteca estándar cuando io_mode = .evented está configurado en el archivo raíz de su programa.
Otras llamadas (conectar, escuchar, aceptar, etc.) se están bloqueando.