#http #http-request #buffer #reader

http-range-client

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

4 releases

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

#88 in HTTP client

Download history 20/week @ 2023-12-10 59/week @ 2023-12-17 16/week @ 2023-12-24 15/week @ 2024-01-07 36/week @ 2024-01-14 9/week @ 2024-01-21 24/week @ 2024-01-28 25/week @ 2024-02-04 65/week @ 2024-02-11 32/week @ 2024-02-18 76/week @ 2024-02-25 45/week @ 2024-03-03 65/week @ 2024-03-10 253/week @ 2024-03-17 120/week @ 2024-03-24

487 downloads per month
Used in 4 crates

MIT/Apache

34KB
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): Supports native and Wasm target

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

Dependencies

~0.6–16MB
~211K SLoC