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
// Copyright 2019-2024 ChainSafe Systems
// SPDX-License-Identifier: Apache-2.0, MIT
// Copyright 2018-2020 Alec Mocatta
// SPDX-License-Identifier: Apache-2.0, MIT
//! Wrapper that uses the `Range` HTTP header to resume get requests.
//!
//! Most of the code can be attributed to `Alec Mocatta` and comes from the crate
//! <https://crates.io/crates/reqwest_resume/>
//! Some modifications have been done to update the code regarding `tokio`,
//! replace the `hyperx` dependency with `hyper` and add two unit tests.
use crate::utils::net::global_http_client;
use bytes::Bytes;
use futures::{ready, FutureExt as _, Stream, TryFutureExt as _};
use std::{
pin::Pin,
task::{Context, Poll},
time::Duration,
};
use tokio::time::sleep;
/// A `Client` to make Requests with.
///
/// See [`reqwest::Client`].
#[derive(Debug)]
pub struct Client(reqwest::Client);
impl Client {
/// Constructs a new `Client` using the global Forest HTTP client.
pub fn new() -> Self {
Self(global_http_client())
}
/// Convenience method to make a `GET` request to a URL.
///
/// See [`reqwest::Client::get()`].
pub fn get(&self, url: reqwest::Url) -> RequestBuilder {
RequestBuilder(self.0.clone(), reqwest::Method::GET, url)
}
}
/// A builder to construct the properties of a Request.
///
/// See [`reqwest::RequestBuilder`].
#[derive(Debug)]
pub struct RequestBuilder(reqwest::Client, reqwest::Method, reqwest::Url);
impl RequestBuilder {
/// Constructs the Request and sends it the target URL, returning a Response.
///
/// See [`reqwest::RequestBuilder::send()`].
pub async fn send(self) -> reqwest::Result<Response> {
let RequestBuilder(client, method, url) = self;
let response = loop {
let builder = client.request(method.clone(), url.clone());
match builder.send().await {
Err(err) if !err.is_builder() && !err.is_redirect() && !err.is_status() => {
sleep(Duration::from_secs(1)).await
}
x => break x?,
}
};
let accept_byte_ranges = response
.headers()
.get(http::header::ACCEPT_RANGES)
.map(http::HeaderValue::as_bytes)
== Some(b"bytes");
let resp = Response {
client,
method,
url,
response,
accept_byte_ranges,
pos: 0,
};
Ok(resp)
}
}
/// A Response to a submitted Request.
///
/// See [`reqwest::Response`].
#[derive(Debug)]
pub struct Response {
client: reqwest::Client,
method: reqwest::Method,
url: reqwest::Url,
response: reqwest::Response,
accept_byte_ranges: bool,
pos: u64,
}
impl Response {
/// Convert the response into a `Stream` of `Bytes` from the body.
///
/// See [`reqwest::Response::bytes_stream()`].
pub fn bytes_stream(self) -> impl Stream<Item = reqwest::Result<Bytes>> + Send {
Decoder {
client: self.client,
method: self.method,
url: self.url,
decoder: Box::pin(self.response.bytes_stream()),
accept_byte_ranges: self.accept_byte_ranges,
pos: self.pos,
}
}
pub fn response(&self) -> &reqwest::Response {
&self.response
}
}
struct Decoder {
client: reqwest::Client,
method: reqwest::Method,
url: reqwest::Url,
decoder: Pin<Box<dyn Stream<Item = reqwest::Result<Bytes>> + Send>>,
accept_byte_ranges: bool,
pos: u64,
}
impl Stream for Decoder {
type Item = reqwest::Result<Bytes>;
fn poll_next(mut self: Pin<&mut Self>, cx: &mut Context) -> Poll<Option<Self::Item>> {
loop {
match ready!(self.decoder.as_mut().poll_next(cx)) {
Some(Err(err)) => {
if !self.accept_byte_ranges {
break Poll::Ready(Some(Err(err)));
}
let builder = self.client.request(self.method.clone(), self.url.clone());
let mut headers = http::HeaderMap::new();
let value = http::HeaderValue::from_str(&std::format!("bytes={}-", self.pos))
.expect("unreachable");
headers.insert(http::header::RANGE, value);
let builder = builder.headers(headers);
// https://developer.mozilla.org/en-US/docs/Web/HTTP/Range_requests
self.decoder = Box::pin(
sleep(Duration::from_secs(1))
.then(|()| builder.send())
.map_ok(reqwest::Response::bytes_stream)
.try_flatten_stream(),
);
}
Some(Ok(n)) => {
self.pos += n.len() as u64;
break Poll::Ready(Some(Ok(n)));
}
None => break Poll::Ready(None),
}
}
}
}
/// Shortcut method to quickly make a GET request.
///
/// See [`reqwest::get`].
pub async fn get(url: reqwest::Url) -> reqwest::Result<Response> {
Client::new().get(url).send().await
}
#[cfg(test)]
mod tests;