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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
use actix_web::{
body::{BoxBody, MessageBody},
dev::{ResponseHead, Service, ServiceRequest, ServiceResponse},
http::{header, StatusCode},
HttpRequest, HttpResponse, ResponseError,
};
use futures::prelude::*;
use std::str::FromStr;
use thiserror::Error;
use crate::{renderer::render_error, MiniserveConfig};
#[derive(Debug, Error)]
pub enum StartupError {
/// Any kind of IO errors
#[error("{0}\ncaused by: {1}")]
IoError(String, std::io::Error),
/// In case miniserve was invoked without an interactive terminal and without an explicit path
#[error("Refusing to start as no explicit serve path was set and no interactive terminal was attached
Please set an explicit serve path like: `miniserve /my/path`")]
NoExplicitPathAndNoTerminal,
/// In case miniserve was invoked with --no-symlinks but the serve path is a symlink
#[error("The -P|--no-symlinks option was provided but the serve path '{0}' is a symlink")]
NoSymlinksOptionWithSymlinkServePath(String),
#[error("The --enable-webdav option was provided, but the serve path '{0}' is a file")]
WebdavWithFileServePath(String),
}
#[derive(Debug, Error)]
pub enum RuntimeError {
/// Any kind of IO errors
#[error("{0}\ncaused by: {1}")]
IoError(String, std::io::Error),
/// Might occur during file upload, when processing the multipart request fails
#[error("Failed to process multipart request\ncaused by: {0}")]
MultipartError(String),
/// Might occur during file upload
#[error("File already exists, and the overwrite_files option has not been set")]
DuplicateFileError,
/// Upload not allowed
#[error("Upload not allowed to this directory")]
UploadForbiddenError,
/// Any error related to an invalid path (failed to retrieve entry name, unexpected entry type, etc)
#[error("Invalid path\ncaused by: {0}")]
InvalidPathError(String),
/// Might occur if the user has insufficient permissions to create an entry in a given directory
#[error("Insufficient permissions to create file in {0}")]
InsufficientPermissionsError(String),
/// Any error related to parsing
#[error("Failed to parse {0}\ncaused by: {1}")]
ParseError(String, String),
/// Might occur when the creation of an archive fails
#[error("An error occurred while creating the {0}\ncaused by: {1}")]
ArchiveCreationError(String, Box<RuntimeError>),
/// More specific archive creation failure reason
#[error("{0}")]
ArchiveCreationDetailError(String),
/// Might occur when the HTTP credentials are not correct
#[error("Invalid credentials for HTTP authentication")]
InvalidHttpCredentials,
/// Might occur when an HTTP request is invalid
#[error("Invalid HTTP request\ncaused by: {0}")]
InvalidHttpRequestError(String),
/// Might occur when trying to access a page that does not exist
#[error("Route {0} could not be found")]
RouteNotFoundError(String),
}
impl ResponseError for RuntimeError {
fn status_code(&self) -> StatusCode {
use RuntimeError as E;
use StatusCode as S;
match self {
E::IoError(_, _) => S::INTERNAL_SERVER_ERROR,
E::MultipartError(_) => S::BAD_REQUEST,
E::DuplicateFileError => S::CONFLICT,
E::UploadForbiddenError => S::FORBIDDEN,
E::InvalidPathError(_) => S::BAD_REQUEST,
E::InsufficientPermissionsError(_) => S::FORBIDDEN,
E::ParseError(_, _) => S::BAD_REQUEST,
E::ArchiveCreationError(_, err) => err.status_code(),
E::ArchiveCreationDetailError(_) => S::INTERNAL_SERVER_ERROR,
E::InvalidHttpCredentials => S::UNAUTHORIZED,
E::InvalidHttpRequestError(_) => S::BAD_REQUEST,
E::RouteNotFoundError(_) => S::NOT_FOUND,
}
}
fn error_response(&self) -> HttpResponse {
log_error_chain(self.to_string());
let mut resp = HttpResponse::build(self.status_code());
if let Self::InvalidHttpCredentials = self {
resp.append_header((
header::WWW_AUTHENTICATE,
header::HeaderValue::from_static("Basic realm=\"miniserve\""),
));
}
resp.content_type(mime::TEXT_PLAIN_UTF_8)
.body(self.to_string())
}
}
/// Middleware to convert plain-text error responses to user-friendly web pages
pub fn error_page_middleware<S, B>(
req: ServiceRequest,
srv: &S,
) -> impl Future<Output = actix_web::Result<ServiceResponse>> + 'static
where
S: Service<ServiceRequest, Response = ServiceResponse<B>, Error = actix_web::Error>,
B: MessageBody + 'static,
S::Future: 'static,
{
let fut = srv.call(req);
async {
let res = fut.await?.map_into_boxed_body();
if (res.status().is_client_error() || res.status().is_server_error())
&& res
.headers()
.get(header::CONTENT_TYPE)
.map(AsRef::as_ref)
.and_then(|s| std::str::from_utf8(s).ok())
.and_then(|s| mime::Mime::from_str(s).ok())
.as_ref()
.map(mime::Mime::essence_str)
== Some(mime::TEXT_PLAIN.as_ref())
{
let req = res.request().clone();
Ok(res.map_body(|head, body| map_error_page(&req, head, body)))
} else {
Ok(res)
}
}
}
fn map_error_page(req: &HttpRequest, head: &mut ResponseHead, body: BoxBody) -> BoxBody {
let error_msg = match body.try_into_bytes() {
Ok(bytes) => bytes,
Err(body) => return body,
};
let error_msg = match std::str::from_utf8(&error_msg) {
Ok(msg) => msg,
_ => return BoxBody::new(error_msg),
};
let conf = req.app_data::<MiniserveConfig>().unwrap();
let return_address = req
.headers()
.get(header::REFERER)
.and_then(|h| h.to_str().ok())
.unwrap_or("/");
head.headers.insert(
header::CONTENT_TYPE,
mime::TEXT_HTML_UTF_8.essence_str().try_into().unwrap(),
);
BoxBody::new(render_error(error_msg, head.status, conf, return_address).into_string())
}
pub fn log_error_chain(description: String) {
for cause in description.lines() {
log::error!("{}", cause);
}
}
|
