Struct AdvancedDownloader 

pub struct AdvancedDownloader { /* private fields */ }

High-performance downloader with parallel connections and resume support.

AdvancedDownloader is the recommended way to download large files. It provides:

• Parallel chunk downloads: Splits files into segments downloaded simultaneously
• Automatic resume: Detects existing partial files and resumes from last position
• Server compatibility: Falls back to single-stream if server doesn’t support ranges
• ISO optimization: Disables compression for binary files to prevent corruption
• Progress tracking: Real-time callbacks for UI integration
• Cancellation support: Stop downloads gracefully via atomic cancel token

Example

use kget::{AdvancedDownloader, ProxyConfig, Optimizer};

let downloader = AdvancedDownloader::new(
    "https://example.com/large-file.zip".to_string(),
    "large-file.zip".to_string(),
    false,  // quiet_mode
    ProxyConfig::default(),
    Optimizer::new(),
);

downloader.download().expect("Download failed");

With Progress Tracking

use kget::{AdvancedDownloader, ProxyConfig, Optimizer};

let mut dl = AdvancedDownloader::new(
    "https://example.com/file.iso".to_string(),
    "file.iso".to_string(),
    true, // quiet mode (no stdout)
    ProxyConfig::default(),
    Optimizer::new(),
);

dl.set_progress_callback(|p| {
    // p is 0.0 to 1.0
    update_ui_progress(p);
});

dl.set_status_callback(|msg| println!("{}", msg));

dl.download().unwrap();

fn update_ui_progress(p: f32) {
    // Update your UI here
}

Implementations

impl AdvancedDownloader

pub fn new( url: String, output_path: String, quiet_mode: bool, proxy_config: ProxyConfig, optimizer: Optimizer, ) -> Result<Self, Box<dyn Error + Send + Sync>>

Create a new AdvancedDownloader instance.

Arguments

• url - URL to download from
• output_path - Local path for the downloaded file
• quiet_mode - If true, suppress console output
• proxy_config - Proxy settings (use ProxyConfig::default() for direct connection)
• optimizer - Optimizer for connection settings

Example

use kget::{AdvancedDownloader, ProxyConfig, Optimizer};

let dl = AdvancedDownloader::new(
    "https://example.com/file.zip".to_string(),
    "./downloads/file.zip".to_string(),
    false,
    ProxyConfig::default(),
    Optimizer::new(),
);

pub fn set_cancel_token(&mut self, token: Arc<AtomicBool>)

Set a custom cancellation token for graceful download interruption.

When the token is set to true, the download will stop at the next checkpoint and return an error.

Example

use kget::{AdvancedDownloader, ProxyConfig, Optimizer};
use std::sync::Arc;
use std::sync::atomic::AtomicBool;

let cancel = Arc::new(AtomicBool::new(false));
let mut dl = AdvancedDownloader::new(/* ... */
);
dl.set_cancel_token(cancel.clone());

// In another thread:
// cancel.store(true, std::sync::atomic::Ordering::Relaxed);

pub fn is_cancelled(&self) -> bool

Check if the download has been cancelled.

pub fn set_progress_callback( &mut self, callback: impl Fn(f32) + Send + Sync + 'static, )

Set a callback for progress updates.

The callback receives a value from 0.0 (start) to 1.0 (complete).

Example

dl.set_progress_callback(|progress| {
    println!("Downloaded: {:.1}%", progress * 100.0);
});

pub fn set_status_callback( &mut self, callback: impl Fn(String) + Send + Sync + 'static, )

Set a callback for status messages.

Receives human-readable status updates during the download.

Example

dl.set_status_callback(|msg| {
    println!("Download status: {}", msg);
});

pub fn set_expected_sha256(&mut self, expected_sha256: impl Into<String>)

Set an expected SHA-256 hash for automatic verification after download.

pub fn set_extra_headers(&mut self, headers: Vec<(String, String)>)

Set extra HTTP headers sent with every request (e.g. Referer or Cookie).

pub fn set_resume_policy(&mut self, policy: ResumePolicy)

Set how the downloader handles interactive prompts.

Library and automation callers must set ResumePolicy::AlwaysResume to avoid blocking on stdin.

pub fn download(&self) -> Result<(), Box<dyn Error + Send + Sync>>

Start the download.

This method:

1. Checks for existing partial file (resume support)
2. Queries server for file size and range support
3. Downloads using parallel connections if supported
4. Falls back to single-stream if server doesn’t support ranges

Returns

Returns Ok(()) on successful download, or an error if the download fails.

Errors

• Network connection failures
• Existing file larger than remote (corrupted state)
• Cancellation via cancel token
• Disk I/O errors