aria2-core 0.2.2

High-performance download engine core: multi-protocol segmented downloads, rate limiting, config management, session persistence, and BitTorrent seeding
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90

use thiserror::Error;

#[derive(Error, Debug, Clone, PartialEq)]
pub enum Aria2Error {
    #[error("Network error: {0}")]
    Network(String),

    #[error("IO error: {0}")]
    Io(String),

    #[error("Parse error: {0}")]
    Parse(String),

    #[error("Checksum failed: {0}")]
    Checksum(String),

    #[error("Download failed: {0}")]
    DownloadFailed(String),

    #[error("Recoverable error: {0}")]
    Recoverable(#[from] RecoverableError),

    #[error("Fatal error: {0}")]
    Fatal(#[from] FatalError),
}

impl From<serde_json::Error> for Aria2Error {
    fn from(err: serde_json::Error) -> Self {
        Aria2Error::Parse(err.to_string())
    }
}

impl From<std::io::Error> for Aria2Error {
    fn from(err: std::io::Error) -> Self {
        Aria2Error::Io(err.to_string())
    }
}

impl From<std::string::FromUtf8Error> for Aria2Error {
    fn from(err: std::string::FromUtf8Error) -> Self {
        Aria2Error::Parse(err.to_string())
    }
}

impl From<base64::DecodeError> for Aria2Error {
    fn from(err: base64::DecodeError) -> Self {
        Aria2Error::Parse(err.to_string())
    }
}

#[derive(Error, Debug, Clone, PartialEq)]
pub enum RecoverableError {
    #[error("Connection timeout")]
    Timeout,

    #[error("Server returned error: {code}")]
    ServerError { code: u16 },

    #[error("Range not satisfiable: {range}")]
    RangeNotSatisfiable { range: String },

    #[error("Temporary network failure: {message}")]
    TemporaryNetworkFailure { message: String },

    #[error("Max retries reached: {attempts} attempts")]
    MaxTriesReached { attempts: u32 },

    #[error("Invalid piece index: {index} (max: {max_index})")]
    InvalidPieceIndex { index: u32, max_index: u32 },
}

#[derive(Error, Debug, Clone, PartialEq)]
pub enum FatalError {
    #[error("Configuration error: {0}")]
    Config(String),

    #[error("Insufficient disk space")]
    DiskSpaceExhausted,

    #[error("Permission denied: {path}")]
    PermissionDenied { path: String },

    #[error("File not found: {path}")]
    FileNotFound { path: String },

    #[error("Unsupported protocol: {protocol}")]
    UnsupportedProtocol { protocol: String },
}

pub type Result<T> = std::result::Result<T, Aria2Error>;