https://github.com/malcolmstill/zig-amqp

AMQP 0.9.1 library for Zig
https://github.com/malcolmstill/zig-amqp

amqp amqp0-9-1 zig

Last synced: 16 days ago
JSON representation

AMQP 0.9.1 library for Zig

• Host: GitHub
• URL: https://github.com/malcolmstill/zig-amqp
• Owner: malcolmstill
• License: bsd-3-clause
• Created: 2020-10-28T02:34:40.000Z (about 4 years ago)
• Default Branch: master
• Last Pushed: 2024-06-16T12:36:13.000Z (5 months ago)
• Last Synced: 2024-10-15T02:43:02.743Z (29 days ago)
• Topics: amqp, amqp0-9-1, zig
• Language: Zig
• Homepage:
• Size: 176 KB
• Stars: 5
• Watchers: 4
• Forks: 1
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
zig-amqp




  AMQP 0.9.1 library for Zig



## About

`zig-amqp` is a [Zig](https://ziglang.org) library for writing AMQP 0.9.1 clients (and servers), letting zig programs to connect to, for example, [RabbitMQ](https://www.rabbitmq.com/).

## How to use

See [the examples](https://github.com/malcolmstill/zig-amqp/tree/master/examples) for an idea of how to use the library.

The simplest program is probably a simple declare and publish:

```zig

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