async_http_range_reader/
error.rs

1use std::sync::Arc;
2
3/// Error type used for [`crate::AsyncHttpRangeReader`]
4#[derive(Clone, Debug, thiserror::Error)]
5#[non_exhaustive]
6pub enum AsyncHttpRangeReaderError {
7    /// The server does not support range requests
8    #[error("range requests are not supported")]
9    HttpRangeRequestUnsupported,
10
11    /// Other HTTP error
12    #[error(transparent)]
13    HttpError(#[from] Arc<reqwest_middleware::Error>),
14
15    /// An error occurred during transport
16    #[error("an error occurred during transport: {0}")]
17    TransportError(#[source] Arc<reqwest_middleware::Error>),
18
19    /// An IO error occurred
20    #[error("io error occurred: {0}")]
21    IoError(#[source] Arc<std::io::Error>),
22
23    /// Content-Range header is missing from response
24    #[error("content-range header is missing from response")]
25    ContentRangeMissing,
26
27    /// Content-Length header is missing from response
28    #[error("content-length header is missing from response")]
29    ContentLengthMissing,
30
31    /// Memory mapping the file failed
32    #[error("memory mapping the file failed")]
33    MemoryMapError(#[source] Arc<std::io::Error>),
34
35    /// An internal lock was poisoned by a panic
36    #[error("memory map lock poisoned")]
37    LockPoisoned,
38
39    /// Error from `http-content-range`
40    #[error("invalid Content-Range header: {0}")]
41    ContentRangeParser(String),
42
43    /// The server returned an invalid range response
44    #[error(
45        "request and response range mismatch, \
46        expected {expected_start}-{expected_end_inclusive}/{expected_complete_length}, \
47        got {actual_start}-{actual_end_inclusive}/{actual_complete_length}"
48    )]
49    RangeMismatch {
50        expected_start: u64,
51        expected_end_inclusive: u64,
52        expected_complete_length: usize,
53        actual_start: u64,
54        actual_end_inclusive: u64,
55        actual_complete_length: u64,
56    },
57
58    /// The server returned more bytes than the range request asked for
59    #[error("range response returned more than the expected {expected} bytes")]
60    ResponseTooLong { expected: u64 },
61
62    /// The server returned fewer bytes than the range request asked for
63    #[error("expected {expected} bytes from range response, got {actual}")]
64    ResponseTooShort { expected: u64, actual: u64 },
65
66    /// The download task stopped before completing the requested range
67    #[error("range download task stopped before completing the requested range")]
68    DownloadTaskStopped,
69}
70
71impl From<std::io::Error> for AsyncHttpRangeReaderError {
72    fn from(err: std::io::Error) -> Self {
73        AsyncHttpRangeReaderError::IoError(Arc::new(err))
74    }
75}
76
77impl From<reqwest_middleware::Error> for AsyncHttpRangeReaderError {
78    fn from(err: reqwest_middleware::Error) -> Self {
79        AsyncHttpRangeReaderError::TransportError(Arc::new(err))
80    }
81}
82
83impl From<reqwest::Error> for AsyncHttpRangeReaderError {
84    fn from(err: reqwest::Error) -> Self {
85        AsyncHttpRangeReaderError::TransportError(Arc::new(err.into()))
86    }
87}
async_http_range_reader/error.rs

async_http_range_reader/
error.rs
