parallel_downloader 0.2.0

A robust, concurrent file downloader designed to be resilient, supporting automatic retries, crash recovery, and download verification.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

//! Command-line argument definitions for the `pd` binary.
//!
//! This module defines the parsed CLI structures using `clap`. The
//! `Args` and `Commands` types are exported by the crate so the
//! library binary can consume them when assembling behavior.
use clap::{Parser, Subcommand};

/// A robust, concurrent file downloader.
///
/// This tool splits files into chunks and downloads them in parallel,
/// with support for resuming and rate limiting.
#[derive(Parser, Debug)]
#[command(author, version, about)]
pub struct Args {
    #[command(subcommand)]
    pub command: Option<Commands>,
}

#[derive(Subcommand, Debug)]
pub enum Commands {
    /// Start the background daemon
    Start,
    /// Add a download to the running daemon
    Add {
        /// URL to download
        #[arg(short, long)]
        url: String,
        /// Directory path
        #[arg(short, long)]
        dir: String,
    },
    /// List active downloads
    Status,
    /// Stop the daemon
    Stop,
    /// Run in standalone mode
    Run {
        /// The URL of the file to download.
        #[arg(short, long)]
        url: String,

        /// The name of the output file. If not provided, defaults to "output.bin".
        #[arg(short, long)]
        output: Option<String>,

        /// The number of concurrent download threads to use.
        #[arg(short = 't', long)]
        threads: Option<u8>,

        /// An optional SHA-256 hash to verify file integrity after download.
        #[arg(long)]
        verify_sha256: Option<String>,

        /// A rate limit in bytes per second (e.g., 1048576 for 1MB/s).
        #[arg(long)]
        rate_limit: Option<u32>,

        /// The directory to save the file in. Defaults to the current directory.
        #[arg(short = 'd', long)]
        dir: Option<String>,

        /// File containing a list of URLs to download (one per line).
        #[arg(short = 'i', long)]
        input: Option<String>,

        /// Max number of files to download concurrently (Batch mode only).
        #[arg(short = 'c', long)]
        concurrent_files: Option<usize>,
    },
}