Struct Client 

pub struct Client {
    client: Client,
}

Pre-configured HTTP client for making network requests.

This client should be used as the base for all HTTP requests rather than constructing raw reqwest clients. It comes with:

• TLS using webpki-roots certificates (works on Kobo devices without system cert store)
• 30 second request timeout
• User agent header set

Example

use cadmus_core::http::Client;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new()?;
    client.get("https://api.github.com").send()?;
    Ok(())
}

Fields

client: Client

Implementations

impl Client

pub fn new() -> Result<Self, HttpError>

pub fn head(&self, url: &str) -> RequestBuilder

pub fn get(&self, url: &str) -> RequestBuilder

pub fn post(&self, url: &str) -> RequestBuilder

pub fn into_reqwest(self) -> ReqwestClient

Returns the inner reqwest::blocking::Client for use with third-party libraries that require a raw client (e.g. pyroscope-rs).

pub fn download<B, F>( &self, url: &str, total_size: u64, dest: &PathBuf, request_builder: B, progress_callback: &mut F, ) -> Result<(), ChunkedDownloadError>

where B: Fn(&str) -> RequestBuilder, F: FnMut(u64, u64),

Downloads a file to dest using HTTP Range requests.

request_builder is called once per chunk (and per retry) to produce a RequestBuilder for the given URL. The caller is responsible for adding any required headers (e.g. Authorization).

progress_callback is called after each successful chunk with (bytes_downloaded_so_far, total_bytes).

Errors

Returns ChunkedDownloadError::Io if the destination file cannot be created or written. Returns ChunkedDownloadError::Request if all retry attempts for any chunk fail.

Example

use cadmus_core::http::Client;
use std::path::PathBuf;

let client = Client::new()?;
let dest = PathBuf::from("/tmp/downloaded_file");

client.download(
    "https://example.com/large-file.bin",
    1024 * 1024,
    &dest,
    |url| client.get(url),
    &mut |downloaded, total| println!("{}/{}", downloaded, total),
)?;

fn download_chunk_with_retries<B>( url: &str, start: u64, end: u64, request_builder: &B, ) -> Result<Vec<u8>, ChunkedDownloadError>

where B: Fn(&str) -> RequestBuilder,

Downloads a specific byte range with automatic exponential-backoff retry.

Errors

Returns an error if all MAX_RETRIES attempts fail.

fn download_chunk<B>( url: &str, start: u64, end: u64, request_builder: &B, ) -> Result<Vec<u8>, ChunkedDownloadError>

where B: Fn(&str) -> RequestBuilder,

Downloads a specific byte range from a URL using the HTTP Range header.

Errors

Returns an error if the request fails or the server returns a non-2xx status.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.