Struct Client 

pub struct Client {
    pub config: RequestConfig,
    pub rate_limiter: Option<Arc<RateLimiter<Ustr, MonotonicClock>>>,
    /* private fields */
}

Client for communicating with APIs through HTTP/HTTPS.

When making a HTTP request or starting a websocket connection with this client, a handler that implements RequestHandler is required.

Fields

config: RequestConfig

rate_limiter: Option<Arc<RateLimiter<Ustr, MonotonicClock>>>

Implementations

impl Client

pub async fn request<Q, B, H>( &self, method: Method, url: &str, query: Option<&Q>, body: Option<B>, handler: &H, ) -> Result<H::Successful, RequestError>

where Q: Serialize + ?Sized + Debug, H: RequestHandler<B>,

Makes an HTTP request with the given RequestHandler and returns the response.

It is recommended to use methods like get() because this method takes many type parameters and parameters.

The request is passed to handler before being sent, and the response is passed to handler before being returned. Note, that as stated in the docs for RequestBuilder::query(), parameter query only accepts a sequence of key-value pairs.

pub async fn get<Q, H>( &self, url: &str, query: &Q, handler: &H, ) -> Result<H::Successful, RequestError>

where Q: Serialize + ?Sized + Debug, H: RequestHandler<()>,

Makes an GET request with the given RequestHandler.

This method just calls request(). It requires less typing for type parameters and parameters. This method requires that handler can handle a request with a body of type (). The actual body passed will be None.

For more information, see request().

pub async fn get_no_query<H>( &self, url: &str, handler: &H, ) -> Result<H::Successful, RequestError>

where H: RequestHandler<()>,

Derivation of get().

pub async fn post<B, H>( &self, url: &str, body: B, handler: &H, ) -> Result<H::Successful, RequestError>

where H: RequestHandler<B>,

Makes an POST request with the given RequestHandler.

This method just calls request(). It requires less typing for type parameters and parameters.

For more information, see request().

pub async fn post_no_body<H>( &self, url: &str, handler: &H, ) -> Result<H::Successful, RequestError>

where H: RequestHandler<()>,

Derivation of post().

pub async fn put<B, H>( &self, url: &str, body: B, handler: &H, ) -> Result<H::Successful, RequestError>

where H: RequestHandler<B>,

Makes an PUT request with the given RequestHandler.

This method just calls request(). It requires less typing for type parameters and parameters.

For more information, see request().

pub async fn put_no_body<H>( &self, url: &str, handler: &H, ) -> Result<H::Successful, RequestError>

where H: RequestHandler<()>,

Derivation of put().

pub async fn delete<Q, H>( &self, url: &str, query: &Q, handler: &H, ) -> Result<H::Successful, RequestError>

where Q: Serialize + ?Sized + Debug, H: RequestHandler<()>,

Makes an DELETE request with the given RequestHandler.

This method just calls request(). It requires less typing for type parameters and parameters. This method requires that handler can handle a request with a body of type (). The actual body passed will be None.

For more information, see request().

pub async fn delete_no_query<H>( &self, url: &str, handler: &H, ) -> Result<H::Successful, RequestError>

where H: RequestHandler<()>,

Derivation of delete().

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.

impl Default for Client

fn default() -> Client

Returns the “default value” for a type.