rws_http/error/
problem.rs

1//! RFC 9457 problem details for the errors rws itself produces (18.17.0):
2//! `application/problem+json` bodies such as
3//! `{"type":"about:blank","title":"Bad Gateway","status":502,"detail":"…"}`.
4//! `RWS_CONFIG_ERROR_FORMAT=text` keeps the plain-text bodies of earlier
5//! releases (`502 Bad Gateway`, `413 Payload Too Large: …`).
6
7use crate::response::{Response, StatusCodeReasonPhrase};
8
9/// `Content-Type` of a problem details body.
10pub const PROBLEM_JSON: &str = "application/problem+json";
11
12/// Whether rws-made errors use plain text (`error_format = "text"`).
13pub fn text_errors() -> bool {
14    crate::server_config::ServerConfig::current().error_format_text
15}
16
17/// An rws-made error: problem details, or with `error_format = "text"` the
18/// text `"<code> <reason>[: <detail>]"`.
19pub fn problem(status: &StatusCodeReasonPhrase, detail: &str) -> Response {
20    let text = if detail.is_empty() {
21        format!("{} {}", status.status_code, status.reason_phrase)
22    } else {
23        format!("{} {}: {detail}", status.status_code, status.reason_phrase)
24    };
25    problem_with_text(status, detail, &text)
26}
27
28/// [`problem`] whose text form is `text` rather than the status line.
29pub fn problem_with_text(status: &StatusCodeReasonPhrase, detail: &str, text: &str) -> Response {
30    with_headers(status, detail, text, None)
31}
32
33#[doc(hidden)]
34pub fn with_headers(status: &StatusCodeReasonPhrase, detail: &str, text: &str, headers: Option<Vec<crate::header::Header>>) -> Response {
35    let as_text = text_errors();
36    if as_text && text.is_empty() {
37        return Response::get_response(status, headers, None);
38    }
39    let (body, content_type) = body(status, detail, text, as_text);
40    let content_range = crate::range::Range::get_content_range(body, content_type.to_string());
41    Response::get_response(status, headers, Some(vec![content_range]))
42}
43
44/// The body and its content type, for writers that build the response
45/// head themselves.
46#[doc(hidden)]
47pub fn body(status: &StatusCodeReasonPhrase, detail: &str, text: &str, as_text: bool) -> (Vec<u8>, &'static str) {
48    if as_text {
49        return (text.as_bytes().to_vec(), crate::mime_type::MimeType::TEXT_PLAIN);
50    }
51    let mut json = format!(r#"{{"type":"about:blank","title":{},"status":{}"#, quote(status.reason_phrase), status.status_code);
52    if !detail.is_empty() {
53        json.push_str(r#","detail":"#);
54        json.push_str(&quote(detail));
55    }
56    json.push('}');
57    (json.into_bytes(), PROBLEM_JSON)
58}
59
60/// The body for an error whose text form is `text` (`"413 Payload Too
61/// Large: …"`): the text, or problem details with the part after the status
62/// line as `detail`.
63#[doc(hidden)]
64pub fn from_text(status: &StatusCodeReasonPhrase, text: &str) -> (Vec<u8>, &'static str) {
65    let line = format!("{} {}", status.status_code, status.reason_phrase);
66    let detail = text.strip_prefix(&line).map(|rest| rest.trim_start_matches(':').trim()).unwrap_or(text);
67    body(status, detail, text, text_errors())
68}
69
70fn quote(s: &str) -> String {
71    let mut out = String::with_capacity(s.len() + 2);
72    out.push('"');
73    for c in s.chars() {
74        match c {
75            '"' => out.push_str("\\\""),
76            '\\' => out.push_str("\\\\"),
77            '\n' => out.push_str("\\n"),
78            c if (c as u32) < 0x20 => out.push_str(&format!("\\u{:04x}", c as u32)),
79            c => out.push(c),
80        }
81    }
82    out.push('"');
83    out
84}
rws_http/error/problem.rs

rws_http/error/
problem.rs
