better-fetch 0.5.0

Typed HTTP client layer on top of reqwest — inspired by @better-fetch/fetch
Documentation 
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

use ::reqwest::Client;
use futures_util::StreamExt;

use super::{HttpBody, HttpRequest, HttpResponse, HttpStreamingResponse};
use crate::error::map_transport_error;
use crate::streaming::BodyStream;
use crate::Result;

/// Builds a reqwest request. `HttpRequest::cancellation` is not wired into reqwest; cancellation
/// is cooperative via [`crate::cancel::execute_or_cancel`] around backend calls and
/// [`crate::streaming::wrap_cancellation`] on response body streams.
fn configure_reqwest_builder(client: &Client, request: HttpRequest) -> reqwest::RequestBuilder {
    let HttpRequest {
        method,
        url,
        headers,
        body,
        timeout,
        cancellation: _,
        #[cfg(feature = "multipart")]
        multipart,
    } = request;

    let mut builder = client.request(method, url).headers(headers);

    if let Some(timeout) = timeout {
        builder = builder.timeout(timeout);
    }

    #[cfg(feature = "multipart")]
    if let Some(form) = multipart {
        return builder.multipart(form);
    }

    match body {
        HttpBody::Empty => {}
        HttpBody::Bytes(body) => {
            builder = builder.body(body);
        }
        HttpBody::Stream(stream) => {
            let stream = stream.map(|result| result.map_err(std::io::Error::other));
            builder = builder.body(reqwest::Body::wrap_stream(stream));
        }
    }

    builder
}

/// Shared reqwest execution path used by [`super::ReqwestBackend`] and [`crate::tower::ReqwestHttpService`].
///
/// Always buffers the full response body into memory via `response.bytes().await`.
pub(crate) async fn send_reqwest(client: &Client, request: HttpRequest) -> Result<HttpResponse> {
    let response = configure_reqwest_builder(client, request)
        .send()
        .await
        .map_err(map_transport_error)?;
    let status = response.status();
    let headers = response.headers().clone();
    let body = response.bytes().await.map_err(map_transport_error)?;

    Ok(HttpResponse {
        status,
        headers,
        body,
    })
}

/// Shared reqwest streaming path: status and headers are immediate; the body is a byte stream.
pub(crate) async fn send_reqwest_stream(
    client: &Client,
    request: HttpRequest,
) -> Result<HttpStreamingResponse> {
    let response = configure_reqwest_builder(client, request)
        .send()
        .await
        .map_err(map_transport_error)?;
    let status = response.status();
    let headers = response.headers().clone();
    let body: BodyStream = Box::pin(
        response
            .bytes_stream()
            .map(|chunk| chunk.map_err(map_transport_error)),
    );

    Ok(HttpStreamingResponse {
        status,
        headers,
        body,
    })
}