DBuz - Pure Zig D-Bus client library

This library is more like a pet project and practice for me to learn Zig. It provides a simple interface to interact with D-Bus offloading multiple tasks to the zig's comptime.

Installation

$ zig fetch --save git+https://github.com/0xCatPKG/dbuz

Then in your build.zig file, do something like

const std = @import("std");

pub fn build(b: *std.Build) void {

    const target = b.standardTargetOptions(.{});
    const optimize = b.standardOptimizeOption(.{});

    const dbuz = b.dependency("dbuz", .{
        .target = target,
        .optimize = optimize,
    });

    // ...

    exe_mod.addImport("dbuz", dbuz.module("dbuz"));
    // ...
}

Usage

Simple example

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

pub fn main() !void {
    const allocator = std.heap.page_allocator;

    /// Create connection to D-Bus session bus
    const connection = try dbuz.connect(allocator, .{});
    defer connection.deinit();

    const poll_cond, const poll_thread =
    try dbuz.spawnPollingThread(connection, allocator);

    defer allocator.destroy(poll_cond);
    defer poll_thread.join();
    defer poll_cond.* = false;

    std.posix.nanosleep(0, std.time.ns_per_ms * 25); // Sleep for some time to avoid busy loop

    std.debug.print('My unique name is: {?s}\n', .{connection.unique_name});
}

Handling method calls and signals

Information about handling method calls and signals in dbuz may be found in Interfaces and MatchGroups

Serialization rules

dbuz serializes native types using compile time reflection. Following mapping exists: