Struct Request 

pub struct Request {
    pub method: String,
    pub url: String,
    pub headers: Vec<(String, String)>,
    pub body: Vec<u8>,
    pub timeout_ms: u32,
    pub max_body: usize,
}

A request. Build it with Request::get, Request::post or Request::new, then Request::send it.

Fields

method: String

url: String

headers: Vec<(String, String)>

body: Vec<u8>

timeout_ms: u32

The whole exchange: connecting, the response’s headers and its body.

max_body: usize

A body longer than this is refused with Error::Invalid (its Content-Length before anything is read, or as it streams in).

Implementations

impl Request

pub fn new(method: &str, url: &str) -> Self

method (GET, POST, PATCH, …) to url (https://host/path?query).

pub fn get(url: &str) -> Self

pub fn post(url: &str) -> Self

pub fn header(self, name: &str, value: &str) -> Self

Adds a request header (Authorization, Accept, …).

pub fn body(self, body: impl Into<Vec<u8>>) -> Self

pub fn json<T: Serialize + ?Sized>(self, value: &T) -> Result<Self>

A JSON body and its Content-Type.

pub fn timeout_ms(self, timeout_ms: u32) -> Self

The whole exchange may take timeout_ms; past it the request fails with Error::Unavailable("timeout").

pub fn max_body(self, bytes: usize) -> Self

Reads at most bytes of body; a longer one fails with Error::Invalid.

pub async fn send(self) -> Result<Response>

Sends the request and reads the response on the daemon executor.

Trait Implementations

impl Clone for Request

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Request

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

Formats the value using the given formatter.

impl Eq for Request

impl PartialEq for Request

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Request