#http-request

http-range-client

HTTP client for HTTP Range requests with a buffer optimized for sequential requests

5 unstable releases

0.8.0 Aug 12, 2024
0.7.2 Sep 10, 2023
0.7.1 Sep 2, 2023
0.7.0 Aug 31, 2023
0.6.0 Nov 10, 2021

#200 in HTTP client

Download history 69/week @ 2024-07-08 102/week @ 2024-07-15 81/week @ 2024-07-22 101/week @ 2024-07-29 152/week @ 2024-08-05 361/week @ 2024-08-12 189/week @ 2024-08-19 139/week @ 2024-08-26 487/week @ 2024-09-02 272/week @ 2024-09-09 151/week @ 2024-09-16 119/week @ 2024-09-23 62/week @ 2024-09-30 52/week @ 2024-10-07 78/week @ 2024-10-14 37/week @ 2024-10-21

237 downloads per month
Used in 4 crates

MIT/Apache

35KB
647 lines

http-range-client

CI build crates.io version docs.rs docs

HTTP client for HTTP Range requests with a buffer optimized for sequential reading.

Implements Seek+Read for blocking clients, which makes it a drop-in replacement for local files.

Usage examples

use http_range_client::*;

let mut client = BufferedHttpRangeClient::new("https://flatgeobuf.org/test/data/countries.fgb");
let bytes = client.min_req_size(256).get_range(0, 3).await?;
assert_eq!(bytes, b"fgb");
let version = client.get_bytes(1).await?; // From buffer - no HTTP request!
assert_eq!(version, [3]);

let mut reader = HttpReader::new("https://www.rust-lang.org/static/images/favicon-32x32.png");
reader.seek(SeekFrom::Start(1)).ok();
let mut bytes = [0; 3];
reader.read_exact(&mut bytes)?;
assert_eq!(&bytes, b"PNG");

Supported HTTP clients (feature flag)

  • reqwest async (reqwest-async, default)
  • reqwest blocking (reqwest-sync, default): Not supported on Wasm target
  • ureq blocking (ureq-sync): Not supported on Wasm target

Other clients can be used via the AsyncBufferedHttpRangeClient resp. SyncBufferedHttpRangeClient adapter, after implementing the AsyncHttpRangeClient resp. SyncHttpRangeClient trait.

Dependencies

~0.5–13MB
~176K SLoC