tiny.profiling.report.format

1const std = @import("std");23const Allocator = std.mem.Allocator;45pub const Error = Allocator.Error;67pub fn ns(allocator: Allocator, value: f64) Error![]u8 {8    const magnitude = @abs(value);9    if (magnitude < 1_000) return std.fmt.allocPrint(allocator, "{d:.0} ns", .{value});10    if (magnitude < 1_000_000) return std.fmt.allocPrint(allocator, "{d:.1} µs", .{value / 1_000});11    if (magnitude < 1_000_000_000) return std.fmt.allocPrint(allocator, "{d:.1} ms", .{value / 1_000_000});12    if (magnitude < 60 * 1_000_000_000) return std.fmt.allocPrint(allocator, "{d:.2} s", .{value / 1_000_000_000});13    const total_seconds = value / 1_000_000_000;14    const minutes = @divTrunc(total_seconds, 60);15    return std.fmt.allocPrint(allocator, "{d:.0} m {d:.0} s", .{ minutes, total_seconds - minutes * 60 });16}1718pub fn kib(allocator: Allocator, value: f64) Error![]u8 {19    const magnitude = @abs(value);20    if (magnitude < 1024) return std.fmt.allocPrint(allocator, "{d:.0} KiB", .{value});21    if (magnitude < 1024 * 1024) return std.fmt.allocPrint(allocator, "{d:.1} MiB", .{value / 1024});22    return std.fmt.allocPrint(allocator, "{d:.2} GiB", .{value / (1024 * 1024)});23}2425pub fn bytes(allocator: Allocator, value: f64) Error![]u8 {26    const magnitude = @abs(value);27    if (magnitude < 1024) return std.fmt.allocPrint(allocator, "{d:.0} B", .{value});28    return kib(allocator, value / 1024);29}3031pub fn count(allocator: Allocator, value: f64) Error![]u8 {32    const magnitude = @abs(value);33    if (magnitude < 10_000) return std.fmt.allocPrint(allocator, "{d:.0}", .{value});34    if (magnitude < 1_000_000) return std.fmt.allocPrint(allocator, "{d:.1} k", .{value / 1_000});35    if (magnitude < 1_000_000_000) return std.fmt.allocPrint(allocator, "{d:.1} M", .{value / 1_000_000});36    return std.fmt.allocPrint(allocator, "{d:.1} G", .{value / 1_000_000_000});37}3839pub fn percent(allocator: Allocator, value: f64) Error![]u8 {40    if (value >= 0) return std.fmt.allocPrint(allocator, "+{d:.1}%", .{value});41    return std.fmt.allocPrint(allocator, "{d:.1}%", .{value});42}4344pub fn seconds(allocator: Allocator, value: f64) Error![]u8 {45    return ns(allocator, value * 1_000_000_000);46}4748pub fn timestamp(allocator: Allocator, unix_ns: i128) Error![]u8 {49    if (unix_ns <= 0) return allocator.dupe(u8, "unknown");50    const secs: u64 = @intCast(@divTrunc(unix_ns, std.time.ns_per_s));51    const epoch_seconds = std.time.epoch.EpochSeconds{ .secs = secs };52    const year_day = epoch_seconds.getEpochDay().calculateYearDay();53    const month_day = year_day.calculateMonthDay();54    const day_seconds = epoch_seconds.getDaySeconds();55    return std.fmt.allocPrint(allocator, "{d:0>4}-{d:0>2}-{d:0>2} {d:0>2}:{d:0>2} UTC", .{56        year_day.year,57        month_day.month.numeric(),58        month_day.day_index + 1,59        day_seconds.getHoursIntoDay(),60        day_seconds.getMinutesIntoHour(),61    });62}6364pub fn shortSha(sha: ?[]const u8) []const u8 {65    const actual = sha orelse return "unknown";66    return actual[0..@min(actual.len, 10)];67}6869test "format ns scales through units" {70    var arena_state = std.heap.ArenaAllocator.init(std.testing.allocator);71    defer arena_state.deinit();72    const allocator = arena_state.allocator();73    try std.testing.expectEqualStrings("512 ns", try ns(allocator, 512));74    try std.testing.expectEqualStrings("1.5 µs", try ns(allocator, 1_500));75    try std.testing.expectEqualStrings("32.0 ms", try ns(allocator, 32_028_329));76    try std.testing.expectEqualStrings("2.05 s", try ns(allocator, 2_045_000_690));77    try std.testing.expectEqualStrings("1 m 21 s", try ns(allocator, 80_837_892_135));78}7980test "format memory and counts" {81    var arena_state = std.heap.ArenaAllocator.init(std.testing.allocator);82    defer arena_state.deinit();83    const allocator = arena_state.allocator();84    try std.testing.expectEqualStrings("640 KiB", try kib(allocator, 640));85    try std.testing.expectEqualStrings("1.7 MiB", try kib(allocator, 1_762));86    try std.testing.expectEqualStrings("1.68 GiB", try kib(allocator, 1_762_464));87    try std.testing.expectEqualStrings("96 B", try bytes(allocator, 96));88    try std.testing.expectEqualStrings("64 KiB", try bytes(allocator, 65_536));89    try std.testing.expectEqualStrings("387", try count(allocator, 387));90    try std.testing.expectEqualStrings("12.5 k", try count(allocator, 12_500));91}9293test "format percent carries sign" {94    var arena_state = std.heap.ArenaAllocator.init(std.testing.allocator);95    defer arena_state.deinit();96    const allocator = arena_state.allocator();97    try std.testing.expectEqualStrings("+12.3%", try percent(allocator, 12.34));98    try std.testing.expectEqualStrings("-4.2%", try percent(allocator, -4.2));99}100101test "format timestamp renders utc" {102    var arena_state = std.heap.ArenaAllocator.init(std.testing.allocator);103    defer arena_state.deinit();104    const allocator = arena_state.allocator();105    try std.testing.expectEqualStrings("2026-07-04 13:06 UTC", try timestamp(allocator, 1783170388327580663));106    try std.testing.expectEqualStrings("unknown", try timestamp(allocator, 0));107}108109test "format short sha" {110    try std.testing.expectEqualStrings("abf0e4b279", shortSha("abf0e4b279ac79b61e1929655be71eee969e1aba"));111    try std.testing.expectEqualStrings("unknown", shortSha(null));112    try std.testing.expectEqualStrings("abc", shortSha("abc"));113}

1pub const format = @import("format.zig");