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
use thiserror::Error;
/// Errors that can occur during caching.
#[derive(Error, Debug)]
pub enum Error {
/// Arises when the resource looks like a local file but it doesn't exist.
#[error("Treated resource as local file, but file does not exist ({0})")]
ResourceNotFound(String),
/// Arises when the resource looks like a URL, but is invalid.
#[error("Unable to parse resource URL ({0})")]
InvalidUrl(String),
/// Arises when the cache is being used in offline mode, but it couldn't locate
/// any cached versions of a remote resource.
#[error("Offline mode is enabled but no cached versions of resouce exist ({0})")]
NoCachedVersions(String),
/// Arises when the cache is corrupted for some reason.
///
/// If this error occurs, it is almost certainly the result of an external process
/// "messing" with the cache directory, since `cached-path` takes great care
/// to avoid accidental corruption on its own.
#[error("Cache is corrupted ({0})")]
CacheCorrupted(String),
/// Arises when a resource is treated as archive, but the extraction process fails.
#[error("Extracting archive failed ({0})")]
ExtractionError(String),
/// Any IO error that could arise while attempting to cache a remote resource.
#[error("An IO error occurred")]
IoError(#[from] std::io::Error),
/// An HTTP error that could occur while attempting to fetch a remote resource.
#[error(transparent)]
HttpError(#[from] reqwest::Error),
/// Raise when configuration options are invalid.
#[error("Configuration error ({0})")]
ConfigurationError(String),
}
impl Error {
pub(crate) fn is_retriable(&self) -> bool {
match self {
Error::HttpError(source) => {
if source.is_status() {
matches!(
source.status().map(|status| status.as_u16()),
Some(502) | Some(503) | Some(504)
)
} else {
source.is_timeout()
}
}
_ => false,
}
}
pub fn status_code(&self) -> Option<u16> {
if let Error::HttpError(inner) = self {
Some(inner.status().unwrap().as_u16())
} else {
None
}
}
}