Struct RequestFactory 

pub struct RequestFactory { /* private fields */ }

Implementations

impl RequestFactory

pub fn new(base_url: impl AsRef<str>) -> Result<Self, HttpError>

Creates a request factory rooted at base_url.

The factory starts without authentication and sends JSON-oriented Accept and XBP User-Agent headers on every request.

pub fn with_auth(self, auth: AuthStrategy) -> Self

Returns a copy of this factory configured with the selected authentication strategy.

pub fn with_default_header(self, name: HeaderName, value: HeaderValue) -> Self

Returns a copy of this factory with an additional default request header.

pub async fn get_json<T, Q>( &self, path: &str, query: Option<&Q>, ) -> Result<T, HttpError>

where T: DeserializeOwned, Q: Serialize + ?Sized,

Sends a GET request and deserializes its JSON response into T.

pub async fn delete_json<T, Q>( &self, path: &str, query: Option<&Q>, ) -> Result<T, HttpError>

where T: DeserializeOwned, Q: Serialize + ?Sized,

Sends a DELETE request and deserializes its JSON response into T.

pub async fn delete_json_with_body<T, Q, B>( &self, path: &str, query: Option<&Q>, body: &B, ) -> Result<T, HttpError>

where T: DeserializeOwned, Q: Serialize + ?Sized, B: Serialize + ?Sized,

Sends a DELETE request with an optional query and JSON body.

pub async fn post_json<T, B>( &self, path: &str, body: &B, ) -> Result<T, HttpError>

where T: DeserializeOwned, B: Serialize + ?Sized,

Sends a POST request with a JSON body and deserializes its response.

pub async fn put_json<T, B>(&self, path: &str, body: &B) -> Result<T, HttpError>

where T: DeserializeOwned, B: Serialize + ?Sized,

Sends a PUT request with a JSON body and deserializes its response.

pub async fn put_multipart_json<T>( &self, path: &str, form: Form, ) -> Result<T, HttpError>

where T: DeserializeOwned,

Sends a multipart PUT request and deserializes its JSON response.

pub async fn post_multipart_json<T>( &self, path: &str, form: Form, ) -> Result<T, HttpError>

where T: DeserializeOwned,

Sends a multipart POST request and deserializes its JSON response.

pub async fn patch_json<T, B>( &self, path: &str, body: &B, ) -> Result<T, HttpError>

where T: DeserializeOwned, B: Serialize + ?Sized,

Sends a PATCH request with a JSON body and deserializes its response.

pub async fn post_bytes( &self, path: &str, bytes: Vec<u8>, content_type: &'static str, ) -> Result<ResponseBytes, HttpError>

Sends raw bytes in a POST request and returns the response body unchanged.

pub async fn get_bytes<Q>( &self, path: &str, query: Option<&Q>, ) -> Result<ResponseBytes, HttpError>

where Q: Serialize + ?Sized,

Sends a GET request and returns the response content type and raw bytes.

Trait Implementations

impl Clone for RequestFactory

fn clone(&self) -> RequestFactory

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestFactory

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

Formats the value using the given formatter.