libxev-sys 0.0.1-rc.2

Low-level FFI bindings to libxev (built from vendored sources via Zig).
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

const builtin = @import("builtin");
const stream = @import("watcher/stream.zig");

/// The backend types.
pub const Backend = enum {
    io_uring,
    epoll,
    kqueue,
    wasi_poll,
    iocp,

    /// Returns a recommend default backend from inspecting the system.
    pub fn default() Backend {
        return switch (builtin.os.tag) {
            .linux => if (builtin.abi.isAndroid())
                .epoll
            else
                .io_uring,
            .ios, .macos, .visionos => .kqueue,
            .freebsd => .kqueue,
            .wasi => .wasi_poll,
            .windows => .iocp,
            else => {
                @compileLog(builtin.os);
                @compileError("no default backend for this target");
            },
        };
    }

    /// Candidate backends for this platform in priority order.
    pub fn candidates() []const Backend {
        return switch (builtin.os.tag) {
            .linux => if (builtin.abi.isAndroid())
                &.{.epoll}
            else
                &.{ .io_uring, .epoll },
            .ios, .macos, .visionos => &.{.kqueue},
            .freebsd => &.{.kqueue},
            .wasi => &.{.wasi_poll},
            .windows => &.{.iocp},
            else => {
                @compileLog(builtin.os);
                @compileError("no candidate backends for this target");
            },
        };
    }

    /// Returns the Api (return value of Xev) for the given backend type.
    pub fn Api(comptime self: Backend) type {
        return switch (self) {
            .io_uring => @import("main.zig").IO_Uring,
            .epoll => @import("main.zig").Epoll,
            .kqueue => @import("main.zig").Kqueue,
            .wasi_poll => @import("main.zig").WasiPoll,
            .iocp => @import("main.zig").IOCP,
        };
    }
};