Struct HttpClient

pub struct HttpClient { /* private fields */ }

HTTP client for TACT protocol

Implementations

impl HttpClient

pub fn new(region: Region, version: ProtocolVersion) -> Result<Self>

Create a new HTTP client for the specified region and protocol version

pub fn with_client( client: Client, region: Region, version: ProtocolVersion, ) -> Self

Create a new HTTP client with custom reqwest client

pub fn with_max_retries(self, max_retries: u32) -> Self

Set the maximum number of retries for failed requests

Default is 0 (no retries) to maintain backward compatibility. Only network and connection errors are retried, not parsing errors.

pub fn with_initial_backoff_ms(self, initial_backoff_ms: u64) -> Self

Set the initial backoff duration in milliseconds

Default is 100ms. This is the base delay before the first retry.

pub fn with_max_backoff_ms(self, max_backoff_ms: u64) -> Self

Set the maximum backoff duration in milliseconds

Default is 10,000ms (10 seconds). Backoff will not exceed this value.

pub fn with_backoff_multiplier(self, backoff_multiplier: f64) -> Self

Set the backoff multiplier

Default is 2.0. The backoff duration is multiplied by this value after each retry.

pub fn with_jitter_factor(self, jitter_factor: f64) -> Self

Set the jitter factor (0.0 to 1.0)

Default is 0.1 (10% jitter). Adds randomness to prevent thundering herd.

pub fn with_user_agent(self, user_agent: impl Into<String>) -> Self

Set a custom user agent string

If not set, reqwest’s default user agent will be used.

pub fn base_url(&self) -> String

Get the base URL for the current configuration

pub fn region(&self) -> Region

Get the current region

pub fn version(&self) -> ProtocolVersion

Get the current protocol version

pub fn set_region(&mut self, region: Region)

Set the region

pub async fn get_versions(&self, product: &str) -> Result<Response>

Get versions manifest for a product (V1 protocol)

pub async fn get_cdns(&self, product: &str) -> Result<Response>

Get CDN configuration for a product (V1 protocol)

pub async fn get_bgdl(&self, product: &str) -> Result<Response>

Get BGDL manifest for a product (V1 protocol)

pub async fn get_summary(&self) -> Result<Response>

Get product summary (V2 protocol)

pub async fn get_product(&self, product: &str) -> Result<Response>

Get product details (V2 protocol)

pub async fn get(&self, path: &str) -> Result<Response>

Make a raw GET request to a path

pub async fn download_file( &self, cdn_host: &str, path: &str, hash: &str, ) -> Result<Response>

Download a file from CDN

pub async fn get_versions_parsed( &self, product: &str, ) -> Result<Vec<VersionEntry>>

Get parsed versions manifest for a product

pub async fn get_cdns_parsed(&self, product: &str) -> Result<Vec<CdnEntry>>

Get parsed CDN manifest for a product

pub async fn get_bgdl_parsed(&self, product: &str) -> Result<Vec<BgdlEntry>>

Get parsed BGDL manifest for a product

Trait Implementations

impl Clone for HttpClient

fn clone(&self) -> HttpClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpClient

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HttpClient

fn default() -> Self

Returns the “default value” for a type.