Examples

Practical examples demonstrating downloader.zig usage.

Available Examples

Example	Description
Basic	Simple download with progress bar
Advanced	Full configuration options
Concurrent	Parallel downloads with threads
Resume	Resume interrupted downloads
Checksum	File integrity verification
Updates	Check for library updates

Running Examples

From the project root:

# Basic download
zig build run

# With custom URL
zig build run -- https://example.com/file.zip

# Specific examples
zig build run-advanced
zig build run-concurrent
zig build run-resume
zig build run-checksum
zig build run-update_check

# All examples
zig build run-all-examples

Quick Start

Minimal Download

const downloader = @import("downloader");

pub fn main() !void {
    var gpa = std.heap.GeneralPurposeAllocator(.{}){};
    defer _ = gpa.deinit();

    _ = try downloader.download(
        gpa.allocator(),
        "https://example.com/file.pdf",
        "file.pdf"
    );
}

With Progress

_ = try downloader.downloadWithProgress(
    allocator,
    url,
    output,
    struct {
        fn callback(p: downloader.Progress) bool {
            if (p.percentage()) |pct| {
                std.debug.print("\r{d:.1}%", .{pct});
            }
            return true;
        }
    }.callback
);

With Configuration

var client = try downloader.Client.init(allocator, .{
    .max_retries = 5,
    .resume_downloads = true,
    .file_exists_action = .rename_with_number,
});
defer client.deinit();

_ = try client.download(url, output, null);

Common Patterns

Error Handling

const result = client.download(url, output, null);
if (result) |bytes| {
    std.debug.print("Downloaded {d} bytes\n", .{bytes});
} else |err| {
    std.debug.print("Failed: {s}\n", .{@errorName(err)});
}

Cancellation

var cancel_flag = false;

fn callback(p: downloader.Progress) bool {
    _ = p;
    return !cancel_flag;
}

File Naming

config.file_exists_action = .rename_with_number;
// Creates: file.pdf, file (1).pdf, file (2).pdf, etc.