Skip to main content

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    /// Error from `http-content-range`
36    #[error("invalid Content-Range header: {0}")]
37    ContentRangeParser(String),
38
39    /// The server returned an invalid range response
40    #[error(
41        "request and response range mismatch, \
42        expected {expected_start}-{expected_end_inclusive}/{expected_complete_length}, \
43        got {actual_start}-{actual_end_inclusive}/{actual_complete_length}"
44    )]
45    RangeMismatch {
46        expected_start: u64,
47        expected_end_inclusive: u64,
48        expected_complete_length: usize,
49        actual_start: u64,
50        actual_end_inclusive: u64,
51        actual_complete_length: u64,
52    },
53
54    /// The server returned more bytes than the range request asked for
55    #[error("range response returned more than the expected {expected} bytes")]
56    ResponseTooLong { expected: u64 },
57
58    /// The server returned fewer bytes than the range request asked for
59    #[error("expected {expected} bytes from range response, got {actual}")]
60    ResponseTooShort { expected: u64, actual: u64 },
61}
62
63impl From<std::io::Error> for AsyncHttpRangeReaderError {
64    fn from(err: std::io::Error) -> Self {
65        AsyncHttpRangeReaderError::IoError(Arc::new(err))
66    }
67}
68
69impl From<reqwest_middleware::Error> for AsyncHttpRangeReaderError {
70    fn from(err: reqwest_middleware::Error) -> Self {
71        AsyncHttpRangeReaderError::TransportError(Arc::new(err))
72    }
73}
74
75impl From<reqwest::Error> for AsyncHttpRangeReaderError {
76    fn from(err: reqwest::Error) -> Self {
77        AsyncHttpRangeReaderError::TransportError(Arc::new(err.into()))
78    }
79}