Struct LinoClient 

pub struct LinoClient { /* private fields */ }

A client for a service that speaks Links Notation.

Implementations

impl LinoClient

pub fn new<S: Into<String>>(base_url: S) -> Self

A client for a service at a base URL.

pub fn with_accept<S: Into<String>>(self, accept: S) -> Self

The same client asking for another representation.

pub fn with_content_type<S: Into<String>>(self, content_type: S) -> Self

The same client sending request bodies as another representation.

pub fn with_header<N: Into<String>, V: Into<String>>( self, name: N, value: V, ) -> Self

The same client sending one more header with every request.

pub fn with_http_client(self, http: Client) -> Self

The same client built on a configured reqwest client.

pub fn base_url(&self) -> &str

The base URL every path is appended to.

pub async fn request( &self, method: &str, path: &str, body: Option<&LinoValue>, options: &RequestOptions, ) -> Result<LinoResponse, LinoClientError>

Perform a request and decode the response.

Errors

A LinoClientError::Status for any 4xx or 5xx, carrying the decoded problem details, and a LinoClientError::Transport when the request never reached the service.

pub async fn get( &self, path: &str, options: &RequestOptions, ) -> Result<LinoResponse, LinoClientError>

GET a resource.

pub async fn post( &self, path: &str, body: &LinoValue, options: &RequestOptions, ) -> Result<LinoResponse, LinoClientError>

POST to a collection.

pub async fn put( &self, path: &str, body: &LinoValue, options: &RequestOptions, ) -> Result<LinoResponse, LinoClientError>

PUT a representation.

pub async fn patch( &self, path: &str, body: &LinoValue, options: &RequestOptions, ) -> Result<LinoResponse, LinoClientError>

PATCH a representation.

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

DELETE a resource.

pub async fn head( &self, path: &str, options: &RequestOptions, ) -> Result<LinoResponse, LinoClientError>

HEAD a resource.

pub async fn options( &self, path: &str, options: &RequestOptions, ) -> Result<Vec<String>, LinoClientError>

OPTIONS a path, returning the advertised methods.

pub async fn list( &self, path: &str, options: &RequestOptions, ) -> Result<LinoValue, LinoClientError>

List a collection, returning the decoded envelope.

pub async fn describe(&self) -> Result<LinoValue, LinoClientError>

Fetch the service description of specification section 9.

Trait Implementations

impl Clone for LinoClient

fn clone(&self) -> LinoClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LinoClient

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

Formats the value using the given formatter.