zig-amqp

AMQP 0.9.1 library for Zig

About

zig-amqp is a Zig library for writing AMQP 0.9.1 clients (and servers), letting zig programs to connect to, for example, RabbitMQ.

How to use

See the examples for an idea of how to use the library.

The simplest program is probably a simple declare and publish:

const std = @import("std");
const amqp = @import("amqp");

var rx_memory: [4096]u8 = undefined;
var tx_memory: [4096]u8 = undefined;

pub fn main() !void {
    var conn = amqp.init(rx_memory[0..], tx_memory[0..]);
    const addr = try std.net.Address.parseIp4("127.0.0.1", 5672);
    try conn.connect(addr);

    var ch = try conn.channel();
    _ = try ch.queueDeclare("simple_publish", .{}, null);

    try ch.basicPublish("", "simple_publish", "hello world", .{});
}

Status

The project is alpha with only basic functionality working and almost certainly is not ready for you to use. Contributions welcome and I can prioritise features that people require.

Goals

• Easy to use API
• Simple / clean code
• Minimal allocations / customisable allocation
• Fast

Dependencies

Runtime

• None...and the binaries are small (other than a server to speak to)

➜  zig-amqp git:(master) ✗ zig build-exe src/example.zig -O ReleaseSafe --strip 
➜  zig-amqp git:(master) ✗ ldd example                                        
        not a dynamic executable
➜  zig-amqp git:(master) ✗ ls -l example                                      
-rwxr-xr-x. 1 malcolm malcolm 44872 Dec 20 04:26 example

Build

• A zig compiler (tested on at least 0.13.0)

Regenerating src/protocol.zig

• python 3