Struct HttpClient 

pub struct HttpClient { /* private fields */ }

Authenticated HTTP client for CLI command implementations.

The client covers the transport behavior command authors usually need: auth injection, JSON request/response helpers, structured HTTP errors, idempotent retries, ETag helpers, raw streaming helpers, multipart helpers, and GraphQL envelope decoding.

Implementations

impl HttpClient

pub fn builder( base_url: impl Into<String>, auth: Arc<dyn AuthInjector>, ) -> HttpClientBuilder

Creates a client builder.

pub fn new(base_url: impl Into<String>, auth: Arc<dyn AuthInjector>) -> Self

Creates a client with default settings.

pub async fn get<T: Default + DeserializeOwned>(&self, path: &str) -> Result<T>

Sends GET and decodes a JSON response.

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

Sends GET and checks only for success.

pub async fn post<B: Serialize, T: Default + DeserializeOwned>( &self, path: &str, body: &B, ) -> Result<T>

Sends POST with a JSON body and decodes a JSON response.

pub async fn post_without_response<B: Serialize>( &self, path: &str, body: &B, ) -> Result<()>

Sends POST with a JSON body and checks only for success.

pub async fn put<B: Serialize, T: Default + DeserializeOwned>( &self, path: &str, body: &B, ) -> Result<T>

Sends PUT with a JSON body and decodes a JSON response.

pub async fn put_without_response<B: Serialize>( &self, path: &str, body: &B, ) -> Result<()>

Sends PUT with a JSON body and checks only for success.

pub async fn patch<B: Serialize, T: Default + DeserializeOwned>( &self, path: &str, body: &B, ) -> Result<T>

Sends PATCH with a JSON body and decodes a JSON response.

pub async fn patch_without_response<B: Serialize>( &self, path: &str, body: &B, ) -> Result<()>

Sends PATCH with a JSON body and checks only for success.

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

Sends DELETE and checks for success.

pub async fn delete_with_body<B: Serialize>( &self, path: &str, body: &B, ) -> Result<()>

Sends DELETE with a JSON body and checks for success.

pub async fn get_etag<T: Default + DeserializeOwned>( &self, path: &str, ) -> Result<(T, String)>

Sends GET and returns decoded JSON plus the ETag header.

pub async fn get_etag_without_response(&self, path: &str) -> Result<String>

Sends GET and returns only the ETag header after checking success.

pub async fn put_if_match<B: Serialize, T: Default + DeserializeOwned>( &self, path: &str, body: &B, etag: &str, ) -> Result<T>

Sends PUT with If-Match and decodes a JSON response.

pub async fn put_if_match_without_response<B: Serialize>( &self, path: &str, body: &B, etag: &str, ) -> Result<()>

Sends PUT with If-Match and checks only for success.

pub async fn get_raw(&self, path: &str, writer: &mut dyn Write) -> Result<()>

Streams a raw GET response body into a writer.

pub async fn get_bytes(&self, path: &str) -> Result<Vec<u8>>

Sends GET and returns the raw response body as bytes.

pub async fn post_raw<B: Serialize>( &self, path: &str, body: Option<&B>, writer: &mut dyn Write, ) -> Result<()>

Sends POST and streams the raw response body into a writer.

pub async fn do_raw<T: Default + DeserializeOwned>( &self, method: Method, path: &str, content_type: &str, body: impl Into<Vec<u8>>, ) -> Result<T>

Sends a raw-body request and decodes a JSON response.

pub async fn do_raw_optional_body<T: Default + DeserializeOwned>( &self, method: Method, path: &str, content_type: &str, body: Option<Vec<u8>>, ) -> Result<T>

Sends an optional raw-body request and decodes a JSON response.

pub async fn do_raw_without_response( &self, method: Method, path: &str, content_type: &str, body: impl Into<Vec<u8>>, ) -> Result<()>

Sends a raw-body request and checks only for success.

pub async fn do_raw_optional_body_without_response( &self, method: Method, path: &str, content_type: &str, body: Option<Vec<u8>>, ) -> Result<()>

Sends an optional raw-body request and checks only for success.

pub async fn post_multipart<T: Default + DeserializeOwned>( &self, path: &str, field_name: &str, file_path: &Path, ) -> Result<T>

Sends a multipart file upload and decodes a JSON response.

pub async fn post_multipart_without_response( &self, path: &str, field_name: &str, file_path: &Path, ) -> Result<()>

Sends a multipart file upload and checks only for success.

pub async fn post_multipart_with_fields<T: Default + DeserializeOwned>( &self, path: &str, file_field: &str, file_path: &Path, fields: &BTreeMap<String, String>, ) -> Result<T>

Sends a multipart file upload with fields and decodes a JSON response.

pub async fn post_multipart_with_fields_without_response( &self, path: &str, file_field: &str, file_path: &Path, fields: &BTreeMap<String, String>, ) -> Result<()>

Sends a multipart file upload with fields and checks only for success.

pub async fn post_multipart_fields<T: Default + DeserializeOwned>( &self, path: &str, fields: &BTreeMap<String, String>, ) -> Result<T>

Sends multipart form fields without a file and decodes a JSON response.

pub async fn post_multipart_fields_without_response( &self, path: &str, fields: &BTreeMap<String, String>, ) -> Result<()>

Sends multipart form fields without a file and checks only for success.

pub async fn post_graphql<T: DeserializeOwned + Default>( &self, path: &str, query: &str, variables: BTreeMap<String, Value>, ) -> Result<T>

Sends a GraphQL request and decodes the data envelope into a value.

pub async fn post_graphql_optional_variables<T: DeserializeOwned + Default>( &self, path: &str, query: &str, variables: Option<BTreeMap<String, Value>>, ) -> Result<T>

Sends a GraphQL request with optional variables and decodes data.

pub async fn post_graphql_without_response( &self, path: &str, query: &str, variables: BTreeMap<String, Value>, ) -> Result<()>

Sends a GraphQL request and checks only for GraphQL/HTTP success.

pub async fn post_graphql_optional_variables_without_response( &self, path: &str, query: &str, variables: Option<BTreeMap<String, Value>>, ) -> Result<()>

Sends a GraphQL request with optional variables and checks only for success.

pub async fn post_graphql_into<T: DeserializeOwned>( &self, path: &str, query: &str, variables: BTreeMap<String, Value>, result: &mut T, ) -> Result<()>

Sends a GraphQL request and decodes data into an existing value.

pub async fn post_graphql_optional_variables_into<T: DeserializeOwned>( &self, path: &str, query: &str, variables: Option<BTreeMap<String, Value>>, result: &mut T, ) -> Result<()>

Sends a GraphQL request with optional variables and decodes into an existing value.

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.