Advanced Examples

template_with_eta_speed

{elapsed} / {eta} / {speed} with custom formatters:

zig build run-template_with_eta_speed

.formatters = .{
    .elapsed = formatElapsed,
    .eta = formatEta,
    .speed = formatSpeed,
},

runtime_style_swap

Swap bar characters mid-run with setStyle:

zig build run-runtime_style_swap

runtime_frame_swap

Swap spinner frames mid-run with setFrames:

zig build run-runtime_frame_swap

pause_resume

pause / continue_ freezing the clock:

zig build run-pause_resume

text_updates

Dynamic text updates with setText / setPrefix / setSuffix:

zig build run-text_updates

dynamic_messages

Text, color, and style changes driven by task phase:

zig build run-dynamic_messages

infinite_progress_bar

Auto-threaded bar with no known total, stopped via fail:

zig build run-infinite_progress_bar

clear_on_finish

FinishConfig.clear erases the bar line; post-run output via stdoutWriter:

zig build run-clear_on_finish

bar.finish(.{ .clear = true, .newline = true });

const w = loaders.stdoutWriter(io);
w.writeAll("completed\n") catch {};

fail_and_status

fail(message) and getStatus checks:

zig build run-fail_and_status

callback_hooks

on_tick / on_finish / on_pause / on_resume hooks with ctx:

zig build run-callback_hooks

var counts = Counters{};
var bar = try loaders.ProgressBar.init(allocator, io, .{
    .total = 100,
    .on_tick = onTick,
    .on_finish = onFinish,
    .ctx = &counts,
});

state_accessor

Reading state() snapshots (progress, percent, elapsed, eta, speed):

zig build run-state_accessor