codspeed 4.5.0

Core instrumentation library for CodSpeed
Documentation
const std = @import("std");
const c = @cImport(@cInclude("time.h"));
const errno = @cImport(@cInclude("errno.h"));
const fcntl_h = @cImport(@cInclude("fcntl.h"));

extern "c" fn nanosleep(nanos: u64) c_int;
extern "c" fn printf(format: [*c]const c_char, ...) c_int;

// Note: Using printf to avoid the extra code from std.log/std.debug. Those won't
// compile because they are internally using syscalls (for Mutexes) which aren't cross-platform.
//
// This wrapper converts Zig string literals to null-terminated c_char arrays and handles
// variadic argument forwarding to the C printf function.
pub fn print(comptime fmt: []const u8, args: anytype) void {
    // Create a comptime null-terminated c_char array from the format string
    const fmt_z = comptime blk: {
        var buf: [fmt.len:0]c_char = undefined;
        for (fmt, 0..) |byte, i| {
            buf[i] = byte;
        }
        buf[fmt.len] = 0;
        break :blk buf;
    };

    _ = @call(.auto, printf, .{&fmt_z} ++ args);
}

// Adaptation of [`std.Thread.sleep`](https://ziglang.org/documentation/0.14.0/std/#std.Thread.sleep)
// to ensure that the C code is architecture-independent. The stdlib implementation uses inline syscalls,
// which only works on a single architecture and is not portable.
pub fn sleep(nanoseconds: u64) void {
    const s = nanoseconds / std.time.ns_per_s;
    const ns = nanoseconds % std.time.ns_per_s;

    var req: c.struct_timespec = .{
        .tv_sec = std.math.cast(c.time_t, s) orelse std.math.maxInt(c.time_t),
        .tv_nsec = std.math.cast(c_long, ns) orelse std.math.maxInt(c_long),
    };
    var rem: c.struct_timespec = undefined;

    while (true) {
        const ret = c.nanosleep(&req, &rem);

        if (ret == errno.EINTR) {
            req = rem;
            continue;
        } else {
            return;
        }
    }
}

pub fn setNonBlocking(fd: std.posix.fd_t) void {
    const current_flags = fcntl_h.fcntl(fd, fcntl_h.F_GETFL, @as(c_int, 0));
    const new_flags = current_flags | fcntl_h.O_NONBLOCK;
    _ = fcntl_h.fcntl(fd, fcntl_h.F_SETFL, new_flags);
}

// Returns monotonic time since boot in nanoseconds.
//
// NOTE: Maximum representable timestamp is u64::MAX nanoseconds = 18,446,744,073,709,551,615 ns
//       which equals ~584.94 years from epoch (year 2554-07-21T23:34:33.709551615). Since CLOCK_MONOTONIC
//       measures time since boot, a system would need to run for ~585 years continuously to overflow this value.
pub fn clock_gettime_monotonic() u64 {
    const ts = std.posix.clock_gettime(std.posix.clockid_t.MONOTONIC) catch unreachable;

    const s = @as(u64, @intCast(ts.sec)) * std.time.ns_per_s;
    const nsec: u64 = @intCast(ts.nsec);

    return s + nsec;
}

test "sleep for at least 1 second" {
    const start = try std.time.Instant.now();
    sleep(1 * std.time.ns_per_s);
    const end = try std.time.Instant.now();

    const elapsed_ns: u64 = end.since(start);
    const elapsed_s = elapsed_ns / std.time.ns_per_s;

    std.debug.assert(elapsed_s >= 1);
    std.debug.assert(elapsed_s < 2);
}

test "print function works without crashing" {
    // Test with no arguments
    print("Hello, World!\n", .{});

    // Test with string argument
    print("Hello, %s!\n", .{"Zig"});

    // Test with multiple arguments
    print("Number: %d, String: %s\n", .{ @as(c_int, 42), "test" });

    // Test with format specifiers that need proper types
    print("Precision test: %.*s\n", .{ @as(c_int, 5), "HelloWorld" });
}